GitLab i ChatGPT og Codex er for øyeblikket i betaversjon.
Oversikt
Bruk appmalen for GitLab Self-Managed til å opprette et apputkast som er spesifikt for arbeidsområdet, for en GitLab Self-Managed- eller GitLab Dedicated-instans. Oppgi GitLab-vertsnavnet og påloggingsinformasjonen for OAuth-applikasjonen, gå gjennom apputkastet, og publiser det deretter for medlemmene i arbeidsområdet som skal ha tilgang. Etter publisering er appens aktiverte handlinger tilgjengelige i ChatGPT-samtaler og Codex-økter.
Du finner en oversikt over støttet GitLab-funksjonalitet, tilgjengelighet, tillatelser, databruk og nettverkskrav her: Koble GitLab til ChatGPT og Codex.
Dette setter du opp
Du oppretter en app som er spesifikk for arbeidsområdet, fra appmalen for GitLab Self-Managed. Appen bruker:
En GitLab OAuth-applikasjon som er registrert på GitLab Self-Managed- eller GitLab Dedicated-verten din.
Applikasjons-ID og Hemmelighet for GitLab OAuth til brukerautorisasjon.
De nødvendige OAuth-tilgangsområdene: api, write_repository og openid.
GitLab-vertsnavnet ditt, for eksempel gitlab.example.com, til å utlede endepunktene for nett, API, autorisasjon og token.
Før du begynner
Du trenger:
Administrator- eller eiertilgang til ChatGPT-arbeidsområdet.
Tillatelse i GitLab til å opprette OAuth-applikasjonen: eiertilgang til gruppen for en gruppeeid app, eller administratortilgang til instansen for en app som gjelder hele instansen.
Bare GitLab-vertsnavnet, uten https://, port eller sti. Bruk en GitLab Self-Managed- eller GitLab Dedicated-vert, ikke gitlab.com.
En avklaring av hvilke GitLab-handlinger ChatGPT og Codex skal støtte, for eksempel søk i lagre, arbeidsflyter for fletteforespørsler og saker, filredigering eller mer omfattende Codex-arbeidsflyter.
Ha ChatGPT og GitLab åpne i separate faner. Kopier Omdirigerings-URI nøyaktig slik den vises i ChatGPT. Ikke opprett eller endre den.
For å åpne Apper-siden fra Administrasjonskonsollen velger du ønsket ChatGPT-arbeidsområde, åpner Pluginer og velger Administrer eldre apper.
Verdier du må ha klare
GitLab-vertsnavn: for eksempel gitlab.example.com.
Omdirigerings-URI: kopier denne fra veiviseren for maloppsett i ChatGPT.
Applikasjons-ID for GitLab OAuth.
Hemmelighet for GitLab OAuth.
OAuth-tilgangsområder: kopier disse fra veiviseren for maloppsett i 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.
Opprett GitLab OAuth-applikasjonen i GitLab
Velg hvor applikasjonen skal opprettes
Åpne GitLab-verten din, for eksempel https://gitlab.example.com.
Velg om du vil opprette en applikasjon for hele instansen eller en gruppeeid applikasjon. Dette valget avgjør hvem som administrerer applikasjonen. Prosjekttilgang styres fortsatt av GitLab-tillatelsene til brukeren som autoriserer, og OAuth-tilgangsområdene som er gitt.
For en applikasjon som gjelder hele instansen, går du til Administrasjon > Applikasjoner. For en gruppeeid applikasjon går du til gruppens Innstillinger > Applikasjoner.
Legg til applikasjonsdetaljene
Velg Ny applikasjon eller Legg til ny applikasjon.
Skriv inn et tydelig appnavn, for eksempel GitLab Self-Managed eller GitLab Dedicated.
I Omdirigerings-URI limer du inn URI-en du kopierte fra ChatGPT, uten endringer.
La Konfidensiell være aktivert for denne OAuth-applikasjonen på serversiden.
Konfigurer tilgang og lagre
For en applikasjon som gjelder hele instansen, anbefaler GitLab å velge Klarert. Da hoppes forespørselen om brukerautorisasjon over.
Velg tilgangsområdene api, write_repository og openid.
Gå gjennom hvem som kan administrere applikasjonen, og kontroller at GitLab-brukerne som autoriserer den, har de riktige gruppe- og prosjekttillatelsene.
Lagre applikasjonen.
Krav til OAuth-tilgangsområder
Malen ber om følgende OAuth-tilgangsområder for aktiverte GitLab-handlinger i ChatGPT og Codex:
api: kreves for GitLab-API-operasjoner som appen tilbyr, inkludert handlinger for fletteforespørsler, saker og CI/CD.
write_repository: kreves for skriveoperasjoner til lagre via Git.
openid: kreves for identitets- og medlemskapsinformasjon via OpenID Connect.
Kopier påloggingsinformasjonen for GitLab OAuth
Kopier Applikasjons-ID og Hemmelighet fra den lagrede GitLab-applikasjonen. Behandle Hemmelighet som påloggingsinformasjon. Hvis den blir eksponert, må du fornye den i GitLab og opprette en ny app for arbeidsområdet.
Fullfør oppsettet i ChatGPT
Gå tilbake til fanen for maloppsett i ChatGPT.
Lim inn Applikasjons-ID fra GitLab i OAuth-klient-ID.
Lim inn Hemmelighet fra GitLab i OAuth-klienthemmelighet.
Kontroller at GitLab-vertsnavnet bare inneholder vertsnavnet, for eksempel gitlab.example.com.
Velg Opprett utkast.
Åpne detaljene for apputkastet, og gå gjennom Rolletilgang og Konfigurer handlinger.
Publiser og administrer appen for ChatGPT og Codex
Appen blir ikke automatisk tilgjengelig for medlemmer når du oppretter utkastet. Etter at du har gått gjennom utkastet:
Velg Publiser for apputkastet.
Gå til Administrasjonskonsollen, velg ønsket ChatGPT-arbeidsområde, og åpne Pluginer. Kontroller deretter at GitLab er tilgjengelig for de tiltenkte rollene.
Gå gjennom Rolletilgang for rollene som skal bruke appen.
Gå gjennom de tilgjengelige lese- og skrivehandlingene under Konfigurer handlinger.
Under Konfigurer godkjenninger velger du når brukere må godkjenne en handling før ChatGPT eller Codex bruker appen.
Be en testbruker med tilgang om å åpne GitLab fra Pluginkatalogen eller Innstillinger > Pluginer. Kontroller at brukeren kan installere pluginen og koble til appen som er opprettet fra GitLab Self-Managed-malen.
Disse innstillingene for appgodkjenning gjelder for ChatGPT-samtaler og Codex-tråder.
Sett opp GitLab-aktivitet for kodegjennomgang med Codex
Når appen er publisert, konfigurerer du GitLab-aktivitet i Codex hvis du planlegger å bruke Codex til kodegjennomgang. Dette aktivitetsoppsettet konfigurerer de nødvendige webhook-hendelsene.
Konfigurer en tjenestekonto for arbeidsområdet. La Codex opprette kontoen, eller oppgi et personlig tilgangstoken for en eksisterende tjenestekonto.
Aktiver GitLab-aktivitet for prosjektet eller en av de overordnede gruppene.
Hvis Codex må kjøre kodeoppgaver eller bruke et prosjektspesifikt oppsett, oppretter du et prosjektmiljø.
GitLab-appen bruker brukerens OAuth-autorisasjon for lesing og aktiverte handlinger i ChatGPT og Codex. For skrivehandlinger ved Codex-kodegjennomgang på GitLab Self-Managed eller GitLab Dedicated bestemmer tjenestekontotokenet som administreres av arbeidsområdet, hvilken identitet Codex bruker, og hvilke prosjekter Codex kan kommentere eller reagere i.
Koble til og test GitLab-appen
Som bruker med tilgang åpner du GitLab fra Pluginkatalogen eller Innstillinger > Pluginer. Velg Installer plugin, og velg deretter Koble til.
Hvis arbeidsområdet ditt har flere GitLab-apper, velger du appen for denne GitLab Self-Managed- eller GitLab Dedicated-verten.
Autoriser GitLab OAuth-applikasjonen når du blir bedt om det.
Kjør først en enkel lesehandling i ChatGPT eller Codex, for eksempel å liste opp tilgjengelige prosjekter eller hente en kjent fletteforespørsel.
Hvis skrivehandlinger er aktivert, bør du teste dem i et prosjekt med lav risiko og i hvert produkt der du planlegger å bruke dem, før en bredere utrulling.
Vertsnavn og OAuth-funksjonalitet
Appen bruker vertsnavnet til å utlede GitLab-endepunkter. Skriv bare inn vertsnavnet, for eksempel gitlab.example.com. Ikke ta med https://, en API- eller lagersti, en port eller gitlab.com. Denne malen er for GitLab Self-Managed eller GitLab Dedicated. For GitLab.com (SaaS) bruker du GitLab-appen.
Feilsøking av appoppsettet for GitLab Self-Managed
Omdirigerings-URI samsvarer ikke: Kontroller at omdirigerings-URI-en for GitLab OAuth-applikasjonen er helt lik omdirigerings-URI-en som vises i ChatGPT.
ChatGPT kan ikke opprette eller lagre apputkastet: Kontroller at vertsnavn, applikasjons-ID, hemmelighet og omdirigerings-URI er oppgitt.
Autentiseringen lykkes, men prosjektkall mislykkes: Kontroller at GitLab-brukeren som autoriserer, har tilgang til prosjektet, og at OAuth-applikasjonen har tilgangsområdene fra malen.
API-et returnerer 403 eller utilstrekkelige tillatelser: Kontroller at den tilkoblede GitLab-kontoen har de nødvendige prosjekt- eller gruppetillatelsene, og at OAuth-applikasjonen inkluderer tilgangsområdene som malen krever.
Ingen prosjekter er tilgjengelige: Kontroller at brukeren har prosjekttilgang, er koblet til riktig GitLab-instans og har valgt riktig GitLab-app i ChatGPT eller Codex.