A GitLab ChatGPT- és Codex-integrációja jelenleg béta-verzióban érhető el.
Áttekintés
A GitLab Self-Managed alkalmazássablonnal munkaterület-specifikus piszkozatalkalmazást hozhat létre egy GitLab Self-Managed- vagy GitLab Dedicated-példányhoz. Adja meg a GitLab állomásnevét és az OAuth-alkalmazás hitelesítő adatait, ellenőrizze a piszkozatalkalmazást, majd tegye közzé a jogosult munkaterületi tagok számára. A közzététel után az alkalmazás engedélyezett műveletei elérhetők a ChatGPT-beszélgetésekben és a Codex-munkamenetekben.
A támogatott GitLab-funkciók, az elérhetőség, a jogosultságok, az adatfelhasználás és a hálózati követelmények áttekintéséhez lásd: A GitLab csatlakoztatása a ChatGPT-hez és a Codexhez.
Mit állít be?
A GitLab Self-Managed alkalmazássablonból hoz létre munkaterület-specifikus alkalmazást. Az alkalmazás a következőket használja:
A GitLab Self-Managed- vagy GitLab Dedicated-gazdagépen regisztrált GitLab OAuth-alkalmazás.
A GitLab OAuth alkalmazásazonosítója és titkos kulcsa a felhasználói engedélyezéshez.
A szükséges OAuth-hatókörök: api, write_repository és openid.
A GitLab állomásneve, például gitlab.example.com, amelyből meghatározhatók a webes, API-, engedélyezési és tokenvégpontok.
Mielőtt elkezdi
A következőkre lesz szüksége:
Rendszergazdai vagy tulajdonosi hozzáférés a ChatGPT-munkaterülethez.
Jogosultság az OAuth-alkalmazás létrehozására a GitLabban: csoporttulajdonú alkalmazásnál tulajdonosi hozzáférés a csoporthoz, példányszintű alkalmazásnál pedig példányrendszergazdai hozzáférés.
Csak a GitLab állomásneve, https:// előtag, port és útvonal nélkül. GitLab Self-Managed- vagy GitLab Dedicated-gazdagépet használjon, ne a gitlab.com címet.
Döntés arról, hogy a ChatGPT és a Codex mely GitLab-műveleteket támogassa, például adattár-keresést, egyesítési kérelmekkel vagy problémákkal kapcsolatos munkafolyamatokat, fájlszerkesztést vagy szélesebb körű Codex-munkafolyamatokat.
Tartsa nyitva a ChatGPT-t és a GitLabot külön lapokon. Másolja ki pontosan a ChatGPT-ben megjelenő átirányítási URI-t; ne hozza létre és ne módosítsa.
Előkészítendő értékek
GitLab-állomásnév: például gitlab.example.com.
Átirányítási URI: másolja ki a ChatGPT sablonbeállítási folyamatából.
A GitLab OAuth alkalmazásazonosítója.
A GitLab OAuth titkos kulcsa.
OAuth-hatókörök: másolja ki őket a ChatGPT sablonbeállítási folyamatából.
Start the template setup in ChatGPT
In ChatGPT, switch to the workspace where the app should be available.
Go to Workspace settings > Plugins.
In Directory, find GitLab, open its GitLab Self-Managed app template, and select Enable.
Enter a clear app name and description.
Enter the GitLab hostname, such as gitlab.example.com.
Copy the Redirect URI shown in ChatGPT, and keep this tab open.
Example: https://chatgpt.com/connector/oauth/<redirect_id>. Do not remove the redirect ID, add a trailing slash, or replace the URI with a generic ChatGPT URL.
A GitLab OAuth-alkalmazás létrehozása a GitLabban
Az alkalmazás létrehozási helyének kiválasztása
Nyissa meg a GitLab-gazdagépet, például: https://gitlab.example.com.
Döntse el, hogy példányszintű vagy csoporttulajdonú alkalmazást szeretne létrehozni. Ez a választás határozza meg, hogy ki kezeli az alkalmazást; a projektekhez való hozzáférést továbbra is az engedélyező felhasználó GitLab-jogosultságai és a megadott OAuth-hatókörök szabályozzák.
Példányszintű alkalmazásnál lépjen a Rendszergazda > Alkalmazások menübe. Csoporttulajdonú alkalmazásnál lépjen a csoport Beállítások > Alkalmazások menüjébe.
Az alkalmazás adatainak megadása
Válassza az Új alkalmazás vagy az Új alkalmazás hozzáadása lehetőséget.
Adjon meg egyértelmű alkalmazásnevet, például GitLab Self-Managed vagy GitLab Dedicated.
Az Átirányítási URI mezőbe illessze be pontosan a ChatGPT-ből kimásolt URI-t.
Ennél a kiszolgálóoldali OAuth-alkalmazásnál hagyja bekapcsolva a Bizalmas beállítást.
A hozzáférés beállítása és mentés
Példányszintű alkalmazásnál a GitLab a Megbízható lehetőség kiválasztását javasolja. Így nem jelenik meg a felhasználói engedélyezési kérés.
Válassza ki az api, write_repository és openid hatóköröket.
Ellenőrizze, hogy ki kezelheti az alkalmazást, és győződjön meg arról, hogy az engedélyező GitLab-felhasználók rendelkeznek a megfelelő csoport- és projektjogosultságokkal.
Mentse az alkalmazást.
Az OAuth-hatókörökre vonatkozó követelmények
A sablon a következő OAuth-hatóköröket kéri a ChatGPT-ben és a Codexben engedélyezett GitLab-műveletekhez:
api: az alkalmazás által elérhetővé tett GitLab API-műveletekhez szükséges, beleértve az egyesítési kérelmekkel, problémákkal és CI/CD-vel kapcsolatos műveleteket.
write_repository: az adattár Git-alapú írási műveleteihez szükséges.
openid: az OpenID Connect-alapú identitás- és tagsági adatokhoz szükséges.
A GitLab OAuth hitelesítő adatainak másolása
A mentett GitLab-alkalmazásban másolja ki az alkalmazásazonosítót és a titkos kulcsot. A titkos kulcsot hitelesítő adatként kezelje. Ha illetéktelenek hozzáférhettek, újítsa meg a GitLabban, és hozzon létre új munkaterületi alkalmazást.
A beállítás befejezése a ChatGPT-ben
Térjen vissza a ChatGPT sablonbeállítási lapjára.
Illessze be a GitLab alkalmazásazonosítóját az OAuth-ügyfélazonosító mezőbe.
Illessze be a GitLab titkos kulcsát az OAuth-ügyfél titkos kulcsa mezőbe.
Győződjön meg arról, hogy a GitLab állomásneve csak az állomásnevet tartalmazza, például: gitlab.example.com.
Válassza a Piszkozat létrehozása lehetőséget.
Nyissa meg a piszkozatalkalmazás részleteit, és ellenőrizze a Szerepköralapú hozzáférés és a Műveletek konfigurálása beállítást.
Az alkalmazás közzététele és kezelése a ChatGPT-hez és a Codexhez
A piszkozatalkalmazás létrehozásával az még nem válik automatikusan elérhetővé a tagok számára. A piszkozat ellenőrzése után:
Válassza a piszkozatalkalmazásnál a Közzététel lehetőséget.
Lépjen a Munkaterület beállításai > Beépülő modulok menübe, és győződjön meg arról, hogy a GitLab elérhető a kívánt szerepkörök számára.
Ellenőrizze a Szerepköralapú hozzáférés beállításait azoknál a szerepköröknél, amelyek használhatják az alkalmazást.
A Műveletek konfigurálása részen tekintse át az elérhető olvasási és írási műveleteket.
A Jóváhagyások konfigurálása részen adja meg, hogy a felhasználóknak mikor kell jóváhagyniuk egy műveletet, mielőtt a ChatGPT vagy a Codex használná az alkalmazást.
Kérjen meg egy hozzáféréssel rendelkező tesztfelhasználót, hogy nyissa meg a GitLabot a Beépülőmodul-könyvtárból vagy a Beállítások > Beépülő modulok menüből. Győződjön meg arról, hogy a felhasználó telepíteni tudja a beépülő modult, és csatlakozni tud a GitLab Self-Managed sablonból létrehozott alkalmazáshoz.
Ezek az alkalmazás-jóváhagyási beállítások a ChatGPT-beszélgetésekre és a Codex-szálakra vonatkoznak.
GitLab-tevékenység beállítása a Codex kódellenőrzéséhez
Az alkalmazás közzététele után állítsa be a GitLab-tevékenységet a Codexben, ha használni szeretné a Codex kódellenőrzését. Ez a tevékenységbeállítás konfigurálja a szükséges webhookeseményeket.
Nyissa meg a Codex összekötőbeállításait.
Állítson be egy munkaterületi szolgáltatásfiókot. Hagyja, hogy a Codex létrehozza a fiókot, vagy adjon meg személyes hozzáférési tokent egy meglévő szolgáltatásfiókhoz.
Engedélyezze a GitLab-tevékenységet a projektnél vagy valamelyik szülőcsoportjánál.
Ha a Codexnek programozási feladatokat kell futtatnia, vagy projektspecifikus beállítást kell használnia, hozzon létre projektkörnyezetet.
A GitLab alkalmazás felhasználói OAuth-ot használ az olvasáshoz, valamint a ChatGPT-ben és a Codexben engedélyezett műveletekhez. A GitLab Self-Managed vagy GitLab Dedicated rendszerben végzett Codex-ellenőrzések írási műveleteinél a munkaterület által kezelt szolgáltatásfiók-token határozza meg, hogy a Codex milyen identitással és mely projektekben fűzhet megjegyzést vagy reagálhat.
További információ: GitLab-egyesítési kérelmek ellenőrzése a Codexszel.
A GitLab alkalmazás csatlakoztatása és tesztelése
Hozzáféréssel rendelkező felhasználóként nyissa meg a GitLabot a Beépülőmodul-könyvtárból vagy a Beállítások > Beépülő modulok menüből. Válassza a Beépülő modul telepítése, majd a Csatlakozás lehetőséget.
Ha a munkaterületen több GitLab alkalmazás is található, válassza ki az ehhez a GitLab Self-Managed- vagy GitLab Dedicated-gazdagéphez tartozó alkalmazást.
Amikor a rendszer kéri, engedélyezze a GitLab OAuth-alkalmazást.
Először futtasson egy kisebb olvasási műveletet a ChatGPT-ben vagy a Codexben, például listázza az elérhető projekteket, vagy kérjen le egy ismert egyesítési kérelmet.
Ha engedélyezve vannak az írási műveletek, a szélesebb körű bevezetés előtt tesztelje őket egy alacsony kockázatú projektben és minden olyan termékben, ahol használni tervezi őket.
Állomásnév és OAuth-működés
Az alkalmazás az állomásnév alapján határozza meg a GitLab-végpontokat. Csak az állomásnevet adja meg, például: gitlab.example.com. Ne adja meg a https:// előtagot, API- vagy adattárútvonalat, portot, illetve a gitlab.com címet. Ez a sablon GitLab Self-Managed- vagy GitLab Dedicated-példányhoz készült. A GitLab.com (SaaS) esetén használja a GitLab alkalmazást.
A GitLab Self-Managed alkalmazás beállítási hibáinak elhárítása
Nem egyezik az átirányítási URI: Győződjön meg arról, hogy a GitLab OAuth-alkalmazás átirányítási URI-ja pontosan megegyezik a ChatGPT-ben látható átirányítási URI-val.
A ChatGPT nem tudja létrehozni vagy menteni a piszkozatalkalmazást: Győződjön meg arról, hogy meg van adva az állomásnév, az alkalmazásazonosító, a titkos kulcs és az átirányítási URI.
A hitelesítés sikeres, de a projekthívások sikertelenek: Győződjön meg arról, hogy az engedélyező GitLab-felhasználó hozzáfér a projekthez, és az OAuth-alkalmazás rendelkezik a sablonban előírt hatókörökkel.
Az API 403-as hibát vagy elégtelen jogosultságot jelez: Győződjön meg arról, hogy a csatlakoztatott GitLab-fiók rendelkezik a szükséges projekt- vagy csoportjogosultságokkal, az OAuth-alkalmazás pedig a sablonban előírt hatókörökkel.
Egyetlen projekt sem érhető el: Győződjön meg arról, hogy a felhasználó hozzáfér a projekthez, a megfelelő GitLab-példányhoz csatlakozik, és a megfelelő GitLab alkalmazást választotta ki a ChatGPT-ben vagy a Codexben.