GitLab v ChatGPT a Codexu je momentálně ve verzi beta.
Přehled
Pomocí šablony aplikace GitLab Self-Managed vytvořte koncept aplikace pro konkrétní pracovní prostor a instanci GitLab Self-Managed nebo GitLab Dedicated. Zadejte název hostitele GitLabu a přihlašovací údaje aplikace OAuth, zkontrolujte koncept aplikace a poté ji publikujte pro členy pracovního prostoru s příslušným oprávněním. Po publikování budou povolené akce aplikace dostupné v konverzacích v ChatGPT a relacích v Codexu.
Přehled podporovaných funkcí 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 pro konkrétní pracovní prostor. Aplikace používá:
Aplikaci OAuth zaregistrovanou na vašem serveru GitLab Self-Managed nebo GitLab Dedicated.
ID aplikace a tajný klíč OAuth z GitLabu pro autorizaci uživatelů.
Požadované rozsahy oprávnění OAuth: api, write_repository a openid.
Název hostitele vašeho GitLabu, například gitlab.example.com, pro odvození koncových bodů 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 pro celou instanci.
Pouze název hostitele GitLabu, bez https://, portu nebo cesty. Použijte server GitLab Self-Managed nebo GitLab Dedicated, nikoli gitlab.com.
Mít rozhodnuto, které akce GitLabu mají ChatGPT a Codex podporovat, například vyhledávání v úložišti, postupy pro žádosti o sloučení a úkoly, úpravy souborů nebo širší pracovní postupy v Codexu.
Nechte ChatGPT a GitLab otevřené na samostatných kartách. Zkopírujte přesný URI pro přesměrování zobrazený v ChatGPT. Nevytvářejte ho ani neupravujte.
Chcete-li otevřít stránku Aplikace z Konzole pro správu, vyberte požadovaný pracovní prostor ChatGPT, otevřete Pluginy a vyberte Spravovat starší aplikace.
Hodnoty, které je třeba připravit
Název hostitele GitLabu: například gitlab.example.com.
URI pro přesměrování: zkopírujte ho z průvodce nastavením šablony v ChatGPT.
ID aplikace OAuth z GitLabu.
Tajný klíč OAuth z GitLabu.
Rozsahy oprávnění 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 > 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.
Vytvořte v GitLabu aplikaci OAuth
Zvolte, kde aplikaci vytvořit
Otevřete svůj server GitLab, například https://gitlab.example.com.
Zvolte, zda vytvoříte aplikaci pro celou instanci, nebo aplikaci vlastněnou skupinou. Tato volba určuje, kdo aplikaci spravuje. Přístup k projektům se nadále řídí oprávněními uživatele GitLabu, který uděluje autorizaci, a udělenými rozsahy oprávnění OAuth.
Pro aplikaci pro celou instanci přejděte do části Správa > Aplikace. Pro aplikaci vlastněnou skupinou přejděte do části Nastavení > Aplikace dané skupiny.
Zadejte údaje aplikace
Vyberte Nová aplikace nebo Přidat novou aplikaci.
Zadejte výstižný název aplikace, například GitLab Self-Managed nebo GitLab Dedicated.
Do pole URI pro přesměrování vložte přesný URI zkopírovaný z ChatGPT.
U této serverové aplikace OAuth ponechte zapnutou možnost Důvěrná.
Nastavte přístup a uložte aplikaci
U aplikace pro celou instanci GitLab doporučuje vybrat možnost Důvěryhodná. Tím se přeskočí výzva k autorizaci uživatelem.
Vyberte rozsahy oprávnění api, write_repository a openid.
Zkontrolujte, kdo může aplikaci spravovat, a ověřte, že uživatelé GitLabu, kteří udělují autorizaci, mají příslušná oprávnění ke skupinám a projektům.
Uložte aplikaci.
Požadované rozsahy oprávnění OAuth
Šablona požaduje následující rozsahy oprávnění OAuth pro povolené akce GitLabu v ChatGPT a Codexu:
api: vyžaduje se pro operace API GitLabu zpřístupněné aplikací, včetně akcí týkajících se žádostí o sloučení, úkolů a CI/CD.
write_repository: vyžaduje se pro zápis do úložiště přes Git.
openid: vyžaduje se pro informace o identitě a členství prostřednictvím OpenID Connect.
Zkopírujte přihlašovací údaje OAuth z GitLabu
V uložené aplikaci v GitLabu zkopírujte ID aplikace a Tajný klíč. S tajným klíčem zacházejte jako s přihlašovacím údajem. Pokud dojde k jeho vyzrazení, vygenerujte v GitLabu nový a vytvořte novou aplikaci pro pracovní prostor.
Dokončete nastavení v ChatGPT
Vraťte se na kartu s nastavením š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 pro název hostitele GitLabu obsahuje pouze název hostitele, například gitlab.example.com.
Vyberte Vytvořit koncept.
Otevřete podrobnosti konceptu aplikace a zkontrolujte části Přístup podle rolí a Konfigurace akcí.
Publikujte a spravujte aplikaci pro ChatGPT a Codex
Vytvořením konceptu se aplikace automaticky nezpřístupní členům. Po kontrole konceptu:
U konceptu aplikace vyberte Publikovat.
Přejděte do Konzole pro správu, vyberte požadovaný pracovní prostor ChatGPT a otevřete Pluginy. Poté ověřte, že je GitLab dostupný pro požadované role.
Zkontrolujte Přístup podle rolí pro role, které mají aplikaci používat.
V části Konfigurace akcí zkontrolujte dostupné akce čtení a zápisu.
V části Konfigurace schvalování zvolte, kdy musí uživatelé schválit akci, 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 části Nastavení > Pluginy. Ověřte, že uživatel může nainstalovat plugin a připojit se k aplikaci vytvořené ze šablony GitLab Self-Managed.
Tato nastavení schvalování aplikace platí pro konverzace v ChatGPT a vlákna v Codexu.
Nastavte aktivitu GitLabu pro kontrolu kódu v Codexu
Pokud plánujete používat kontrolu kódu v Codexu, po publikování aplikace nastavte v Codexu aktivitu GitLabu. Toto nastavení aktivity nakonfiguruje požadované události webhooků.
Otevřete nastavení konektorů Codexu.
Nastavte servisní účet pracovního prostoru. Nechte Codex účet vytvořit, nebo zadejte osobní přístupový token existujícího servisního účtu.
Zapněte Aktivitu GitLabu pro projekt nebo některou z jeho nadřazených skupin.
Pokud Codex potřebuje provádět programovací úkoly nebo používat nastavení specifické pro projekt, vytvořte prostředí projektu.
Aplikace GitLab používá pro čtení a povolené akce v ChatGPT a Codexu autorizaci uživatele přes OAuth. Při zápisu výsledků kontroly kódu Codexem v GitLab Self-Managed nebo GitLab Dedicated určuje token servisního účtu spravovaného pracovním prostorem, pod jakou identitou a ve kterých projektech může Codex přidávat komentáře nebo reakce.
Další informace: Kontrola žádostí o sloučení v GitLabu pomocí Codexu.
Připojte a otestujte aplikaci GitLab
Jako uživatel s přístupem otevřete GitLab z Adresáře pluginů nebo z části Nastavení > Pluginy. Vyberte Nainstalovat plugin a poté Připojit.
Pokud má váš pracovní prostor více aplikací GitLab, zvolte aplikaci pro tento server GitLab Self-Managed nebo GitLab Dedicated.
Po zobrazení výzvy autorizujte aplikaci OAuth v GitLabu.
Nejprve v ChatGPT nebo Codexu spusťte jednoduchou akci čtení, například výpis přístupných projektů nebo načtení známé žádosti o sloučení.
Pokud jsou povoleny akce zápisu, před širším nasazením je otestujte na projektu s nízkým rizikem a v každém produktu, ve kterém je plánujete používat.
Název hostitele a fungování OAuth
Aplikace odvozuje koncové body GitLabu z názvu hostitele. Zadejte pouze název hostitele, například gitlab.example.com. Neuvádějte https://, cestu k API nebo ú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 URI pro přesměrování: Ověřte, že se URI pro přesměrování aplikace OAuth v GitLabu přesně shoduje s URI pro přesměrování zobrazeným v ChatGPT.
ChatGPT nemůže vytvořit nebo uložit koncept aplikace: Ověřte, že jsou vyplněny název hostitele, ID aplikace, tajný klíč a URI pro přesměrování.
Ověření identity proběhne úspěšně, ale volání týkající se projektu selhávají: Ověřte, že uživatel GitLabu, který uděluje autorizaci, má k projektu přístup a že aplikace OAuth má rozsahy oprávnění požadované šablonou.
API vrací chybu 403 nebo hlášení o nedostatečných oprávněních: Ověřte, že připojený účet GitLabu má požadovaná oprávnění k projektu nebo skupině a že aplikace OAuth zahrnuje rozsahy oprávnění požadované šablonou.
Nejsou přístupné žádné projekty: Ověřte, že uživatel má přístup k projektům, je připojen ke správné instanci GitLabu a v ChatGPT nebo Codexu vybral správnou aplikaci GitLab.