GitLab v ChatGPT a Codexe je momentálne vo verzii beta.
Prehľad
Pomocou šablóny aplikácie GitLab Self-Managed vytvorte koncept aplikácie pre konkrétny pracovný priestor a inštanciu GitLab Self-Managed alebo GitLab Dedicated. Zadajte názov hostiteľa GitLab a prihlasovacie údaje aplikácie OAuth, skontrolujte koncept aplikácie a potom ju publikujte pre členov pracovného priestoru s príslušným oprávnením. Po publikovaní budú povolené akcie aplikácie dostupné v konverzáciách ChatGPT a reláciách Codex.
Prehľad podporovaných funkcií GitLab, dostupnosti, oprávnení, používania údajov a sieťových požiadaviek nájdete v článku Pripojenie GitLab k ChatGPT a Codex.
Čo nastavujete
Zo šablóny aplikácie GitLab Self-Managed vytvárate aplikáciu pre konkrétny pracovný priestor. Aplikácia používa:
Aplikáciu OAuth pre GitLab zaregistrovanú na vašom hostiteľovi GitLab Self-Managed alebo GitLab Dedicated.
ID aplikácie a Tajný kľúč OAuth z GitLab na autorizáciu používateľov.
Požadované rozsahy oprávnení OAuth: api, write_repository a openid.
Názov vášho hostiteľa GitLab, napríklad gitlab.example.com, na odvodenie koncových bodov pre web, API, autorizáciu a tokeny.
Skôr než začnete
Potrebujete:
Prístup správcu alebo vlastníka pracovného priestoru ChatGPT.
Oprávnenie v GitLab na vytvorenie aplikácie OAuth: prístup vlastníka skupiny pre aplikáciu vlastnenú skupinou alebo prístup správcu inštancie pre aplikáciu určenú pre celú inštanciu.
Iba názov hostiteľa GitLab, bez https://, portu alebo cesty. Použite hostiteľa GitLab Self-Managed alebo GitLab Dedicated, nie gitlab.com.
Mať rozhodnuté, ktoré akcie GitLab majú ChatGPT a Codex podporovať, napríklad vyhľadávanie v repozitároch, pracovné postupy pre žiadosti o zlúčenie a úlohy, úpravy súborov alebo širšie pracovné postupy Codex.
ChatGPT a GitLab nechajte otvorené na samostatných kartách. Skopírujte presný URI presmerovania zobrazený v ChatGPT. Nevytvárajte ho ani ho neupravujte.
Ak chcete otvoriť stránku Aplikácie z Konzoly správcu, vyberte požadovaný pracovný priestor ChatGPT, otvorte Doplnky a vyberte Spravovať staršie aplikácie.
Hodnoty, ktoré si treba pripraviť
Názov hostiteľa GitLab: napríklad gitlab.example.com.
URI presmerovania: skopírujte ho počas nastavovania šablóny v ChatGPT.
ID aplikácie OAuth v GitLab.
Tajný kľúč OAuth v GitLab.
Rozsahy oprávnení OAuth: skopírujte ich počas nastavovania š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 > 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.
Vytvorte aplikáciu OAuth pre GitLab v službe GitLab
Vyberte, kde vytvoríte aplikáciu
Otvorte stránku svojho hostiteľa GitLab, 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 GitLab, ktorý udeľuje autorizáciu, a udelenými rozsahmi oprávnení OAuth.
Ak chcete vytvoriť aplikáciu pre celú inštanciu, prejdite do časti Správa > Aplikácie. Ak chcete vytvoriť aplikáciu vlastnenú skupinou, prejdite do časti Nastavenia > Aplikácie danej skupiny.
Pridajte údaje 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 URI presmerovania vložte presný URI skopírovaný z ChatGPT.
Pre túto serverovú aplikáciu OAuth ponechajte zapnutú možnosť Dôverná.
Nastavte prístup a uložte aplikáciu
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ľom.
Vyberte rozsahy oprávnení api, write_repository a openid.
Skontrolujte, kto môže aplikáciu spravovať, a overte, či používatelia GitLab, ktorí udeľujú autorizáciu, majú príslušné oprávnenia pre skupiny a projekty.
Uložte aplikáciu.
Požadované rozsahy oprávnení OAuth
Šablóna vyžaduje pre povolené akcie GitLab v ChatGPT a Codex tieto rozsahy oprávnení OAuth:
api: vyžaduje sa pre operácie API GitLab sprístupnené aplikáciou vrátane akcií pre žiadosti o zlúčenie, úlohy a CI/CD.
write_repository: vyžaduje sa pre operácie zápisu do repozitára cez Git.
openid: vyžaduje sa pre informácie o identite a členstve cez OpenID Connect.
Skopírujte prihlasovacie údaje OAuth z GitLab
V uloženej aplikácii GitLab skopírujte ID aplikácie a Tajný kľúč. S tajným kľúčom zaobchádzajte ako s prihlasovacím údajom. Ak dôjde k jeho úniku, obnovte ho v GitLab a vytvorte novú aplikáciu pre pracovný priestor.
Dokončite nastavenie v ChatGPT
Vráťte sa na kartu s nastavením šablóny v ChatGPT.
Vložte ID aplikácie z GitLab do poľa ID klienta OAuth.
Vložte Tajný kľúč z GitLab do poľa Tajný kľúč klienta OAuth.
Overte, že pole názvu hostiteľa GitLab obsahuje iba názov hostiteľa, napríklad gitlab.example.com.
Vyberte Vytvoriť koncept.
Otvorte podrobnosti konceptu aplikácie a skontrolujte nastavenia Prístup podľa rolí a Konfigurácia akcií.
Publikujte a spravujte aplikáciu pre ChatGPT a Codex
Vytvorením konceptu aplikácie sa aplikácia automaticky nesprístupní členom. Po kontrole konceptu:
Pri koncepte aplikácie vyberte Publikovať.
Prejdite do Konzoly správcu, vyberte požadovaný pracovný priestor ChatGPT a otvorte Doplnky. Potom overte, či je GitLab dostupný pre požadované roly.
Skontrolujte Prístup podľa rolí pre roly, ktoré majú aplikáciu používať.
V časti Konfigurácia akcií skontrolujte dostupné akcie čítania a zápisu.
V časti Konfigurácia schvaľovania 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 z Adresára doplnkov alebo cez 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 Codex.
Nastavte aktivitu GitLab na kontrolu kódu pomocou Codex
Ak plánujete používať kontrolu kódu pomocou Codex, po publikovaní aplikácie nastavte v Codex aktivitu GitLab. Týmto nastavením aktivity sa nakonfigurujú požadované udalosti webhookov.
Otvorte nastavenia konektorov Codex.
Nastavte servisný účet pracovného priestoru. Nechajte Codex vytvoriť účet alebo zadajte osobný prístupový token existujúceho servisného účtu.
Zapnite Aktivitu GitLab pre projekt alebo niektorú z jeho nadradených skupín.
Ak Codex potrebuje vykonávať programátorské úlohy alebo používať nastavenia špecifické pre projekt, vytvorte prostredie projektu.
Aplikácia GitLab používa na čítanie a povolené akcie v ChatGPT a Codex autorizáciu používateľa cez OAuth. Pri zápisoch vykonávaných počas kontroly kódu pomocou Codex v GitLab Self-Managed alebo GitLab Dedicated určuje token servisného účtu spravovaného pracovným priestorom identitu, pod ktorou Codex vystupuje, a projekty, v ktorých môže pridávať komentáre alebo reakcie.
Viac informácií: Kontrola žiadostí o zlúčenie v GitLab pomocou Codex.
Pripojte a otestujte aplikáciu GitLab
Ako používateľ s prístupom otvorte GitLab z Adresára doplnkov alebo cez Nastavenia > Doplnky. Vyberte Nainštalovať doplnok a potom Pripojiť.
Ak váš pracovný priestor obsahuje viac aplikácií GitLab, vyberte aplikáciu pre tohto hostiteľa GitLab Self-Managed alebo GitLab Dedicated.
Po zobrazení výzvy autorizujte aplikáciu OAuth pre GitLab.
Najprv v ChatGPT alebo Codex spustite jednoduchú akciu čítania, napríklad zobrazenie zoznamu prístupný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 projekte s nízkym rizikom a v každom produkte, v ktorom ich plánujete používať.
Názov hostiteľa a fungovanie OAuth
Aplikácia používa názov hostiteľa na odvodenie koncových bodov GitLab. Zadajte iba názov hostiteľa, napríklad gitlab.example.com. Neuvádzajte https://, cestu k API alebo 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 URI presmerovania: Overte, či sa URI presmerovania aplikácie OAuth v GitLab presne zhoduje s URI presmerovania zobrazeným v ChatGPT.
ChatGPT nemôže vytvoriť alebo uložiť koncept aplikácie: Overte, či sú vyplnené názov hostiteľa, ID aplikácie, tajný kľúč a URI presmerovania.
Overenie totožnosti prebehne úspešne, ale volania týkajúce sa projektu zlyhajú: Overte, či má používateľ GitLab, ktorý udeľuje autorizáciu, prístup k projektu a či má aplikácia OAuth rozsahy oprávnení požadované šablónou.
API vracia chybu 403 alebo hlásenie o nedostatočných oprávneniach: Overte, či má pripojený účet GitLab požadované oprávnenia pre projekt alebo skupinu a či aplikácia OAuth zahŕňa rozsahy oprávnení požadované šablónou.
Nie sú prístupné žiadne projekty: Overte, či má používateľ prístup k projektom, je pripojený k požadovanej inštancii GitLab a vybral správnu aplikáciu GitLab v ChatGPT alebo Codex.