GitLab i ChatGPT og Codex er i øjeblikket i beta.
Oversigt
Brug appskabelonen til GitLab Self-Managed til at oprette en appkladde i dit arbejdsområde til en GitLab Self-Managed- eller GitLab Dedicated-instans. Angiv GitLab-værtsnavnet og legitimationsoplysningerne til OAuth-applikationen, gennemgå appkladden, og udgiv den derefter til de medlemmer af arbejdsområdet, der skal have adgang. Efter udgivelsen er appens aktiverede handlinger tilgængelige i ChatGPT-samtaler og Codex-sessioner.
Du kan finde en oversigt over understøttede GitLab-funktioner, tilgængelighed, tilladelser, databrug og netværkskrav her: Forbind GitLab med ChatGPT og Codex.
Det konfigurerer du
Du opretter en app til dit arbejdsområde ud fra appskabelonen til GitLab Self-Managed. Appen bruger:
En GitLab OAuth-applikation, der er registreret på din GitLab Self-Managed- eller GitLab Dedicated-vært.
Applikations-id og Hemmelighed fra GitLab OAuth til brugerautorisation.
De påkrævede OAuth-scopes: api, write_repository og openid.
Dit GitLab-værtsnavn, f.eks. gitlab.example.com, til at udlede endepunkter til web, API, autorisation og tokens.
Før du begynder
Du skal have:
Administrator- eller ejeradgang til ChatGPT-arbejdsområdet.
Tilladelse i GitLab til at oprette OAuth-applikationen: ejeradgang til gruppen for en gruppeejet app eller administratoradgang til instansen for en app til hele instansen.
Kun GitLab-værtsnavnet, uden https://, port eller sti. Brug en GitLab Self-Managed- eller GitLab Dedicated-vært, ikke gitlab.com.
Besluttet, hvilke GitLab-handlinger ChatGPT og Codex skal understøtte, f.eks. søgning i lagre, arbejdsgange for merge-anmodninger og issues, filredigering eller mere omfattende Codex-arbejdsgange.
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.
For at åbne siden Apps fra Administrationskonsol skal du vælge det ønskede ChatGPT-arbejdsområde, åbne Plugins og vælge Administrer ældre apps.
Værdier, du skal have klar
GitLab-værtsnavn: f.eks. gitlab.example.com.
Omdirigerings-URI: Kopiér den fra skabelonopsætningen i ChatGPT.
Applikations-id til GitLab OAuth.
Hemmelighed til GitLab OAuth.
OAuth-scopes: Kopiér dem fra skabelonopsætningen 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.
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 til hele instansen eller en gruppeejet applikation. Valget afgør, hvem der administrerer applikationen. Projektadgangen afhænger stadig af GitLab-tilladelserne for den bruger, der giver autorisation, og af de tildelte OAuth-scopes.
For en applikation til hele instansen skal du gå til Administration > Applikationer. For en gruppeejet applikation skal du gå til gruppens Indstillinger > Applikationer.
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 serverside-OAuth-applikation.
Konfigurer adgang, og gem
For en applikation, der gælder for hele instansen, anbefaler GitLab at vælge Betroet. Dermed springes anmodningen om brugerautorisation over.
Vælg scopes api, write_repository og openid.
Gennemgå, hvem der kan administrere applikationen, og kontrollér, at de GitLab-brugere, der giver autorisation, har de rette 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: påkrævet til de GitLab API-operationer, appen stiller til rådighed, herunder handlinger for merge-anmodninger, issues og CI/CD.
write_repository: påkrævet til skriveoperationer i lagre via Git.
openid: påkrævet til identitets- og medlemskabsoplysninger via OpenID Connect.
Kopiér GitLab OAuth-legitimationsoplysningerne
Kopiér Applikations-id og Hemmelighed fra den gemte GitLab-applikation. Behandl Hemmelighed som en legitimationsoplysning. Hvis den bliver eksponeret, skal du forny den i GitLab og oprette en ny app i arbejdsområdet.
Afslut opsætningen i ChatGPT
Gå tilbage til fanen med skabelonopsætningen i ChatGPT.
Indsæt værdien fra Applikations-id i GitLab i OAuth-klient-id.
Indsæt værdien fra Hemmelighed i GitLab i OAuth-klienthemmelighed.
Kontrollér, at GitLab-værtsnavnet kun indeholder selve værtsnavnet, f.eks. gitlab.example.com.
Vælg Opret kladde.
Åbn appkladdens detaljer, og gennemgå Rolleadgang og Konfigurer handlinger.
Udgiv og administrer appen til ChatGPT og Codex
Når du opretter appkladden, bliver den ikke automatisk tilgængelig for medlemmerne. Når du har gennemgået kladden:
Vælg Udgiv for appkladden.
Gå til Administrationskonsol, vælg det ønskede ChatGPT-arbejdsområde, og åbn Plugins. Kontrollér derefter, 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.
Under Konfigurer godkendelser skal du vælge, hvornår brugere skal godkende en handling, før ChatGPT eller Codex bruger appen.
Bed en testbruger med adgang om at åbne GitLab fra Pluginkataloget eller Indstillinger > Plugins. Kontrollér, at brugeren kan installere pluginet og oprette forbindelse til den app, der er oprettet ud fra skabelonen til GitLab Self-Managed.
Disse indstillinger for appgodkendelse gælder for ChatGPT-samtaler og Codex-tråde.
Konfigurer GitLab-aktivitet til kodegennemgang med Codex
Når appen er udgivet, skal du konfigurere GitLab-aktivitet i Codex, hvis du vil bruge Codex til kodegennemgang. Denne aktivitetsopsætning konfigurerer de nødvendige webhook-hændelser.
Konfigurer en servicekonto til arbejdsområdet. Lad Codex oprette kontoen, eller angiv et personligt adgangstoken til en eksisterende servicekonto.
Aktivér GitLab-aktivitet for projektet eller en af dets overordnede grupper.
Hvis Codex skal udføre kodningsopgaver eller bruge en projektspecifik opsætning, skal du oprette et projektmiljø.
GitLab-appen bruger brugerens OAuth-autorisation til læsning og aktiverede handlinger i ChatGPT og Codex. Når Codex skriver i forbindelse med kodegennemgang på GitLab Self-Managed eller GitLab Dedicated, bestemmer servicekontoens token, som administreres af arbejdsområdet, hvilken identitet Codex bruger, og i hvilke projekter Codex kan kommentere eller reagere.
Læs mere: Gennemgå GitLab-merge-anmodninger med Codex.
Opret forbindelse til GitLab-appen, og test den
Åbn GitLab fra Pluginkataloget eller Indstillinger > Plugins som en bruger med adgang. 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.
Giv GitLab OAuth-applikationen autorisation, når du bliver bedt om det.
Start med en lille læsehandling i ChatGPT eller Codex, f.eks. at vise tilgængelige projekter eller hente en kendt merge-anmodning.
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 en bredere udrulning.
Værtsnavn og OAuth-adfærd
Appen bruger værtsnavnet til at udlede GitLab-endepunkter. Angiv kun værtsnavnet, f.eks. gitlab.example.com. Medtag ikke https://, en API- eller lagersti, en port eller gitlab.com. Denne skabelon er til GitLab Self-Managed eller GitLab Dedicated. Til GitLab.com (SaaS) skal du bruge GitLab-appen.
Fejlfinding af opsætningen af GitLab Self-Managed-appen
Omdirigerings-URI stemmer ikke overens: Kontrollér, at omdirigerings-URI'en i GitLab OAuth-applikationen er nøjagtig den samme som den, der vises i ChatGPT.
ChatGPT kan ikke oprette eller gemme appkladden: Kontrollér, at værtsnavn, Applikations-id, Hemmelighed og Omdirigerings-URI er angivet.
Godkendelsen lykkes, men projektkald mislykkes: Kontrollér, at den GitLab-bruger, der giver autorisation, har adgang til projektet, og at OAuth-applikationen har skabelonens scopes.
API'et returnerer 403 eller utilstrækkelige tilladelser: Kontrollér, at den tilknyttede GitLab-konto har de nødvendige projekt- eller gruppetilladelser, og at OAuth-applikationen omfatter de scopes, skabelonen kræver.
Ingen projekter er tilgængelige: Kontrollér, at brugeren har projektadgang, er forbundet til den ønskede GitLab-instans og har valgt den korrekte GitLab-app i ChatGPT eller Codex.