GitLab v ChatGPT a Codexe je momentálne vo verzii beta.
Prehľad
Pomocou šablóny aplikácie GitLab Self-Managed vytvorte pre inštanciu GitLab Self-Managed alebo GitLab Dedicated koncept aplikácie určený pre konkrétny pracovný priestor. Zadajte názov hostiteľa GitLabu a prihlasovacie údaje aplikácie OAuth, skontrolujte koncept aplikácie a potom ho zverejnite pre oprávnených členov pracovného priestoru. Po zverejnení budú povolené akcie aplikácie dostupné v konverzáciách ChatGPT a reláciách Codexu.
Prehľad podporovaných funkcií GitLabu, dostupnosti, oprávnení, používania údajov a sieťových požiadaviek nájdete v článku Pripojenie GitLabu k ChatGPT a Codexu.
Čo nastavujete
Zo šablóny aplikácie GitLab Self-Managed vytvárate aplikáciu určenú pre konkrétny pracovný priestor. Aplikácia používa:
Aplikáciu GitLab OAuth zaregistrovanú na vašom hostiteľovi GitLab Self-Managed alebo GitLab Dedicated.
Hodnoty ID aplikácie a Tajný kľúč služby GitLab OAuth na autorizáciu používateľa.
Požadované rozsahy OAuth: api, write_repository a openid.
Názov hostiteľa GitLabu, napríklad gitlab.example.com, na odvodenie webových koncových bodov a koncových bodov API, autorizácie a tokenov.
Skôr než začnete
Potrebujete:
Prístup správcu alebo vlastníka pracovného priestoru ChatGPT.
Oprávnenie v GitLabe na vytvorenie aplikácie OAuth: prístup vlastníka skupiny pri aplikácii vlastnenej skupinou alebo prístup správcu inštancie pri aplikácii pre celú inštanciu.
Iba názov hostiteľa GitLabu bez https://, portu alebo cesty. Použite hostiteľa GitLab Self-Managed alebo GitLab Dedicated, nie gitlab.com.
Rozhodnutie, ktoré akcie GitLabu majú ChatGPT a Codex podporovať, napríklad vyhľadávanie v repozitároch, pracovné postupy žiadostí o zlúčenie a problémov, úpravy súborov alebo širšie pracovné postupy Codexu.
Nechajte ChatGPT a GitLab otvorené na samostatných kartách. Skopírujte presný Identifikátor URI presmerovania zobrazený v ChatGPT. Nevytvárajte ho ani neupravujte.
Hodnoty, ktoré si treba pripraviť
Názov hostiteľa GitLabu: napríklad gitlab.example.com.
Identifikátor URI presmerovania: skopírujte ho z postupu nastavenia šablóny v ChatGPT.
GitLab OAuth – ID aplikácie.
GitLab OAuth – Tajný kľúč.
Rozsahy OAuth: skopírujte ich z postupu nastavenia šablóny v ChatGPT.
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.
Vytvorenie aplikácie GitLab OAuth v GitLabe
Výber miesta vytvorenia aplikácie
Otvorte svojho hostiteľa GitLabu, napríklad https://gitlab.example.com.
Vyberte, či chcete vytvoriť aplikáciu pre celú inštanciu alebo aplikáciu vlastnenú skupinou. Táto voľba určuje, kto aplikáciu spravuje. Prístup k projektom sa naďalej riadi oprávneniami používateľa GitLabu udeľujúceho autorizáciu a udelenými rozsahmi OAuth.
Pri aplikácii pre celú inštanciu prejdite do časti Správca > Aplikácie. Pri aplikácii vlastnenej skupinou prejdite v skupine do časti Nastavenia > Aplikácie.
Pridanie údajov aplikácie
Vyberte Nová aplikácia alebo Pridať novú aplikáciu.
Zadajte výstižný názov aplikácie, napríklad GitLab Self-Managed alebo GitLab Dedicated.
Do poľa Identifikátor URI presmerovania vložte presný identifikátor URI skopírovaný z ChatGPT.
Pre túto serverovú aplikáciu OAuth ponechajte možnosť Dôverné zapnutú.
Konfigurácia prístupu a uloženie
Pri aplikácii pre celú inštanciu GitLab odporúča vybrať možnosť Dôveryhodná. Tým sa preskočí výzva na autorizáciu používateľa.
Vyberte rozsahy api, write_repository a openid.
Skontrolujte, kto môže aplikáciu spravovať, a overte, či majú používatelia GitLabu udeľujúci autorizáciu príslušné oprávnenia k skupinám a projektom.
Uložte aplikáciu.
Požiadavky na rozsahy OAuth
Šablóna požaduje nasledujúce rozsahy OAuth pre povolené akcie GitLabu v ChatGPT a Codexe:
api: vyžaduje sa na operácie API GitLabu sprístupnené aplikáciou vrátane akcií žiadostí o zlúčenie, problémov a CI/CD.
write_repository: vyžaduje sa na operácie zápisu do repozitára cez Git.
openid: vyžaduje sa na získanie identity a informácií o členstve prostredníctvom OpenID Connect.
Skopírovanie prihlasovacích údajov GitLab OAuth
V uloženej aplikácii GitLab skopírujte ID aplikácie a Tajný kľúč. S hodnotou Tajný kľúč zaobchádzajte ako s prihlasovacím údajom. Ak dôjde k jeho odhaleniu, obnovte ho v GitLabe a vytvorte novú aplikáciu pracovného priestoru.
Dokončenie nastavenia v ChatGPT
Vráťte sa na kartu nastavenia šablóny v ChatGPT.
Vložte ID aplikácie GitLabu do poľa ID klienta OAuth.
Vložte Tajný kľúč GitLabu do poľa Tajný kľúč klienta OAuth.
Overte, či názov hostiteľa GitLabu obsahuje iba názov hostiteľa, napríklad gitlab.example.com.
Vyberte Vytvoriť koncept.
Otvorte podrobnosti konceptu aplikácie a skontrolujte možnosti Prístup rolí a Konfigurovať akcie.
Zverejnenie a správa aplikácie pre ChatGPT a Codex
Vytvorením konceptu sa aplikácia automaticky nesprístupní členom. Po kontrole konceptu:
Pri koncepte aplikácie vyberte Zverejniť.
Prejdite do časti Nastavenia pracovného priestoru > Doplnky a overte, či je GitLab dostupný určeným rolám.
Skontrolujte Prístup rolí pre roly, ktoré majú aplikáciu používať.
V časti Konfigurovať akcie skontrolujte dostupné akcie čítania a zápisu.
V časti Konfigurovať schválenia vyberte, kedy musia používatelia schváliť akciu predtým, než ChatGPT alebo Codex použije aplikáciu.
Požiadajte testovacieho používateľa s prístupom, aby otvoril GitLab v Adresári doplnkov alebo v časti Nastavenia > Doplnky. Overte, či používateľ môže nainštalovať doplnok a pripojiť sa k aplikácii vytvorenej zo šablóny GitLab Self-Managed.
Tieto nastavenia schvaľovania aplikácie platia pre konverzácie ChatGPT a vlákna Codexu.
Nastavenie aktivity GitLabu na kontrolu kódu v Codexe
Ak plánujete používať Codex na kontrolu kódu, po zverejnení aplikácie nakonfigurujte aktivitu GitLabu v Codexe. Týmto nastavením aktivity sa nakonfigurujú požadované udalosti webhookov.
Otvorte nastavenia konektorov Codexu.
Nakonfigurujte servisný účet pracovného priestoru. Nechajte Codex vytvoriť účet alebo zadajte osobný prístupový token existujúceho servisného účtu.
Povoľte Aktivitu GitLabu pre projekt alebo jednu z jeho nadradených skupín.
Ak má Codex spúšťať programátorské úlohy alebo používať nastavenia konkrétneho projektu, vytvorte prostredie projektu.
Aplikácia GitLab používa používateľské OAuth na čítanie a povolené akcie v ChatGPT a Codexe. Pri zápisoch kontroly Codexu v GitLab Self-Managed alebo GitLab Dedicated určuje token servisného účtu spravovaného pracovným priestorom identitu a projekty, v ktorých môže Codex komentovať alebo reagovať.
Ďalšie informácie: Kontrola žiadostí o zlúčenie GitLabu pomocou Codexu.
Pripojenie a otestovanie aplikácie GitLab
Ako používateľ s prístupom otvorte GitLab v Adresári doplnkov alebo v časti Nastavenia > Doplnky. Vyberte Nainštalovať doplnok a potom Pripojiť.
Ak má váš pracovný priestor viac než jednu aplikáciu GitLab, vyberte aplikáciu pre tohto hostiteľa GitLab Self-Managed alebo GitLab Dedicated.
Po zobrazení výzvy autorizujte aplikáciu GitLab OAuth.
Najprv v ChatGPT alebo Codexe spustite jednoduchú akciu čítania, napríklad zobrazenie zoznamu dostupných projektov alebo načítanie známej žiadosti o zlúčenie.
Ak sú povolené akcie zápisu, pred širším nasadením ich otestujte v menej rizikovom projekte a v každom produkte, v ktorom ich plánujete používať.
Názov hostiteľa a správanie OAuth
Aplikácia používa názov hostiteľa na odvodenie koncových bodov GitLabu. Zadajte iba hostiteľa, napríklad gitlab.example.com. Nezadávajte https://, cestu k API ani repozitáru, port ani gitlab.com. Táto šablóna je určená pre GitLab Self-Managed alebo GitLab Dedicated. Pre GitLab.com (SaaS) použite aplikáciu GitLab.
Riešenie problémov s nastavením aplikácie GitLab Self-Managed
Nezhoda identifikátora URI presmerovania: Overte, či sa identifikátor URI presmerovania aplikácie GitLab OAuth presne zhoduje s identifikátorom URI presmerovania zobrazeným v ChatGPT.
ChatGPT nedokáže vytvoriť alebo uložiť koncept aplikácie: Overte, či sú uvedené názov hostiteľa, ID aplikácie, tajný kľúč a identifikátor URI presmerovania.
Overenie je úspešné, ale volania projektu zlyhávajú: Overte, či má používateľ GitLabu udeľujúci oprávnenie prístup k projektu a či má aplikácia OAuth rozsahy uvedené v šablóne.
API vracia chybu 403 alebo hlási nedostatočné oprávnenia: Overte, či má pripojený účet GitLab požadované oprávnenia k projektu alebo skupine a či aplikácia OAuth zahŕňa požadované rozsahy uvedené v šablóne.
Nie sú prístupné žiadne projekty: Overte, či má používateľ prístup k projektu, je pripojený k správnej inštancii GitLabu a v ChatGPT alebo Codexe vybral správnu aplikáciu GitLab.