GitLab en ChatGPT y Codex se encuentra actualmente en fase beta.
Descripción general
Usa la plantilla de aplicación de GitLab Self-Managed para crear un borrador de aplicación específico de tu Área de trabajo para una instancia de GitLab Self-Managed o GitLab Dedicated. Proporciona el nombre de host de GitLab y las credenciales de la aplicación OAuth, revisa el borrador de la aplicación y publícala para los miembros del Área de trabajo que cumplan los requisitos. Tras la publicación, las acciones habilitadas de la aplicación estarán disponibles en las conversaciones de ChatGPT y las sesiones de Codex.
Para obtener una descripción general de las funciones compatibles de GitLab, la disponibilidad, los permisos, el uso de datos y los requisitos de red, consulta: conectar GitLab a ChatGPT y Codex.
Qué vas a configurar
Vas a crear una aplicación específica de tu Área de trabajo a partir de la plantilla de aplicación de GitLab Self-Managed. La aplicación usa:
Una aplicación OAuth de GitLab registrada en tu host de GitLab Self-Managed o GitLab Dedicated.
El ID de aplicación y el Secreto de OAuth de GitLab para la autorización de usuarios.
Los ámbitos de OAuth necesarios: api, write_repository y openid.
Tu nombre de host de GitLab, por ejemplo, gitlab.example.com, para determinar los puntos de conexión web, de API, de autorización y de tokens.
Antes de empezar
Necesitas:
Acceso de administrador o propietario del Área de trabajo de ChatGPT.
Permiso en GitLab para crear la aplicación OAuth: acceso de propietario del grupo para una aplicación propiedad de un grupo, o acceso de administrador de la instancia para una aplicación que abarque toda la instancia.
Solo el nombre de host de GitLab, sin https://, puerto ni ruta. Usa un host de GitLab Self-Managed o GitLab Dedicated, no gitlab.com.
Haber decidido qué acciones de GitLab deben admitir ChatGPT y Codex, como la búsqueda en repositorios, los flujos de trabajo de solicitudes de fusión o incidencias, la edición de archivos o flujos de trabajo más amplios de Codex.
Mantén ChatGPT y GitLab abiertos en pestañas separadas. Copia el URI de redireccionamiento exacto que aparece en ChatGPT; no crees uno ni lo modifiques.
Para abrir la página Aplicaciones desde la Consola de administración, selecciona el Área de trabajo de ChatGPT que corresponda, abre Complementos y selecciona Gestionar aplicaciones heredadas.
Valores que debes preparar
Nombre de host de GitLab: por ejemplo, gitlab.example.com.
URI de redireccionamiento: cópialo del proceso de configuración de la plantilla de ChatGPT.
ID de aplicación de OAuth de GitLab.
Secreto de OAuth de GitLab.
Ámbitos de OAuth: cópialos del proceso de configuración 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 la aplicación OAuth de GitLab en GitLab
Elige dónde crear la aplicación
Abre tu host de GitLab, por ejemplo, https://gitlab.example.com.
Elige si quieres crear una aplicación para toda la instancia o una aplicación propiedad de un grupo. Esta elección determina quién gestiona la aplicación; el acceso a los proyectos sigue dependiendo de los permisos en GitLab del usuario que la autoriza y de los ámbitos de OAuth concedidos.
Para una aplicación que abarque toda la instancia, ve a Administración > Aplicaciones. Para una aplicación propiedad de un grupo, ve a Configuración > Aplicaciones del grupo.
Añade los detalles de la aplicación
Selecciona Nueva aplicación o Añadir nueva aplicación.
Introduce un nombre claro para la aplicación, como GitLab Self-Managed o GitLab Dedicated.
En URI de redireccionamiento, pega el URI exacto que has copiado de ChatGPT.
Mantén habilitada la opción Confidencial para esta aplicación OAuth del lado del servidor.
Configura el acceso y guarda la aplicación
Para una aplicación que abarque toda la instancia, GitLab recomienda seleccionar De confianza. Así se omite la solicitud de autorización al usuario.
Selecciona los ámbitos api, write_repository y openid.
Revisa quién puede gestionar la aplicación y confirma que los usuarios de GitLab que la autoricen tengan los permisos de grupo y proyecto adecuados.
Guarda la aplicación.
Requisitos de los ámbitos de OAuth
La plantilla solicita los siguientes ámbitos de OAuth para las acciones de GitLab habilitadas en ChatGPT y Codex:
api: necesario para las operaciones de la API de GitLab que ofrece la aplicación, incluidas las acciones de solicitudes de fusión, incidencias y CI/CD.
write_repository: necesario para las operaciones de escritura en repositorios a través de Git.
openid: necesario para la información de identidad y pertenencia de OpenID Connect.
Copia las credenciales OAuth de GitLab
En la aplicación de GitLab guardada, copia el ID de aplicación y el Secreto. Trata el Secreto como una credencial. Si queda expuesto, renuévalo en GitLab y crea una nueva aplicación del Área de trabajo.
Completa la configuración en ChatGPT
Vuelve a la pestaña de configuración de la plantilla de ChatGPT.
Pega el ID de aplicación de GitLab en ID de cliente de OAuth.
Pega el Secreto de GitLab en Secreto de cliente de OAuth.
Confirma que el campo de nombre de host de GitLab contiene solo el nombre de host, por ejemplo, gitlab.example.com.
Selecciona Crear borrador.
Abre los detalles del borrador de la aplicación y revisa Acceso por rol y Configurar acciones.
Publica y gestiona la aplicación para ChatGPT y Codex
Crear el borrador de la aplicación no la pone automáticamente a disposición de los miembros. Tras revisar el borrador:
Selecciona Publicar en el borrador de la aplicación.
Ve a la Consola de administración, selecciona el Área de trabajo de ChatGPT que corresponda y abre Complementos. Después, confirma que GitLab esté disponible para los roles previstos.
Revisa Acceso por rol para los roles que deban usar la aplicación.
En Configurar acciones, revisa las acciones de lectura y escritura disponibles.
En Configurar aprobaciones, elige cuándo deben los usuarios aprobar una acción antes de que ChatGPT o Codex use la aplicación.
Pide a un usuario de prueba con acceso que abra GitLab desde el Directorio de complementos o desde Configuración > Complementos. Confirma que el usuario pueda instalar el complemento y conectarse a la aplicación creada a partir de la plantilla de GitLab Self-Managed.
Estos ajustes de aprobación de la aplicación se aplican a las conversaciones de ChatGPT y a los hilos de Codex.
Configura la actividad de GitLab para la revisión de código con Codex
Una vez publicada la aplicación, configura la actividad de GitLab en Codex si tienes previsto usar la revisión de código con Codex. Esta configuración de actividad establece los eventos de webhook necesarios.
Abre la configuración de conectores de Codex.
Configura una cuenta de servicio del Área de trabajo. Deja que Codex cree la cuenta o proporciona un token de acceso personal de una cuenta de servicio existente.
Habilita Actividad de GitLab para el proyecto o uno de sus grupos superiores.
Si Codex necesita ejecutar tareas de programación o usar una configuración específica del proyecto, crea un entorno de proyecto.
La aplicación de GitLab usa OAuth de usuario para las lecturas y las acciones habilitadas en ChatGPT y Codex. Para las operaciones de escritura de las revisiones de Codex en GitLab Self-Managed o GitLab Dedicated, el token de la cuenta de servicio gestionada por el Área de trabajo determina con qué identidad y en qué proyectos puede Codex comentar o reaccionar.
Más información: revisar solicitudes de fusión de GitLab con Codex.
Conecta y prueba la aplicación de GitLab
Con una cuenta de usuario que tenga acceso, abre GitLab desde el Directorio de complementos o desde Configuración > Complementos. Selecciona Instalar complemento y, después, Conectar.
Si tu Área de trabajo tiene más de una aplicación de GitLab, elige la correspondiente a este host de GitLab Self-Managed o GitLab Dedicated.
Autoriza la aplicación OAuth de GitLab cuando se te solicite.
Ejecuta primero una acción de lectura sencilla en ChatGPT o Codex, como listar los proyectos accesibles u obtener una solicitud de fusión conocida.
Si las acciones de escritura están habilitadas, pruébalas en un proyecto de bajo riesgo y en cada producto en el que pienses usarlas antes de ampliar su uso.
Nombre de host y funcionamiento de OAuth
La aplicación usa el nombre de host para determinar los puntos de conexión de GitLab. Introduce solo el host, por ejemplo, gitlab.example.com. No incluyas https://, una ruta de API o de repositorio, un puerto ni gitlab.com. Esta plantilla es para GitLab Self-Managed o GitLab Dedicated. Para GitLab.com (SaaS), usa la aplicación de GitLab.
Solución de problemas de configuración de la aplicación de GitLab Self-Managed
El URI de redireccionamiento no coincide: confirma que el URI de redireccionamiento de la aplicación OAuth de GitLab coincida exactamente con el que aparece en ChatGPT.
ChatGPT no puede crear o guardar el borrador de la aplicación: confirma que se hayan proporcionado el nombre de host, el ID de aplicación, el secreto y el URI de redireccionamiento.
La autenticación se completa, pero las llamadas al proyecto fallan: confirma que el usuario de GitLab que autoriza la aplicación pueda acceder al proyecto y que la aplicación OAuth tenga los ámbitos de la plantilla.
La API devuelve un error 403 o de permisos insuficientes: confirma que la cuenta de GitLab conectada tenga los permisos de proyecto o grupo necesarios y que la aplicación OAuth incluya los ámbitos que exige la plantilla.
No se puede acceder a ningún proyecto: confirma que el usuario tenga acceso al proyecto, esté conectado a la instancia de GitLab prevista y haya seleccionado la aplicación de GitLab correcta en ChatGPT o Codex.