Saltar al contenido principal

​
Resumen general

Esta guía describe la configuración completa para integrar una instancia de GitLab con Devin, incluida tanto la configuración de Admin como la configuración del usuario final. La integración tiene dos partes:
  1. Configuración de Admin
    • Conectar la instancia de GitLab autohospedada de la organización con Devin
    • Configurar una cuenta de servicio
    • Configurar el acceso al repositorio
    • Registrar OAuth para que los usuarios puedan vincular sus identidades personales de GitLab
  2. Configuración del usuario
    • Vincular la cuenta de GitLab de un usuario con su cuenta de Devin
La configuración de Admin debe completarse antes de que cualquier usuario pueda vincular su cuenta de GitLab. Solo los Enterprise Admins pueden realizar los pasos de configuración de Admin.

​
Parte 1: Configuración de Admin

​
Paso 1: Crear una cuenta de servicio en GitLab

En GitLab:
  1. Ve al grupo correcto de GitLab
  2. Ve a Settings
  3. Abre Service Accounts
  4. Crea una nueva cuenta de servicio
Devin usará esta cuenta de servicio para acceder a los repositorios de GitLab.
Crear cuenta de servicio en GitLab

​
Paso 2: Agregar la cuenta de servicio como miembro del grupo

Siguiendo en GitLab:
  1. Ve a la página de Miembros del grupo
Página de miembros del grupo de GitLab
  1. Agrega la cuenta de servicio como miembro del grupo
  2. Asígnale el rol Developer
Esto es necesario para que la cuenta de servicio pueda acceder a los repositorios correctamente.

​
Paso 3: Genera un token de acceso personal para la cuenta de servicio

Después de crear la cuenta de servicio:
  1. Ubica la cuenta de servicio que acabas de crear
  2. Haz clic en los tres puntos > Gestionar tokens de acceso > Generar un nuevo token de acceso personal > Selecciona api en los ámbitos de acceso
  3. Copia y guarda ese token en un lugar seguro
Asegúrate de seleccionar el token de la cuenta de servicio, y no tu token de acceso personal que aparece en las preferencias de tu usuario. Debes hacer que Devin actúe como la cuenta de servicio, no como tú. Usarás este token al agregar la conexión de GitLab en Devin.

​
Paso 4: Agrega la conexión de GitLab en Devin

En Devin:
  1. Ve a Settings de Enterprise
  2. Abre Connections
  3. Agrega una conexión
  4. Ingresa:
    • La URL de tu GitLab autohospedado (si corresponde)
Agregar URL de conexión de GitLab
  • El token de acceso personal creado para la cuenta de servicio
Esto crea la conexión de GitLab a nivel de Enterprise.

​
Paso 5: Verificar el acceso a los repositorios

Después de agregar la conexión:
  1. Confirma que la cuenta de servicio tenga acceso a los repositorios que quieres usar
  2. En Devin, si los repositorios no aparecen de inmediato, actualiza manualmente la lista de repositorios
  3. Ve a Repositorios Enterprise
  4. Selecciona la organización correcta
Repositorios Enterprise
  1. Abre Gestionar permisos
  2. Agrega los repositorios relevantes con los permisos de lectura/escritura adecuados
Gestionar permisos de repositorios
Si faltan repositorios, puede deberse a que Devin actualiza la lista de repositorios periódicamente en lugar de hacerlo al instante.

​
Parte 2: Habilitar la vinculación de usuarios en GitLab autohospedado

​
Paso 6: Registrar una aplicación OAuth en la instancia autohospedada de GitLab

Para permitir que los usuarios individuales vinculen su identidad de GitLab con Devin, el administrador debe registrar una aplicación OAuth para la instancia autohospedada de GitLab. En Devin:
  1. Ve al área de conexión de GitLab de Enterprise
  2. Abre Advanced
  3. Ve a la sección de GitLab autohospedado
  4. Inicia el flujo para registrar una aplicación OAuth
Este paso habilita la vinculación de usuarios individuales.
Registrar aplicación OAuth

​
Paso 7: Usa la opción de configuración manual

Durante este proceso, puede haber varias opciones de configuración. Para el flujo manual en la interfaz de usuario, sigue las instrucciones que aparecen a continuación:
  • Usa directamente la interfaz de GitLab para crear la aplicación OAuth
Configuración manual de OAuth

​
Paso 8: Completa el registro de la aplicación OAuth en GitLab

En GitLab, durante la creación de la aplicación OAuth:
  1. Abre la página de registro
  2. Revisa los Settings de la aplicación
  3. Confirma la configuración requerida, como:
    • Confidential (si ya aparece marcado de forma predeterminada)
    • Acceso / ámbito de API
  4. Registra la aplicación
  5. Copia el ID de la aplicación
  6. Copia el Secreto de la aplicación
  7. Vuelve a Devin e introduce esos valores donde se te soliciten
Con esto se completa la configuración del Admin necesaria para la vinculación de la identidad del usuario.

​
Parte 3: Requisito de pertenencia a la organización

​
Paso 9: Asegúrate de que el usuario pertenezca a la organización de Devin correcta

Antes de que un usuario pueda vincular su cuenta de GitLab, debe ser miembro de una organización de Devin con permisos para repositorios de GitLab. En Devin:
  1. Ve a la sección de miembros de la organización
  2. Confirma que el usuario forme parte de una organización de Devin con permisos para repositorios de GitLab
  3. Si no es así, agrégalo primero
Personal Connections solo muestra integraciones de las organizaciones a las que pertenece el usuario. Si un usuario no está en una organización de Devin con permisos para repositorios de GitLab, es posible que la integración de GitLab no aparezca en absoluto.

​
Parte 4: Configuración para usuarios finales

​
Paso 10: Abrir Personal Connections

Como usuario final en Devin:
  1. Ve a Personal Connections
  2. Busca la integración autohospedada de GitLab
Si no aparece, primero verifica la membresía de la organización.
Una vez que aparezca la integración:
  1. Selecciona la conexión autohospedada de GitLab
  2. Completa el proceso de vinculación
  3. Vincula la cuenta de GitLab del usuario con su cuenta de Devin
Después de esto, Devin debería poder actuar en nombre de ese usuario en las operaciones de GitLab.