Visión General de la Integración Git - Archyl Docs

Conecta tus repositorios Git para habilitar el descubrimiento de arquitectura con IA

Visión General de la Integración Git

Conectar tu repositorio Git a Archyl habilita el descubrimiento de arquitectura con IA, manteniendo tu documentación sincronizada con tu código real.

Proveedores Soportados

Archyl soporta todas las principales plataformas de alojamiento Git:

Proveedores Cloud

Proveedor OAuth Funciones
GitHub Sí Soporte completo
GitLab Sí Soporte completo
Bitbucket Sí Soporte completo

Auto-alojado

Proveedor Método de Auth Funciones
GitHub Enterprise Token Soporte completo
GitLab Auto-gestionado Token Soporte completo
Gitea Token Soporte completo
Azure DevOps Token Soporte completo

Conectando un Repositorio

Paso 1: Navegar a Configuración del Proyecto

  1. Abre tu proyecto
  2. Haz clic en Configuración
  3. Ve a la pestaña "Repositorio"

Paso 2: Elegir Proveedor

  1. Haz clic en "Conectar Repositorio"
  2. Selecciona tu proveedor Git
  3. Autoriza Archyl (para proveedores OAuth)

Paso 3: Seleccionar Repositorio

  1. Navega tus repositorios disponibles
  2. Selecciona el repositorio a conectar
  3. Elige la rama predeterminada
  4. Haz clic en "Conectar"

Autenticación

OAuth (Recomendado)

Para GitHub, GitLab y Bitbucket cloud:

  1. Haz clic en "Conectar con [Proveedor]"
  2. Autoriza Archyl en la ventana emergente
  3. Selecciona repositorios a los que otorgar acceso

Los tokens OAuth se almacenan de forma segura y se refrescan automáticamente.

Tokens de Acceso Personal

Para proveedores auto-alojados o enterprise:

  1. Genera un token en tu proveedor Git
  2. Alcances requeridos: repo (acceso de lectura)
  3. Ingresa el token en Archyl

Acceso al Repositorio

Lo Que Archyl Lee

Durante el Descubrimiento IA, Archyl lee:

  • Estructura y nombres de archivos
  • Contenido de código fuente
  • Archivos de configuración (package.json, go.mod, etc.)
  • Archivos README

Lo Que Archyl Nunca Accede

  • Archivos de entorno (.env)
  • Credenciales o secretos
  • Historial de Git
  • Otras ramas (a menos que se seleccionen explícitamente)

Múltiples Repositorios

Conecta múltiples repositorios a un solo proyecto:

Monorepo

Para monorepos, conecta una vez y especifica rutas:

/services/api
/services/web
/packages/shared

Multi-Repo

Para repositorios separados:

  1. Conecta cada repositorio
  2. Mapea a sistemas o contenedores
  3. El descubrimiento se ejecuta en todos los repos

Webhooks (Próximamente)

Sincronización automática al hacer push:

  • Disparar descubrimiento en cambios de código
  • Actualizar arquitectura automáticamente
  • Mantener documentación actualizada

Solución de Problemas

Autorización Fallida

  • Verifica que tu token tenga permisos requeridos
  • Asegúrate de que la app OAuth esté autorizada
  • Intenta reconectar

Repositorio No Encontrado

  • Verifica que tengas acceso al repositorio
  • Verifica la URL del repositorio
  • Asegúrate de que la rama exista

Errores de Descubrimiento

  • Verifica rutas excluidas
  • Reduce configuración de concurrencia
  • Revisa límites del proveedor IA