Integración con GitHub Enterprise Server

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

1. GitHub App (recomendada) — Registra e instala una GitHub App dedicada en tu instancia de GHES o GHEC. Esto proporciona una experiencia de configuración más ágil y no requiere gestionar tokens de acceso personal.
2. Token de acceso personal (PAT) — Crea una cuenta de servicio y genera un token de acceso personal con permisos granulares. Este método funciona con todas las versiones de GHES.

1. Registro de la App — Registra una GitHub App en tu instancia de GHES o GHEC. Solo necesitas un registro de App por instancia.
2. Configuración de la App — Configura la App registrada en tu instancia de GHES o GHEC (p. ej., hazla pública y desactiva el vencimiento del token).
3. Instalación de la App — Instala la App registrada en cada organización de GitHub a la que quieras dar acceso a Devin. Necesitas una instalación por organización.

• Un usuario de Devin con Gestionar permisos de Git
• Acceso como propietario o administrador a la organización de GitHub donde se registrará la aplicación

1. En tu cuenta de Devin, ve a Settings de Enterprise → Integraciones → GitHub.
2. Despliega la sección Advanced para ver las opciones de GitHub Enterprise.

3. Haz clic en Register App.
4. En el modal que aparece, introduce el hostname de tu instancia de GHES o GHEC y la organización donde se registrará la GitHub App.

5. Se te redirigirá a GitHub. Haz clic en Register App para completar el registro.

6. Cuando vuelvas a Devin, la GitHub App ya estará registrada en tu organización de GitHub.

1. En tu instancia de GHES o GHEC, ve a la organización de GitHub especificada durante el registro.
2. Ve a Settings → Developer Settings → GitHub Apps y selecciona la app de Devin.

3. En la sección Advanced, dentro de Danger zone, haz clic en Make public. Esto permite instalar la app en otras organizaciones de la misma instancia.
4. Ve a la sección Optional features y desactiva User-to-server token expiration. Esto evita que los tokens de acceso caduquen y que los usuarios tengan que volver a autorizar la app periódicamente.

1. En tu cuenta de Devin, ve a Settings de Enterprise → Integraciones → GitHub.
2. Expande la sección Avanzado y haz clic en Instalar app.
3. En el modal, selecciona la GitHub App registrada en tu instancia de GHES o GHEC.

4. Se te redirigirá a GitHub, donde podrás elegir una organización de GitHub y seleccionar a qué repositorios dar acceso a Devin. Recomendamos dar acceso a todos los repositorios.
5. Después de completar la instalación, se te redirigirá de vuelta a Devin. Aparecerá una nueva conexión de Git en Settings → Integraciones → GitHub.

1. En tu instancia de GitHub Enterprise, crea una nueva cuenta de GitHub para que la utilice Devin. Esto es importante para garantizar que se pueda hacer un seguimiento y una gestión adecuados de todo el acceso y uso que haga Devin.
2. Agrega la cuenta de servicio recién creada a todas las organizaciones de GitHub pertinentes como Member (Miembro). Verifica que la cuenta tenga acceso a todos los repositorios a los que se espera que Devin acceda.

1. Con la sesión iniciada en la cuenta de servicio, haz clic en la foto de perfil en la esquina superior derecha y luego haz clic en Settings.
2. En la barra lateral izquierda, haz clic en Developer settings.
3. En la barra lateral izquierda, bajo Personal access tokens, haz clic en Fine-grained tokens.
4. Haz clic en Generate new token.
5. Añade el Token name y la Expiration.
   Nota: Cuando el token caduque, Devin perderá inmediatamente todo acceso a GitHub y será necesario crear un token nuevo.
6. En Resource owner, selecciona la organización correcta.

7. En Repository access, selecciona con qué repositorios quieres que trabaje Devin. Los tokens siempre incluyen acceso de solo lectura a todos los repositorios públicos en GitHub.
8. Asegúrate de que el token tenga los siguientes permisos, que son necesarios para que Devin funcione correctamente:

9. Haz clic en Generate Token y guarda el token que se muestre.
   Nota: Es posible que se necesite aprobación de un administrador, según tu configuración de GitHub.
10. Para validar que el token tiene todo el acceso y los permisos necesarios, crea y haz push de una rama de prueba desde tu máquina local a un repositorio de la organización.
11. Una vez que el token se haya generado y probado, ponte en contacto con tu punto de contacto en Cognition para terminar el proceso de configuración. Si actualmente no estás trabajando directamente con nuestro equipo, escribe a enterprise@cognition.ai.

# Autenticar con gh CLI usando tu token
export GH_TOKEN=your_personal_access_token
export GH_HOST=your-github-enterprise-server.com

# Clonar el repositorio
gh repo clone your-organization/your-repository
cd your-repository

# Crear una rama de prueba
git checkout -b test-devin-token-$(date +%s)

# Realizar un pequeño cambio
echo "# Test" >> TEST.md
git add TEST.md
git commit -m "Test: Validate Devin token permissions"

# Subir la rama (prueba el permiso de escritura de contenidos)
git push origin HEAD

# Crear una solicitud de extracción (prueba el permiso de escritura de solicitudes de extracción)
gh pr create --title "Test: Validate Devin token permissions" \
  --body "This is a test PR to validate token permissions." \
  --base main

# Limpiar: cerrar la solicitud de extracción de prueba y eliminar la rama de prueba
gh pr close pr-number --delete-branch

• Recomendamos habilitar protecciones de ramas en master para asegurarte de que se ejecuten las comprobaciones antes de que Devin pueda fusionar cualquier cambio.
• Si Devin está conectado a la cuenta de GitHub de tu organización, tendrá los mismos permisos que cualquier usuario con acceso tanto a la organización de GitHub como a la de Devin.
• Devin no reflejará los permisos del usuario que esté ejecutando una sesión con Devin; conservará los permisos concedidos a nivel de organización.
• Devin no puede crear nuevos repositorios en tu cuenta de GitHub.