GitLab i ChatGPT og Codex er i øjeblikket i beta.
Oversigt
Brug GitLab Self-Managed-appskabelonen til at oprette et arbejdsområdespecifikt appudkast til en GitLab Self-Managed- eller GitLab Dedicated-instans. Angiv GitLab-værtsnavnet og OAuth-applikationens legitimationsoplysninger, gennemgå appudkastet, og udgiv det derefter til kvalificerede medlemmer af arbejdsområdet. Efter udgivelsen er appens aktiverede handlinger tilgængelige i ChatGPT-samtaler og Codex-sessioner.
Du kan få en oversigt over understøttet GitLab-funktionalitet, tilgængelighed, tilladelser, databrug og netværkskrav her: Forbind GitLab med ChatGPT og Codex.
Det konfigurerer du
Du opretter en arbejdsområdespecifik app ud fra GitLab Self-Managed-appskabelonen. Appen bruger:
En GitLab OAuth-applikation, der er registreret på din GitLab Self-Managed- eller GitLab Dedicated-vært.
GitLab OAuth-applikationens applikations-id og hemmelighed til brugergodkendelse.
De påkrævede OAuth-scopes: api, write_repository og openid.
Dit GitLab-værtsnavn, f.eks. gitlab.example.com, til at udlede slutpunkterne til web, API, godkendelse og tokens.
Før du går i gang
Du skal bruge:
Administrator- eller ejeradgang til ChatGPT-arbejdsområdet.
GitLab-tilladelse til at oprette OAuth-applikationen: ejeradgang til gruppen for en gruppeejet app eller administratoradgang til instansen for en app, der gælder for hele instansen.
Kun GitLab-værtsnavnet uden https://, port eller sti. Brug en GitLab Self-Managed- eller GitLab Dedicated-vært, ikke gitlab.com.
En beslutning om, hvilke GitLab-handlinger ChatGPT og Codex skal understøtte, f.eks. lagersøgning, workflows til merge requests og problemer, filredigering eller mere omfattende Codex-workflows.
Hold ChatGPT og GitLab åbne i hver sin fane. Kopiér den nøjagtige omdirigerings-URI, der vises i ChatGPT. Du må ikke oprette eller ændre den.
Værdier, der skal klargøres
GitLab-værtsnavn: f.eks. gitlab.example.com.
Omdirigerings-URI: Kopiér den fra konfigurationsforløbet for ChatGPT-skabelonen.
GitLab OAuth-applikations-id.
GitLab OAuth-hemmelighed.
OAuth-scopes: Kopiér dem fra konfigurationsforløbet for ChatGPT-skabelonen.
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.
Opret GitLab OAuth-applikationen i GitLab
Vælg, hvor applikationen skal oprettes
Åbn din GitLab-vært, f.eks. https://gitlab.example.com.
Vælg, om du vil oprette en applikation for hele instansen eller en gruppeejet applikation. Valget afgør, hvem der administrerer applikationen. Projektadgang følger fortsat den godkendende brugers GitLab-tilladelser og de tildelte OAuth-scopes.
Gå til Administrator > Applikationer for en applikation, der gælder for hele instansen. Gå til gruppens Indstillinger > Applikationer for en gruppeejet applikation.
Tilføj applikationsoplysningerne
Vælg Ny applikation eller Tilføj ny applikation.
Angiv et tydeligt appnavn, f.eks. GitLab Self-Managed eller GitLab Dedicated.
Indsæt den nøjagtige URI, du kopierede fra ChatGPT, i Omdirigerings-URI.
Lad Fortrolig være aktiveret for denne OAuth-applikation på serversiden.
Konfigurer adgang, og gem
GitLab anbefaler, at du vælger Betroet for en applikation, der gælder for hele instansen. Dermed springes prompten til brugergodkendelse over.
Vælg scopene api, write_repository og openid.
Kontrollér, hvem der kan administrere applikationen, og bekræft, at de godkendende GitLab-brugere har de relevante gruppe- og projekttilladelser.
Gem applikationen.
Krav til OAuth-scopes
Skabelonen anmoder om følgende OAuth-scopes til aktiverede GitLab-handlinger i ChatGPT og Codex:
api: kræves til GitLab API-handlinger, som appen giver adgang til, herunder handlinger for merge requests, problemer og CI/CD.
write_repository: kræves til skrivehandlinger i lagre via Git.
openid: kræves til identitets- og medlemskabsoplysninger fra OpenID Connect.
Kopiér GitLab OAuth-legitimationsoplysningerne
Kopiér applikations-id'et og hemmeligheden i den gemte GitLab-applikation. Behandl hemmeligheden som en legitimationsoplysning. Hvis den bliver afsløret, skal du forny den i GitLab og oprette en ny arbejdsområdeapp.
Afslut konfigurationen i ChatGPT
Gå tilbage til fanen med konfigurationen af ChatGPT-skabelonen.
Indsæt GitLab-applikations-id'et i OAuth-klient-id.
Indsæt GitLab-hemmeligheden i OAuth-klienthemmelighed.
Bekræft, at GitLab-værtsnavnet kun indeholder værtsnavnet, f.eks. gitlab.example.com.
Vælg Opret udkast.
Åbn oplysningerne om appudkastet, og gennemgå Rolleadgang og Konfigurer handlinger.
Udgiv og administrer appen til ChatGPT og Codex
Appudkastet bliver ikke automatisk tilgængeligt for medlemmer, når det oprettes. Når du har gennemgået udkastet:
Vælg Udgiv for appudkastet.
Gå til Indstillinger for arbejdsområde > Plugins, og bekræft, at GitLab er tilgængelig for de ønskede roller.
Gennemgå Rolleadgang for de roller, der skal bruge appen.
Gennemgå de tilgængelige læse- og skrivehandlinger under Konfigurer handlinger.
Vælg under Konfigurer godkendelser, hvornår brugerne skal godkende en handling, før ChatGPT eller Codex bruger appen.
Bed en testbruger med adgang om at åbne GitLab fra Plugin-kataloget eller Indstillinger > Plugins. Bekræft, at brugeren kan installere pluginet og oprette forbindelse til den app, der blev oprettet ud fra GitLab Self-Managed-skabelonen.
Disse indstillinger for appgodkendelse gælder for ChatGPT-samtaler og Codex-tråde.
Konfigurer GitLab-aktivitet til Codex-kodegennemgang
Når appen er udgivet, skal du konfigurere GitLab-aktivitet i Codex, hvis du vil bruge Codex-kodegennemgang. Denne aktivitetskonfiguration konfigurerer de nødvendige webhookhændelser.
Konfigurer en tjenestekonto til arbejdsområdet. Lad Codex oprette kontoen, eller angiv et personligt adgangstoken til en eksisterende tjenestekonto.
Aktivér GitLab-aktivitet for projektet eller en af dets overordnede grupper.
Hvis Codex skal køre kodningsopgaver eller bruge en projektspecifik konfiguration, skal du oprette et projektmiljø.
GitLab-appen bruger bruger-OAuth til læsning og aktiverede handlinger i ChatGPT og Codex. Ved skrivehandlinger fra Codex-gennemgang i GitLab Self-Managed eller GitLab Dedicated bestemmer arbejdsområdets tjenestekontotoken identiteten og de projekter, hvor Codex kan kommentere eller reagere.
Læs mere: Gennemgå GitLab-merge requests med Codex.
Forbind og test GitLab-appen
Som bruger med adgang skal du åbne GitLab fra Plugin-kataloget eller Indstillinger > Plugins. Vælg Installer plugin, og vælg derefter Opret forbindelse.
Hvis dit arbejdsområde har mere end én GitLab-app, skal du vælge appen til denne GitLab Self-Managed- eller GitLab Dedicated-vært.
Godkend GitLab OAuth-applikationen, når du bliver bedt om det.
Kør først en mindre læsehandling i ChatGPT eller Codex, f.eks. at vise tilgængelige projekter eller hente en kendt merge request.
Hvis skrivehandlinger er aktiveret, skal du teste dem i et projekt med lav risiko og i hvert produkt, hvor du vil bruge dem, før de udrulles bredere.
Værtsnavn og OAuth-funktion
Appen bruger værtsnavnet til at udlede GitLab-slutpunkter. Angiv kun værten, f.eks. gitlab.example.com. Medtag ikke https://, en API- eller lagersti, en port eller gitlab.com. Denne skabelon er beregnet til GitLab Self-Managed eller GitLab Dedicated. Brug GitLab-appen til GitLab.com (SaaS).
Fejlfinding ved konfiguration af GitLab Self-Managed-appen
Uoverensstemmelse i omdirigerings-URI: Bekræft, at GitLab OAuth-applikationens omdirigerings-URI er nøjagtig den samme som den, der vises i ChatGPT.
ChatGPT kan ikke oprette eller gemme appudkastet: Bekræft, at værtsnavn, applikations-id, hemmelighed og omdirigerings-URI er angivet.
Godkendelsen lykkes, men projektkald mislykkes: Bekræft, at den GitLab-bruger, som godkender, har adgang til projektet, og at OAuth-applikationen har skabelonens scopes.
API'en returnerer 403 eller utilstrækkelige tilladelser: Bekræft, at den tilknyttede GitLab-konto har de nødvendige projekt- eller gruppetilladelser, og at OAuth-applikationen omfatter skabelonens påkrævede scopes.
Ingen projekter er tilgængelige: Bekræft, at brugeren har projektadgang, er tilknyttet den ønskede GitLab-instans og har valgt den korrekte GitLab-app i ChatGPT eller Codex.