GitLab v ChatGPT a Codexu je momentálně ve verzi beta.
Přehled
Pomocí šablony aplikace GitLab Self-Managed vytvořte pro instanci GitLab Self-Managed nebo GitLab Dedicated koncept aplikace určený pro konkrétní pracovní prostor. Zadejte název hostitele GitLabu a přihlašovací údaje aplikace OAuth, zkontrolujte koncept aplikace a poté ho publikujte pro oprávněné členy pracovního prostoru. Po publikování budou povolené akce aplikace dostupné v konverzacích ChatGPT a relacích Codexu.
Přehled podporovaného chování GitLabu, dostupnosti, oprávnění, využití dat a síťových požadavků najdete v článku Připojení GitLabu k ChatGPT a Codexu.
Co nastavujete
Ze šablony aplikace GitLab Self-Managed vytváříte aplikaci určenou pro konkrétní pracovní prostor. Aplikace používá:
Aplikaci GitLab OAuth registrovanou na vašem hostiteli GitLab Self-Managed nebo GitLab Dedicated.
Údaje ID aplikace a Tajný klíč z GitLab OAuth pro autorizaci uživatelů.
Požadované rozsahy OAuth: api, write_repository a openid.
Název hostitele GitLabu, například gitlab.example.com, ze kterého se odvodí koncové body webu, API, autorizace a tokenů.
Než začnete
Potřebujete:
Přístup správce nebo vlastníka pracovního prostoru ChatGPT.
Oprávnění v GitLabu k vytvoření aplikace OAuth: přístup vlastníka skupiny pro aplikaci vlastněnou skupinou nebo přístup správce instance pro aplikaci určenou pro celou instanci.
Pouze název hostitele GitLabu bez https://, portu nebo cesty. Použijte hostitele GitLab Self-Managed nebo GitLab Dedicated, nikoli gitlab.com.
Rozhodnutí, které akce GitLabu mají ChatGPT a Codex podporovat, například prohledávání úložišť, pracovní postupy žádostí o sloučení a problémů, úpravy souborů nebo širší pracovní postupy Codexu.
Nechte ChatGPT a GitLab otevřené na samostatných kartách. Zkopírujte přesný Identifikátor URI pro přesměrování zobrazený v ChatGPT. Nevytvářejte ho ani neupravujte.
Údaje, které si připravte
Název hostitele GitLabu: například gitlab.example.com.
Identifikátor URI pro přesměrování: zkopírujte ho z průvodce nastavením šablony v ChatGPT.
ID aplikace GitLab OAuth.
Tajný klíč GitLab OAuth.
Rozsahy OAuth: zkopírujte je z průvodce nastavením šablony 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.
Vytvoření aplikace GitLab OAuth v GitLabu
Volba umístění aplikace
Otevřete svého hostitele GitLabu, například https://gitlab.example.com.
Zvolte, zda chcete vytvořit aplikaci pro celou instanci, nebo aplikaci vlastněnou skupinou. Tato volba určuje, kdo aplikaci spravuje. Přístup k projektům se i nadále řídí oprávněními autorizujícího uživatele v GitLabu a udělenými rozsahy OAuth.
Pro aplikaci určenou pro celou instanci přejděte na Správce > Aplikace. Pro aplikaci vlastněnou skupinou přejděte ve skupině na Nastavení > Aplikace.
Přidání údajů o aplikaci
Vyberte Nová aplikace nebo Přidat novou aplikaci.
Zadejte srozumitelný název aplikace, například GitLab Self-Managed nebo GitLab Dedicated.
Do pole Identifikátor URI pro přesměrování vložte přesný identifikátor URI zkopírovaný z ChatGPT.
U této serverové aplikace OAuth ponechte zapnutou možnost Důvěrná.
Konfigurace přístupu a uložení
U aplikace pro celou instanci doporučuje GitLab vybrat možnost Důvěryhodná. Tím se přeskočí výzva k autorizaci uživatele.
Vyberte rozsahy api, write_repository a openid.
Zkontrolujte, kdo může aplikaci spravovat, a ověřte, že autorizující uživatelé GitLabu mají odpovídající oprávnění ke skupinám a projektům.
Uložte aplikaci.
Požadavky na rozsahy OAuth
Šablona pro povolené akce GitLabu v ChatGPT a Codexu vyžaduje následující rozsahy OAuth:
api: vyžaduje se pro operace GitLab API zpřístupněné aplikací, včetně akcí pro žádosti o sloučení, problémy a CI/CD.
write_repository: vyžaduje se pro operace zápisu do úložiště přes Git.
openid: vyžaduje se pro identitu OpenID Connect a informace o členství.
Zkopírování přihlašovacích údajů GitLab OAuth
V uložené aplikaci GitLab zkopírujte ID aplikace a Tajný klíč. S údajem Tajný klíč zacházejte jako s přihlašovacím údajem. Pokud dojde k jeho vyzrazení, obnovte ho v GitLabu a vytvořte novou aplikaci pracovního prostoru.
Dokončení nastavení v ChatGPT
Vraťte se na kartu nastavení šablony v ChatGPT.
Vložte ID aplikace z GitLabu do pole ID klienta OAuth.
Vložte Tajný klíč z GitLabu do pole Tajný klíč klienta OAuth.
Ověřte, že pole názvu hostitele GitLabu obsahuje pouze název hostitele, například gitlab.example.com.
Vyberte Vytvořit koncept.
Otevřete podrobnosti konceptu aplikace a zkontrolujte Přístup rolí a Konfiguraci akcí.
Publikování a správa aplikace pro ChatGPT a Codex
Vytvořením konceptu se aplikace členům automaticky nezpřístupní. Po kontrole konceptu:
U konceptu aplikace vyberte Publikovat.
Přejděte na Nastavení pracovního prostoru > Pluginy a ověřte, že je GitLab dostupný zamýšleným rolím.
U rolí, které mají aplikaci používat, zkontrolujte Přístup rolí.
V části Konfigurace akcí zkontrolujte dostupné akce čtení a zápisu.
V části Konfigurace schvalování zvolte, kdy musí uživatelé schválit akci předtím, než ChatGPT nebo Codex aplikaci použije.
Požádejte testovacího uživatele s přístupem, aby otevřel GitLab z Adresáře pluginů nebo z nabídky Nastavení > Pluginy. Ověřte, že uživatel může plugin nainstalovat a připojit se k aplikaci vytvořené ze šablony GitLab Self-Managed.
Tato nastavení schvalování aplikace platí pro konverzace ChatGPT a vlákna Codexu.
Nastavení aktivity GitLabu pro kontrolu kódu v Codexu
Pokud plánujete používat kontrolu kódu v Codexu, nakonfigurujte po publikování aplikace aktivitu GitLabu v Codexu. Tímto nastavením aktivity se nakonfigurují požadované události webhooků.
Otevřete nastavení konektorů Codexu.
Nakonfigurujte účet služby pracovního prostoru. Nechte Codex účet vytvořit, nebo zadejte osobní přístupový token stávajícího účtu služby.
Povolte Aktivitu GitLabu pro projekt nebo některou z jeho nadřazených skupin.
Pokud má Codex spouštět programovací úlohy nebo používat nastavení specifické pro projekt, vytvořte prostředí projektu.
Aplikace GitLab používá uživatelské OAuth pro čtení a povolené akce v ChatGPT a Codexu. Pro zápisy z kontroly Codexu v GitLab Self-Managed nebo GitLab Dedicated určuje token účtu služby spravovaný pracovním prostorem identitu a projekty, ve kterých může Codex komentovat nebo reagovat.
Další informace: Kontrola žádostí o sloučení v GitLabu pomocí Codexu.
Připojení a otestování aplikace GitLab
Jako uživatel s přístupem otevřete GitLab z Adresáře pluginů nebo z nabídky Nastavení > Pluginy. Vyberte Nainstalovat plugin a poté Připojit.
Pokud váš pracovní prostor obsahuje více aplikací GitLab, vyberte aplikaci pro tohoto hostitele GitLab Self-Managed nebo GitLab Dedicated.
Po zobrazení výzvy autorizujte aplikaci GitLab OAuth.
Nejprve v ChatGPT nebo Codexu spusťte menší akci čtení, například výpis dostupných projektů nebo načtení známé žádosti o sloučení.
Pokud jsou povolené akce zápisu, před širším nasazením je otestujte v projektu s nízkým rizikem a v každém produktu, kde je plánujete používat.
Chování názvu hostitele a OAuth
Aplikace odvozuje koncové body GitLabu z názvu hostitele. Zadejte pouze hostitele, například gitlab.example.com. Nezadávejte https://, cestu k API ani úložišti, port ani gitlab.com. Tato šablona je určena pro GitLab Self-Managed nebo GitLab Dedicated. Pro GitLab.com (SaaS) použijte aplikaci GitLab.
Řešení problémů s nastavením aplikace GitLab Self-Managed
Neshoda identifikátoru URI pro přesměrování: Ověřte, že identifikátor URI pro přesměrování v aplikaci GitLab OAuth přesně odpovídá identifikátoru zobrazenému v ChatGPT.
ChatGPT nemůže vytvořit nebo uložit koncept aplikace: Ověřte, že jsou zadané název hostitele, ID aplikace, tajný klíč a identifikátor URI pro přesměrování.
Ověření proběhne úspěšně, ale volání projektu selhávají: Ověřte, že autorizující uživatel GitLabu má k projektu přístup a aplikace OAuth má rozsahy požadované šablonou.
API vrací chybu 403 nebo hlásí nedostatečná oprávnění: Ověřte, že připojený účet GitLabu má požadovaná oprávnění k projektu či skupině a že aplikace OAuth obsahuje rozsahy požadované šablonou.
Nejsou dostupné žádné projekty: Ověřte, že uživatel má přístup k projektu, je připojený k zamýšlené instanci GitLabu a v ChatGPT nebo Codexu vybral správnou aplikaci GitLab.