A GitLab ChatGPT- és Codex-integrációja jelenleg béta-verzióban érhető el.
Áttekintés
A GitLab Self-Managed alkalmazássablonnal létrehozhatsz egy munkaterülethez tartozó alkalmazáspiszkozatot egy GitLab Self-Managed- vagy GitLab Dedicated-példányhoz. Add meg a GitLab állomásnevét és az OAuth-alkalmazás hitelesítő adatait, ellenőrizd az alkalmazáspiszkozatot, majd tedd közzé a munkaterület jogosult tagjai számára. A közzététel után az alkalmazás engedélyezett műveletei elérhetővé válnak a ChatGPT-beszélgetésekben és a Codex-munkamenetekben.
A GitLab támogatott funkcióiról, elérhetőségéről, jogosultságairól, adathasználatáról és hálózati követelményeiről itt találsz áttekintést: A GitLab csatlakoztatása a ChatGPT-hez és a Codexhez.
Mit fogsz beállítani?
A GitLab Self-Managed alkalmazássablonból egy adott munkaterülethez tartozó alkalmazást hozol létre. Az alkalmazás a következőket használja:
A GitLab Self-Managed- vagy GitLab Dedicated-kiszolgálódon regisztrált GitLab OAuth-alkalmazást.
A GitLab OAuth Alkalmazásazonosító és Titkos kulcs értékét a felhasználói engedélyezéshez.
A szükséges OAuth-hatóköröket: api, write_repository és openid.
A GitLab állomásnevét, például gitlab.example.com, a webes, API-, engedélyezési és tokenvégpontok meghatározásához.
Mielőtt elkezded
A következőkre lesz szükséged:
Adminisztrátori vagy tulajdonosi hozzáférés a ChatGPT-munkaterülethez.
GitLab-jogosultság az OAuth-alkalmazás létrehozásához: csoporttulajdonosi hozzáférés egy csoport tulajdonában lévő alkalmazáshoz, vagy példányadminisztrátori hozzáférés a teljes példányra kiterjedő alkalmazáshoz.
Csak a GitLab állomásneve, https:// előtag, port és útvonal nélkül. GitLab Self-Managed- vagy GitLab Dedicated-kiszolgálót használj, 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árakban való keresést, egyesítési kérelmek és hibajegyek munkafolyamatait, fájlszerkesztést vagy összetettebb Codex-munkafolyamatokat.
Tartsd nyitva a ChatGPT-t és a GitLabot külön lapokon. Másold ki pontosan a ChatGPT-ben megjelenő Átirányítási URI értékét; ne hozz létre újat, és ne módosítsd.
Az Alkalmazások oldal megnyitásához az Adminisztrációs konzolon válaszd ki a kívánt ChatGPT-munkaterületet, nyisd meg a Beépülő modulok részt, majd válaszd a Régi alkalmazások kezelése lehetőséget.
Előkészítendő adatok
GitLab-állomásnév: például gitlab.example.com.
Átirányítási URI: másold ki a ChatGPT sablonbeállítási folyamatából.
GitLab OAuth Alkalmazásazonosító.
GitLab OAuth Titkos kulcs.
OAuth-hatókörök: másold 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 > Apps.
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
Nyisd meg a GitLab-kiszolgálódat, például: https://gitlab.example.com.
Válaszd ki, hogy a teljes példányra kiterjedő vagy egy csoport tulajdonában lévő alkalmazást szeretnél-e létrehozni. Ez a választás határozza meg, ki kezeli az alkalmazást; a projektekhez való hozzáférést továbbra is az engedélyezést végző felhasználó GitLab-jogosultságai és a megadott OAuth-hatókörök szabályozzák.
A teljes példányra kiterjedő alkalmazás esetén lépj az Adminisztráció > Alkalmazások menüpontba. Csoport tulajdonában lévő alkalmazás esetén lépj a csoport Beállítások > Alkalmazások menüpontjába.
Az alkalmazás adatainak megadása
Válaszd az Új alkalmazás vagy az Új alkalmazás hozzáadása lehetőséget.
Adj az alkalmazásnak egyértelmű nevet, például GitLab Self-Managed vagy GitLab Dedicated.
Az Átirányítási URI mezőbe illeszd be a ChatGPT-ből másolt URI-t, pontosan, változtatás nélkül.
Ennél a szerveroldali OAuth-alkalmazásnál hagyd bekapcsolva a Bizalmas beállítást.
A hozzáférés beállítása és mentése
A teljes példányra kiterjedő alkalmazás esetén a GitLab a Megbízható beállítás kiválasztását javasolja. Így nem jelenik meg a felhasználói engedélykérés.
Válaszd ki az api, write_repository és openid hatóköröket.
Tekintsd át, ki kezelheti az alkalmazást, és ellenőrizd, hogy az engedélyezést végző GitLab-felhasználók rendelkeznek-e a megfelelő csoport- és projektjogosultságokkal.
Mentsd az alkalmazást.
Szükséges OAuth-hatókörök
A sablon az alábbi OAuth-hatóköröket kéri a ChatGPT-ben és a Codexben engedélyezett GitLab-műveletekhez:
api: az alkalmazáson keresztül elérhető GitLab API-műveletekhez szükséges, beleértve az egyesítési kérelmekkel, hibajegyekkel és CI/CD-vel kapcsolatos műveleteket.
write_repository: az adattárakon Git használatával végzett írási műveletekhez szükséges.
openid: az OpenID Connect identitás- és tagsági adataihoz szükséges.
A GitLab OAuth-hitelesítő adatainak másolása
A mentett GitLab-alkalmazásból másold ki az Alkalmazásazonosító és a Titkos kulcs értékét. A Titkos kulcs értékét kezeld hitelesítő adatként. Ha illetéktelenekhez kerül, újítsd meg a GitLabban, és hozz létre egy új munkaterületi alkalmazást.
A beállítás befejezése a ChatGPT-ben
Térj vissza a ChatGPT sablonbeállítási lapjára.
Illeszd be a GitLab Alkalmazásazonosító értékét az OAuth-ügyfélazonosító mezőbe.
Illeszd be a GitLab Titkos kulcs értékét az OAuth-ügyfél titkos kulcsa mezőbe.
Ellenőrizd, hogy a GitLab állomásnevének mezője csak az állomásnevet tartalmazza, például: gitlab.example.com.
Válaszd a Piszkozat létrehozása lehetőséget.
Nyisd meg az alkalmazáspiszkozat részleteit, és tekintsd át a Szerepköralapú hozzáférés és a Műveletek beállítása részt.
Az alkalmazás közzététele és kezelése a ChatGPT-hez és a Codexhez
Az alkalmazáspiszkozat létrehozásával az alkalmazás még nem válik automatikusan elérhetővé a tagok számára. A piszkozat áttekintése után:
Válaszd az alkalmazáspiszkozat Közzététel lehetőségét.
Lépj az Adminisztrációs konzolra, válaszd ki a kívánt ChatGPT-munkaterületet, nyisd meg a Beépülő modulok részt, majd ellenőrizd, hogy a GitLab elérhető-e a kívánt szerepkörök számára.
Ellenőrizd a Szerepköralapú hozzáférés beállításait azoknál a szerepköröknél, amelyeknek használniuk kell az alkalmazást.
A Műveletek beállítása részben tekintsd át az elérhető olvasási és írási műveleteket.
A Jóváhagyások beállítása részben válaszd ki, mikor kell a felhasználóknak jóváhagyniuk egy műveletet, mielőtt a ChatGPT vagy a Codex használná az alkalmazást.
Kérj meg egy hozzáféréssel rendelkező tesztfelhasználót, hogy nyissa meg a GitLab alkalmazást a Beépülő modulok katalógusából vagy a Beállítások > Beépülő modulok menüpontból. Ellenőrizd, hogy a felhasználó tudja-e telepíteni a beépülő modult, és tud-e csatlakozni a GitLab Self-Managed sablonból létrehozott alkalmazáshoz.
Az alkalmazás ezen jóváhagyási beállításai a ChatGPT-beszélgetésekre és a Codex-szálakra vonatkoznak.
A GitLab-aktivitás beállítása a Codex kódellenőrzéséhez
Ha használni szeretnéd a Codex kódellenőrzését, az alkalmazás közzététele után állítsd be a GitLab-aktivitást a Codexben. Az aktivitás beállításával a szükséges webhookeseményeket konfigurálod.
Nyisd meg a Codex csatlakozóbeállításait.
Állíts be egy szolgáltatásfiókot a munkaterülethez. Hagyd, hogy a Codex hozza létre a fiókot, vagy adj meg egy személyes hozzáférési tokent egy meglévő szolgáltatásfiókhoz.
Engedélyezd a GitLab-aktivitást a projekthez vagy valamelyik szülőcsoportjához.
Ha a Codexnek kódolási feladatokat kell futtatnia vagy projektspecifikus beállításokat kell használnia, hozz létre egy projektkörnyezetet.
A GitLab alkalmazás felhasználói OAuth-engedélyezést használ az olvasáshoz és az engedélyezett műveletekhez a ChatGPT-ben és a Codexben. A GitLab Self-Managed vagy GitLab Dedicated rendszerben végzett Codex-kódellenőrzés írási műveleteinél a munkaterület által kezelt szolgáltatásfiók tokenje határozza meg, milyen identitással és mely projektekben írhat megjegyzéseket vagy adhat reakciókat a Codex.
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 nyisd meg a GitLab alkalmazást a Beépülő modulok katalógusából vagy a Beállítások > Beépülő modulok menüpontból. Válaszd a Beépülő modul telepítése, majd a Csatlakozás lehetőséget.
Ha a munkaterületeden több GitLab alkalmazás is van, válaszd az ehhez a GitLab Self-Managed- vagy GitLab Dedicated-kiszolgálóhoz tartozó alkalmazást.
Amikor a rendszer kéri, engedélyezd a GitLab OAuth-alkalmazás hozzáférését.
Először futtass egy egyszerű olvasási műveletet a ChatGPT-ben vagy a Codexben, például listázd az elérhető projekteket, vagy kérj le egy ismert egyesítési kérelmet.
Ha az írási műveletek engedélyezve vannak, a szélesebb körű bevezetés előtt teszteld őket egy alacsony kockázatú projektben, minden olyan termékben, amelyben használni szeretnéd őket.
Állomásnév és az OAuth működése
Az alkalmazás az állomásnév alapján határozza meg a GitLab-végpontokat. Csak az állomásnevet add meg, például: gitlab.example.com. Ne adj meg https:// előtagot, API- vagy adattárútvonalat, portot, illetve gitlab.com címet. Ez a sablon a GitLab Self-Managed és a GitLab Dedicated rendszerhez készült. A GitLab.com (SaaS) szolgáltatáshoz használd a GitLab alkalmazást.
A GitLab Self-Managed alkalmazás beállítási hibáinak elhárítása
Eltérő átirányítási URI: Ellenőrizd, hogy a GitLab OAuth-alkalmazásának átirányítási URI-ja pontosan megegyezik-e a ChatGPT-ben megjelenő átirányítási URI-val.
A ChatGPT nem tudja létrehozni vagy menteni az alkalmazáspiszkozatot: Ellenőrizd, hogy megadtad-e az állomásnevet, az alkalmazásazonosítót, a titkos kulcsot és az átirányítási URI-t.
A hitelesítés sikeres, de a projekthez intézett hívások sikertelenek: Ellenőrizd, hogy az engedélyezést végző GitLab-felhasználó hozzáfér-e a projekthez, és az OAuth-alkalmazás rendelkezik-e a sablon hatóköreivel.
Az API 403-as hibát vagy elégtelen jogosultságot jelez: Ellenőrizd, hogy a csatlakoztatott GitLab-fiók rendelkezik-e a szükséges projekt- vagy csoportjogosultságokkal, és az OAuth-alkalmazás tartalmazza-e a sablon szükséges hatóköreit.
Egyetlen projekt sem érhető el: Ellenőrizd, hogy a felhasználónak van-e hozzáférése a projekthez, a kívánt GitLab-példányhoz csatlakozik-e, és a megfelelő GitLab alkalmazást választotta-e ki a ChatGPT-ben vagy a Codexben.