GitLab i ChatGPT og Codex er for øyeblikket i betaversjon.
Oversikt
Bruk appmalen for GitLab Self-Managed til å opprette et arbeidsområdespesifikt apputkast for en GitLab Self-Managed- eller GitLab Dedicated-instans. Oppgi GitLab-vertsnavnet og påloggingsopplysningene for OAuth-applikasjonen, se gjennom apputkastet og publiser det deretter for kvalifiserte medlemmer av arbeidsområdet. 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 konfigurerer du
Du oppretter en arbeidsområdespesifikk app fra appmalen for GitLab Self-Managed. Appen bruker:
En GitLab OAuth-applikasjon som er registrert på GitLab Self-Managed- eller GitLab Dedicated-verten din.
GitLab OAuth-verdiene Applikasjons-ID og Hemmelighet for brukerautorisasjon.
De nødvendige OAuth-omfangene: api, write_repository og openid.
GitLab-vertsnavnet ditt, for eksempel gitlab.example.com, for å utlede endepunktene for nett, API, autorisasjon og token.
Før du begynner
Du trenger:
Administrator- eller eiertilgang til ChatGPT-arbeidsområdet.
GitLab-tillatelse 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 bane. Bruk en GitLab Self-Managed- eller GitLab Dedicated-vert, ikke gitlab.com.
En beslutning om hvilke GitLab-handlinger ChatGPT og Codex skal støtte, for eksempel søk i lager, arbeidsflyter for flettingsforespørsler og saker, filredigering eller mer omfattende Codex-arbeidsflyter.
Hold ChatGPT og GitLab åpne i separate faner. Kopier den nøyaktige Viderekoblings-URI-en som vises i ChatGPT. Ikke opprett eller endre den.
Verdier som må klargjøres
GitLab-vertsnavn: for eksempel gitlab.example.com.
Viderekoblings-URI: Kopier denne fra oppsettsflyten for ChatGPT-malen.
GitLab OAuth-applikasjons-ID.
GitLab OAuth-hemmelighet.
OAuth-omfang: Kopier disse fra oppsettsflyten for ChatGPT-malen.
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.
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. Prosjekttilgangen følger fortsatt GitLab-tillatelsene til brukeren som autoriserer, og OAuth-omfangene som er innvilget.
For en applikasjon som gjelder hele instansen, går du til Administrator > 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.
Lim inn den nøyaktige URI-en du kopierte fra ChatGPT, i Viderekoblings-URI.
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 omfangene api, write_repository og openid.
Kontroller hvem som kan administrere applikasjonen, og bekreft at GitLab-brukerne som autoriserer, har de riktige gruppe- og prosjekttillatelsene.
Lagre applikasjonen.
Krav til OAuth-omfang
Malen ber om følgende OAuth-omfang for aktiverte GitLab-handlinger i ChatGPT og Codex:
api: kreves for GitLab API-operasjoner som appen gjør tilgjengelige, inkludert handlinger for flettingsforespørsler, saker og CI/CD.
write_repository: kreves for skriveoperasjoner i lager via Git.
openid: kreves for OpenID Connect-identitets- og medlemskapsinformasjon.
Kopier GitLab OAuth-påloggingsopplysningene
Kopier Applikasjons-ID og Hemmelighet fra den lagrede GitLab-applikasjonen. Behandle Hemmelighet som en påloggingsopplysning. Hvis den blir eksponert, må du fornye den i GitLab og opprette en ny arbeidsområdeapp.
Fullfør oppsettet i ChatGPT
Gå tilbake til fanen for oppsett av ChatGPT-malen.
Lim inn GitLab-verdien Applikasjons-ID i OAuth-klient-ID.
Lim inn GitLab-verdien Hemmelighet i OAuth-klienthemmelighet.
Kontroller at GitLab-vertsnavnet bare inneholder vertsnavnet, for eksempel gitlab.example.com.
Velg Opprett utkast.
Åpne detaljene for apputkastet, og se gjennom Rolletilgang og Konfigurer handlinger.
Publiser og administrer appen for ChatGPT og Codex
Appen blir ikke automatisk tilgjengelig for medlemmene når du oppretter utkastet. Når du har sett gjennom utkastet:
Velg Publiser for apputkastet.
Gå til Innstillinger for arbeidsområdet > Plugins, og kontroller at GitLab er tilgjengelig for de tiltenkte rollene.
Se gjennom Rolletilgang for rollene som skal bruke appen.
Se gjennom de tilgjengelige lese- og skrivehandlingene under Konfigurer handlinger.
Under Konfigurer godkjenninger velger du når brukerne må godkjenne en handling før ChatGPT eller Codex bruker appen.
Be en testbruker med tilgang om å åpne GitLab fra Plugin-katalogen eller Innstillinger > Plugins. Kontroller at brukeren kan installere pluginen og koble til appen som ble opprettet fra Self-Managed-malen for GitLab.
Disse innstillingene for appgodkjenning gjelder for ChatGPT-samtaler og Codex-tråder.
Konfigurer 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 brukerbasert OAuth for lesing og aktiverte handlinger i ChatGPT og Codex. For skrivehandlinger fra Codex-gjennomgang i GitLab Self-Managed eller GitLab Dedicated avgjør tokenet for den arbeidsområdeadministrerte tjenestekontoen hvilken identitet som brukes, og hvilke prosjekter Codex kan kommentere eller reagere i.
Les mer: Gjennomgå GitLab-flettingsforespørsler med Codex.
Koble til og test GitLab-appen
Som bruker med tilgang åpner du GitLab fra Plugin-katalogen eller Innstillinger > Plugins. Velg Installer plugin, og velg deretter Koble til.
Hvis arbeidsområdet har mer enn én GitLab-app, 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 liten lesehandling i ChatGPT eller Codex, for eksempel ved å vise tilgjengelige prosjekter eller hente en kjent flettingsforespørsel.
Hvis skrivehandlinger er aktivert, tester du dem i et prosjekt med lav risiko og i hvert produkt der du planlegger å bruke dem, før en bredere utrulling.
Vertsnavn og OAuth-atferd
Appen bruker vertsnavnet til å utlede GitLab-endepunkter. Skriv bare inn verten, for eksempel gitlab.example.com. Ikke ta med https://, en API- eller lagerbane, en port eller gitlab.com. Denne malen er for GitLab Self-Managed eller GitLab Dedicated. Bruk GitLab-appen for GitLab.com (SaaS).
Feilsøking av oppsettet for GitLab Self-Managed-appen
Viderekoblings-URI-en samsvarer ikke: Kontroller at viderekoblings-URI-en for GitLab OAuth-applikasjonen samsvarer nøyaktig med viderekoblings-URI-en som vises i ChatGPT.
ChatGPT kan ikke opprette eller lagre apputkastet: Kontroller at vertsnavn, applikasjons-ID, hemmelighet og viderekoblings-URI er angitt.
Autentiseringen lykkes, men prosjektkall mislykkes: Kontroller at GitLab-brukeren som autoriserer, har tilgang til prosjektet, og at OAuth-applikasjonen har omfangene som malen krever.
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 omfangene 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.