GitLab a ChatGPT i Codex es troba actualment en fase beta.
Descripció general
Utilitza la plantilla d'aplicació de GitLab Self-Managed per crear un esborrany d'aplicació específic de l'espai de treball per a una instància de GitLab Self-Managed o GitLab Dedicated. Proporciona el nom d'amfitrió de GitLab i les credencials de l'aplicació OAuth, revisa l'esborrany de l'aplicació i publica-la per als membres de l'espai de treball que hi puguin tenir accés. Un cop publicada, les accions habilitades de l'aplicació estan disponibles a les converses de ChatGPT i a les sessions de Codex.
Per obtenir una visió general de les funcions compatibles de GitLab, la disponibilitat, els permisos, l'ús de dades i els requisits de xarxa, consulta: Connexió de GitLab a ChatGPT i Codex.
Què estàs configurant
Estàs creant una aplicació específica de l'espai de treball a partir de la plantilla d'aplicació de GitLab Self-Managed. L'aplicació utilitza:
Una aplicació OAuth de GitLab registrada al teu amfitrió de GitLab Self-Managed o GitLab Dedicated.
L'Identificador de l'aplicació i el Secret OAuth de GitLab per a l'autorització dels usuaris.
Els àmbits OAuth necessaris: api, write_repository i openid.
El teu nom d'amfitrió de GitLab, com ara gitlab.example.com, per determinar els punts de connexió web, d'API, d'autorització i de testimonis.
Abans de començar
Necessites:
Accés d'administrador o de propietari a l'espai de treball de ChatGPT.
Permís a GitLab per crear l'aplicació OAuth: accés de Propietari del grup per a una aplicació propietat d'un grup, o accés d'administrador de la instància per a una aplicació que abasti tota la instància.
Només el nom d'amfitrió de GitLab, sense https://, cap port ni cap camí. Utilitza un amfitrió de GitLab Self-Managed o GitLab Dedicated, no gitlab.com.
Haver decidit quines accions de GitLab han de permetre ChatGPT i Codex, com ara cerques en repositoris, fluxos de treball amb sol·licituds de fusió o incidències, edició de fitxers o fluxos de treball més amplis de Codex.
Mantén ChatGPT i GitLab oberts en pestanyes separades. Copia exactament l'URI de redirecció que es mostra a ChatGPT; no en creïs cap ni el modifiquis.
Per obrir la pàgina Aplicacions des de la Consola d'administració, selecciona l'espai de treball de ChatGPT que correspongui, obre Connectors i selecciona Gestiona les aplicacions antigues.
Valors que cal preparar
Nom d'amfitrió de GitLab: per exemple, gitlab.example.com.
URI de redirecció: copia'l del procés de configuració de la plantilla de ChatGPT.
Identificador de l'aplicació OAuth de GitLab.
Secret OAuth de GitLab.
Àmbits OAuth: copia'ls del procés de configuració de la plantilla de 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.
Crea l'aplicació OAuth de GitLab a GitLab
Tria on vols crear l'aplicació
Obre el teu amfitrió de GitLab, com ara https://gitlab.example.com.
Tria si vols crear una aplicació per a tota la instància o una aplicació propietat d'un grup. Aquesta elecció determina qui gestiona l'aplicació; l'accés als projectes continua regint-se pels permisos de GitLab de l'usuari que concedeix l'autorització i pels àmbits OAuth concedits.
Per a una aplicació que abasti tota la instància, ves a Administració > Aplicacions. Per a una aplicació propietat d'un grup, ves a Configuració > Aplicacions del grup.
Afegeix les dades de l'aplicació
Selecciona Aplicació nova o Afegeix una aplicació nova.
Introdueix un nom clar per a l'aplicació, com ara GitLab Self-Managed o GitLab Dedicated.
A URI de redirecció, enganxa l'URI exacte que has copiat de ChatGPT.
Mantén activada l'opció Confidencial per a aquesta aplicació OAuth que s'executa al servidor.
Configura l'accés i desa
Per a una aplicació que abasti tota la instància, GitLab recomana seleccionar De confiança. Això omet la sol·licitud d'autorització de l'usuari.
Selecciona els àmbits api, write_repository i openid.
Revisa qui pot gestionar l'aplicació i comprova que els usuaris de GitLab que l'autoritzin tinguin els permisos de grup i de projecte adequats.
Desa l'aplicació.
Requisits dels àmbits OAuth
La plantilla sol·licita els àmbits OAuth següents per a les accions de GitLab habilitades a ChatGPT i Codex:
api: necessari per a les operacions de l'API de GitLab que ofereix l'aplicació, incloses les accions de sol·licituds de fusió, incidències i CI/CD.
write_repository: necessari per a les operacions d'escriptura al repositori mitjançant Git.
openid: necessari per a la informació d'identitat i de pertinença a grups d'OpenID Connect.
Copia les credencials OAuth de GitLab
A l'aplicació de GitLab desada, copia l'Identificador de l'aplicació i el Secret. Tracta el Secret com una credencial. Si queda exposat, renova'l a GitLab i crea una aplicació nova per a l'espai de treball.
Acaba la configuració a ChatGPT
Torna a la pestanya de configuració de la plantilla de ChatGPT.
Enganxa l'Identificador de l'aplicació de GitLab a Identificador de client OAuth.
Enganxa el Secret de GitLab a Secret de client OAuth.
Comprova que el camp del nom d'amfitrió de GitLab només contingui el nom d'amfitrió, com ara gitlab.example.com.
Selecciona Crea un esborrany.
Obre els detalls de l'esborrany de l'aplicació i revisa Accés per rols i Configura les accions.
Publica i gestiona l'aplicació per a ChatGPT i Codex
Crear l'esborrany de l'aplicació no la posa automàticament a disposició dels membres. Després de revisar l'esborrany:
Selecciona Publica a l'esborrany de l'aplicació.
Ves a la Consola d'administració, selecciona l'espai de treball de ChatGPT que correspongui i obre Connectors. A continuació, comprova que GitLab estigui disponible per als rols previstos.
Revisa Accés per rols per als rols que hagin d'utilitzar l'aplicació.
A Configura les accions, revisa les accions de lectura i escriptura disponibles.
A Configura les aprovacions, tria quan els usuaris han d'aprovar una acció abans que ChatGPT o Codex utilitzi l'aplicació.
Demana a un usuari de prova amb accés que obri GitLab des del Directori de connectors o des de Configuració > Connectors. Comprova que l'usuari pugui instal·lar el connector i connectar-se a l'aplicació creada a partir de la plantilla de GitLab Self-Managed.
Aquesta configuració d'aprovacions de l'aplicació s'aplica a les converses de ChatGPT i als fils de Codex.
Configura l'activitat de GitLab per a la revisió de codi amb Codex
Un cop publicada l'aplicació, configura l'activitat de GitLab a Codex si tens previst utilitzar la revisió de codi amb Codex. Aquesta configuració d'activitat estableix els esdeveniments de webhook necessaris.
Configura un compte de servei de l'espai de treball. Deixa que Codex creï el compte o proporciona un testimoni d'accés personal per a un compte de servei existent.
Activa Activitat de GitLab per al projecte o per a un dels seus grups superiors.
Si Codex ha d'executar tasques de programació o utilitzar una configuració específica del projecte, crea un entorn de projecte.
L'aplicació de GitLab utilitza l'autorització OAuth de l'usuari per a les lectures i les accions habilitades a ChatGPT i Codex. Per a les operacions d'escriptura de les revisions de Codex a GitLab Self-Managed o GitLab Dedicated, el testimoni del compte de servei gestionat per l'espai de treball determina amb quina identitat i en quins projectes Codex pot fer comentaris o afegir reaccions.
Més informació: Revisa les sol·licituds de fusió de GitLab amb Codex.
Connecta l'aplicació de GitLab i prova-la
Com a usuari amb accés, obre GitLab des del Directori de connectors o des de Configuració > Connectors. Selecciona Instal·la el connector i, a continuació, Connecta.
Si el teu espai de treball té més d'una aplicació de GitLab, tria la d'aquest amfitrió de GitLab Self-Managed o GitLab Dedicated.
Autoritza l'aplicació OAuth de GitLab quan se't demani.
Executa primer una acció de lectura senzilla a ChatGPT o Codex, com ara llistar els projectes accessibles o obtenir una sol·licitud de fusió coneguda.
Si les accions d'escriptura estan habilitades, prova-les en un projecte de baix risc i en cada producte on tinguis previst utilitzar-les abans d'ampliar-ne l'ús.
Nom d'amfitrió i funcionament d'OAuth
L'aplicació utilitza el nom d'amfitrió per determinar els punts de connexió de GitLab. Introdueix només el nom d'amfitrió, com ara gitlab.example.com. No hi incloguis https://, cap camí d'API o de repositori, cap port ni gitlab.com. Aquesta plantilla és per a GitLab Self-Managed o GitLab Dedicated. Per a GitLab.com (SaaS), utilitza l'aplicació de GitLab.
Resolució de problemes de configuració de l'aplicació de GitLab Self-Managed
L'URI de redirecció no coincideix: comprova que l'URI de redirecció de l'aplicació OAuth de GitLab coincideixi exactament amb l'URI de redirecció que es mostra a ChatGPT.
ChatGPT no pot crear o desar l'esborrany de l'aplicació: comprova que s'hagin indicat el nom d'amfitrió, l'Identificador de l'aplicació, el Secret i l'URI de redirecció.
L'autenticació es completa correctament, però les crides al projecte fallen: comprova que l'usuari de GitLab que concedeix l'autorització pugui accedir al projecte i que l'aplicació OAuth tingui els àmbits de la plantilla.
L'API retorna un error 403 o de permisos insuficients: comprova que el compte de GitLab connectat tingui els permisos de projecte o de grup necessaris i que l'aplicació OAuth inclogui els àmbits que requereix la plantilla.
No es pot accedir a cap projecte: comprova que l'usuari tingui accés als projectes, estigui connectat a la instància de GitLab prevista i hagi seleccionat l'aplicació de GitLab correcta a ChatGPT o Codex.