GitLab a ChatGPT i Codex es troba actualment en fase beta.
Informació general
Utilitzeu la plantilla de l'aplicació GitLab Self-Managed per crear un esborrany d'aplicació específic per a l'espai de treball per a una instància de GitLab Self-Managed o GitLab Dedicated. Proporcioneu el nom d'amfitrió de GitLab i les credencials de l'aplicació OAuth, reviseu l'esborrany i publiqueu-lo per als membres de l'espai de treball que hi tinguin accés. Després de publicar-la, les accions habilitades de l'aplicació estan disponibles a les converses de ChatGPT i a les sessions de Codex.
Per obtenir informació general sobre el comportament admès de GitLab, la disponibilitat, els permisos, l'ús de dades i els requisits de xarxa, consulteu Connectar GitLab a ChatGPT i Codex.
Què configurareu
Creareu una aplicació específica per a l'espai de treball a partir de la plantilla de l'aplicació GitLab Self-Managed. L'aplicació utilitza:
Una aplicació OAuth de GitLab registrada al vostre amfitrió de GitLab Self-Managed o GitLab Dedicated.
L'ID de l'aplicació i el secret d'OAuth de GitLab per autoritzar els usuaris.
Els àmbits OAuth necessaris: api, write_repository i openid.
El nom d'amfitrió de GitLab, com ara gitlab.example.com, per obtenir els punts de connexió web, de l'API, d'autorització i de segments.
Abans de començar
Necessiteu:
Accés com a administrador o propietari de l'espai de treball de ChatGPT.
Permís de 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ó disponible a tota la instància.
Només el nom d'amfitrió de GitLab, sense https://, cap port ni cap camí. Utilitzeu un amfitrió de GitLab Self-Managed o GitLab Dedicated, no gitlab.com.
Una decisió sobre quines accions de GitLab han d'admetre ChatGPT i Codex, com ara la cerca en repositoris, els fluxos de treball de sol·licituds de fusió i incidències, l'edició de fitxers o fluxos de treball més amplis de Codex.
Manteniu ChatGPT i GitLab oberts en pestanyes separades. Copieu l'URI de redirecció exactament com es mostra a ChatGPT; no la creeu ni la modifiqueu.
Valors que cal preparar
Nom d'amfitrió de GitLab: per exemple, gitlab.example.com.
URI de redirecció: copieu-la del procés de configuració de la plantilla de ChatGPT.
ID de l'aplicació OAuth de GitLab.
Secret d'OAuth de GitLab.
Àmbits OAuth: copieu-los 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 > 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.
Crear l'aplicació OAuth de GitLab a GitLab
Trieu on voleu crear l'aplicació
Obriu el vostre amfitrió de GitLab, com ara https://gitlab.example.com.
Trieu si voleu crear una aplicació per a tota la instància o una aplicació propietat d'un grup. Aquesta opció determina qui administra l'aplicació; l'accés als projectes continua depenent dels permisos de GitLab de l'usuari que autoritza i dels àmbits OAuth concedits.
Per a una aplicació disponible a tota la instància, aneu a Administració > Aplicacions. Per a una aplicació propietat d'un grup, aneu a Configuració > Aplicacions del grup.
Afegiu les dades de l'aplicació
Seleccioneu Aplicació nova o Afegeix una aplicació nova.
Introduïu un nom clar per a l'aplicació, com ara GitLab Self-Managed o GitLab Dedicated.
A URI de redirecció, enganxeu l'URI exacta que heu copiat de ChatGPT.
Manteniu activada l'opció Confidencial per a aquesta aplicació OAuth del servidor.
Configureu l'accés i deseu
Per a una aplicació disponible a tota la instància, GitLab recomana seleccionar De confiança. Això omet la indicació d'autorització de l'usuari.
Seleccioneu els àmbits api, write_repository i openid.
Reviseu qui pot administrar l'aplicació i confirmeu que els usuaris de GitLab que l'autoritzen tinguin els permisos de grup i projecte adequats.
Deseu 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 en repositoris mitjançant Git.
openid: necessari per a la identitat i la informació de pertinença d'OpenID Connect.
Copieu les credencials OAuth de GitLab
A l'aplicació GitLab desada, copieu l'ID de l'aplicació i el secret. Tracteu el secret com una credencial. Si queda exposat, renoveu-lo a GitLab i creeu una aplicació nova per a l'espai de treball.
Finalitzeu la configuració a ChatGPT
Torneu a la pestanya de configuració de la plantilla de ChatGPT.
Enganxeu l'ID de l'aplicació de GitLab a ID de client OAuth.
Enganxeu el secret de GitLab a Secret del client OAuth.
Confirmeu que el nom d'amfitrió de GitLab només contingui el nom d'amfitrió, com ara gitlab.example.com.
Seleccioneu Crea un esborrany.
Obriu els detalls de l'esborrany de l'aplicació i reviseu Accés per rols i Configura les accions.
Publiqueu i administreu l'aplicació per a ChatGPT i Codex
La creació de l'esborrany de l'aplicació no fa que estigui disponible automàticament per als membres. Després de revisar l'esborrany:
Seleccioneu Publica per a l'esborrany de l'aplicació.
Aneu a Configuració de l'espai de treball > Connectors i confirmeu que GitLab estigui disponible per als rols previstos.
Reviseu l'Accés per rols dels rols que han d'utilitzar l'aplicació.
A Configura les accions, reviseu les accions de lectura i escriptura disponibles.
A Configura les aprovacions, trieu quan els usuaris han d'aprovar una acció abans que ChatGPT o Codex utilitzin l'aplicació.
Demaneu a un usuari de prova amb accés que obri GitLab des del Directori de connectors o des de Configuració > Connectors. Confirmeu 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'aprovació de l'aplicació s'aplica a les converses de ChatGPT i als fils de Codex.
Configureu l'activitat de GitLab per a la revisió de codi de Codex
Després de publicar l'aplicació, configureu l'activitat de GitLab a Codex si teniu previst utilitzar la revisió de codi de Codex. Aquesta configuració de l'activitat configura els esdeveniments de webhook necessaris.
Obriu la configuració dels connectors de Codex.
Configureu un compte de servei de l'espai de treball. Deixeu que Codex creï el compte o proporcioneu un segment d'accés personal per a un compte de servei existent.
Activeu l'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, creeu un entorn de projecte.
L'aplicació GitLab utilitza l'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 segment del compte de servei administrat per l'espai de treball determina la identitat i els projectes en què Codex pot comentar o reaccionar.
Més informació: Reviseu les sol·licituds de fusió de GitLab amb Codex.
Connecteu i proveu l'aplicació GitLab
Com a usuari amb accés, obriu GitLab des del Directori de connectors o des de Configuració > Connectors. Seleccioneu Instal·la el connector i, després, Connecta.
Si el vostre espai de treball té més d'una aplicació GitLab, trieu l'aplicació corresponent a aquest amfitrió de GitLab Self-Managed o GitLab Dedicated.
Quan se us demani, autoritzeu l'aplicació OAuth de GitLab.
Executeu primer una petita acció de lectura 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, proveu-les en un projecte de baix risc i en cada producte on les vulgueu utilitzar abans d'implantar-les més àmpliament.
Comportament del nom d'amfitrió i d'OAuth
L'aplicació utilitza el nom d'amfitrió per obtenir els punts de connexió de GitLab. Introduïu només l'amfitrió, com ara gitlab.example.com. No inclogueu 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), utilitzeu l'aplicació GitLab.
Resolució de problemes de configuració de l'aplicació GitLab Self-Managed
L'URI de redirecció no coincideix: comproveu que l'URI de redirecció de l'aplicació OAuth de GitLab coincideixi exactament amb el que es mostra a ChatGPT.
ChatGPT no pot crear ni desar l'esborrany de l'aplicació: comproveu que hi hagi el nom d'amfitrió, l'ID de l'aplicació, el secret i l'URI de redirecció.
L'autenticació funciona, però les crides al projecte fallen: comproveu que l'usuari de GitLab que autoritza tingui accés al projecte i que l'aplicació OAuth tingui els àmbits de la plantilla.
L'API retorna 403 o permisos insuficients: comproveu que el compte de GitLab connectat tingui els permisos necessaris per al projecte o grup i que l'aplicació OAuth inclogui els àmbits requerits per la plantilla.
No es pot accedir a cap projecte: comproveu que l'usuari tingui accés al projecte, estigui connectat a la instància de GitLab prevista i hagi seleccionat l'aplicació GitLab correcta a ChatGPT o Codex.