GitLab in ChatGPT en Codex bevindt zich momenteel in de bètafase.
Overzicht
Gebruik de GitLab Self-Managed-appsjabloon om een werkruimtespecifieke concept-app te maken voor een GitLab Self-Managed- of GitLab Dedicated-instantie. Voer de GitLab-hostnaam en de referenties van de OAuth-toepassing in, controleer de concept-app en publiceer deze vervolgens voor werkruimteleden die ervoor in aanmerking komen. Na publicatie zijn de ingeschakelde acties van de app beschikbaar in ChatGPT-gesprekken en Codex-sessies.
Zie voor een overzicht van ondersteund GitLab-gedrag, beschikbaarheid, machtigingen, gegevensgebruik en netwerkvereisten: GitLab verbinden met ChatGPT en Codex.
Wat u gaat configureren
U maakt een werkruimtespecifieke app op basis van de GitLab Self-Managed-appsjabloon. De app gebruikt:
Een GitLab OAuth-toepassing die is geregistreerd op uw GitLab Self-Managed- of GitLab Dedicated-host.
De GitLab OAuth-toepassings-id en het geheim voor gebruikersautorisatie.
De vereiste OAuth-bereiken: api, write_repository en openid.
Uw GitLab-hostnaam, bijvoorbeeld gitlab.example.com, om de web-, API-, autorisatie- en tokeneindpunten af te leiden.
Voordat u begint
U hebt het volgende nodig:
Beheerders- of eigenaarstoegang tot de ChatGPT-werkruimte.
GitLab-machtiging om de OAuth-toepassing te maken: eigenaarstoegang voor een app van een groep of beheerderstoegang tot de instantie voor een app voor de hele instantie.
Alleen de GitLab-hostnaam, zonder https://, poort of pad. Gebruik een GitLab Self-Managed- of GitLab Dedicated-host, niet gitlab.com.
Een beslissing over welke GitLab-acties ChatGPT en Codex moeten ondersteunen, zoals zoeken in repositories, workflows voor samenvoegverzoeken en issues, bestandsbewerkingen of bredere Codex-workflows.
Houd ChatGPT en GitLab geopend in afzonderlijke tabbladen. Kopieer exact de omleidings-URI die in ChatGPT wordt weergegeven. Maak of wijzig deze niet.
Voor te bereiden waarden
GitLab-hostnaam: bijvoorbeeld gitlab.example.com.
Omleidings-URI: kopieer deze uit de configuratiestroom voor de ChatGPT-sjabloon.
GitLab OAuth-toepassings-id.
GitLab OAuth-geheim.
OAuth-bereiken: kopieer deze uit de configuratiestroom voor de ChatGPT-sjabloon.
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.
De GitLab OAuth-toepassing maken in GitLab
Kiezen waar u de toepassing maakt
Open uw GitLab-host, bijvoorbeeld https://gitlab.example.com.
Kies of u een toepassing voor de hele instantie of een toepassing van een groep wilt maken. Deze keuze bepaalt wie de toepassing beheert. Projecttoegang blijft afhankelijk van de GitLab-machtigingen van de gebruiker die toestemming verleent en de toegekende OAuth-bereiken.
Ga voor een toepassing voor de hele instantie naar Beheer > Toepassingen. Ga voor een toepassing van een groep naar Instellingen > Toepassingen van de groep.
De toepassingsgegevens toevoegen
Selecteer Nieuwe toepassing of Nieuwe toepassing toevoegen.
Voer een duidelijke appnaam in, zoals GitLab Self-Managed of GitLab Dedicated.
Plak bij Omleidings-URI exact de URI die u uit ChatGPT hebt gekopieerd.
Laat Vertrouwelijk ingeschakeld voor deze OAuth-toepassing aan de serverzijde.
Toegang configureren en opslaan
Voor een toepassing voor de hele instantie raadt GitLab aan Vertrouwd te selecteren. Hiermee wordt de prompt voor gebruikersautorisatie overgeslagen.
Selecteer de bereiken api, write_repository en openid.
Controleer wie de toepassing kan beheren en bevestig dat GitLab-gebruikers die toestemming verlenen de juiste groeps- en projectmachtigingen hebben.
Sla de toepassing op.
Vereisten voor OAuth-bereiken
De sjabloon vraagt de volgende OAuth-bereiken aan voor ingeschakelde GitLab-acties in ChatGPT en Codex:
api: vereist voor GitLab API-bewerkingen die via de app beschikbaar zijn, waaronder acties voor samenvoegverzoeken, issues en CI/CD.
write_repository: vereist om via Git naar een repository te schrijven.
openid: vereist voor OpenID Connect-identiteits- en lidmaatschapsgegevens.
De GitLab OAuth-referenties kopiëren
Kopieer in de opgeslagen GitLab-toepassing de toepassings-id en het geheim. Behandel het geheim als een referentie. Als het is gelekt, vernieuwt u het in GitLab en maakt u een nieuwe werkruimte-app.
De configuratie voltooien in ChatGPT
Ga terug naar het tabblad voor de ChatGPT-sjabloonconfiguratie.
Plak de GitLab-toepassings-id bij OAuth-client-id.
Plak het GitLab-geheim bij OAuth-clientgeheim.
Controleer of de GitLab-hostnaam alleen de hostnaam bevat, bijvoorbeeld gitlab.example.com.
Selecteer Concept maken.
Open de details van de concept-app en controleer Roltoegang en Acties configureren.
De app publiceren en beheren voor ChatGPT en Codex
Als u de concept-app maakt, wordt deze niet automatisch beschikbaar voor leden. Nadat u het concept hebt gecontroleerd:
Selecteer Publiceren voor de concept-app.
Ga naar Werkruimte-instellingen > Plug-ins en controleer of GitLab beschikbaar is voor de bedoelde rollen.
Controleer Roltoegang voor de rollen die de app moeten gebruiken.
Controleer bij Acties configureren de beschikbare lees- en schrijfacties.
Kies bij Goedkeuringen configureren wanneer gebruikers een actie moeten goedkeuren voordat ChatGPT of Codex de app gebruikt.
Vraag een testgebruiker met toegang om GitLab te openen via de Plug-in-catalogus of Instellingen > Plug-ins. Controleer of de gebruiker de plug-in kan installeren en verbinding kan maken met de app die op basis van de Self-Managed-sjabloon van GitLab is gemaakt.
Deze instellingen voor appgoedkeuring gelden voor ChatGPT-gesprekken en Codex-threads.
GitLab-activiteit instellen voor codebeoordeling met Codex
Configureer na publicatie van de app GitLab-activiteit in Codex als u codebeoordeling met Codex wilt gebruiken. Met deze activiteitsconfiguratie worden de vereiste webhookgebeurtenissen ingesteld.
Open de Codex-connectorinstellingen.
Configureer een serviceaccount voor de werkruimte. Laat Codex het account maken of geef een persoonlijk toegangstoken op voor een bestaand serviceaccount.
Schakel GitLab-activiteit in voor het project of een van de bovenliggende groepen.
Maak een projectomgeving als Codex codeertaken moet uitvoeren of een projectspecifieke configuratie moet gebruiken.
De GitLab-app gebruikt gebruikers-OAuth voor leesbewerkingen en ingeschakelde acties in ChatGPT en Codex. Voor schrijfacties bij Codex-beoordelingen op GitLab Self-Managed of GitLab Dedicated bepaalt het door de werkruimte beheerde serviceaccounttoken onder welke identiteit en in welke projecten Codex opmerkingen of reacties kan plaatsen.
Meer informatie: GitLab-samenvoegverzoeken beoordelen met Codex.
De GitLab-app verbinden en testen
Open als gebruiker met toegang GitLab via de Plug-in-catalogus of Instellingen > Plug-ins. Selecteer Plug-in installeren en daarna Verbinden.
Als uw werkruimte meer dan één GitLab-app heeft, kiest u de app voor deze GitLab Self-Managed- of GitLab Dedicated-host.
Verleen toestemming aan de GitLab OAuth-toepassing wanneer daarom wordt gevraagd.
Voer eerst een kleine leesactie uit in ChatGPT of Codex, zoals het weergeven van toegankelijke projecten of het ophalen van een bekend samenvoegverzoek.
Als schrijfacties zijn ingeschakeld, test u ze vóór een bredere uitrol in een project met een laag risico en in elk product waarin u ze wilt gebruiken.
Hostnaam en OAuth-gedrag
De app leidt GitLab-eindpunten af van de hostnaam. Voer alleen de host in, bijvoorbeeld gitlab.example.com. Neem geen https://, API- of repositorypad, poort of gitlab.com op. Deze sjabloon is bedoeld voor GitLab Self-Managed of GitLab Dedicated. Gebruik voor GitLab.com (SaaS) de GitLab-app.
Problemen met de configuratie van de GitLab Self-Managed-app oplossen
Omleidings-URI komt niet overeen: controleer of de omleidings-URI van de GitLab OAuth-toepassing exact overeenkomt met de omleidings-URI die in ChatGPT wordt weergegeven.
ChatGPT kan de concept-app niet maken of opslaan: controleer of de hostnaam, toepassings-id, het geheim en de omleidings-URI zijn ingevuld.
Verificatie slaagt, maar projectaanroepen mislukken: controleer of de GitLab-gebruiker die toestemming verleent toegang heeft tot het project en of de OAuth-toepassing de bereiken van de sjabloon heeft.
De API retourneert 403 of onvoldoende machtigingen: controleer of het gekoppelde GitLab-account de vereiste project- of groepsmachtigingen heeft en of de OAuth-toepassing de vereiste bereiken van de sjabloon bevat.
Er zijn geen projecten toegankelijk: controleer of de gebruiker toegang heeft tot het project, met de bedoelde GitLab-instantie is verbonden en de juiste GitLab-app in ChatGPT of Codex heeft geselecteerd.