Integración Git¶
Vincula repositorios Git a tus proyectos para sincronizar código y automatizar workflows.
¿Para qué sirve?¶
La integración Git permite:
- Sincronizar agentes y procedimientos desde repos
- Ejecutar tareas cuando hay cambios en el código
- Mantener versionado de configuraciones
- Backup automático a repositorios
Proveedores soportados¶
| Proveedor | Estado |
|---|---|
| GitHub | ✅ Soportado |
| GitLab | ✅ Soportado |
| Azure DevOps | ✅ Soportado |
| Bitbucket | ✅ Soportado |
| Git genérico | ✅ Soportado |
Vincular repositorio¶
1. Acceder¶
- Abre el proyecto
- Ve a la pestaña Git
- Haz clic en + Vincular repositorio
2. Configurar conexión¶
┌─────────────────────────────────────────────────────────────────┐
│ Vincular Repositorio │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Proveedor │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ GitHub ▼ │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ URL del repositorio * │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ https://github.com/org/repo.git │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ Rama por defecto │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ main │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ Autenticación │
│ ○ Token personal │
│ ○ SSH Key │
│ ○ OAuth (GitHub/GitLab) │
│ │
│ Token * │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ •••••••••••••••••••• │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ [Cancelar] [Probar] [Guardar]│
└─────────────────────────────────────────────────────────────────┘
3. Probar conexión¶
Antes de guardar, haz clic en Probar para verificar:
- Acceso al repositorio
- Permisos correctos
- Rama existe
Sincronización¶
Configurar qué sincronizar¶
┌─────────────────────────────────────────────────────────────────┐
│ Configuración de sincronización │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ☑️ Sincronizar agentes desde /docs/.ai/agents/ │
│ ☑️ Sincronizar procedimientos desde /docs/.ai/procedures/ │
│ ☑️ Sincronizar skills desde /docs/.ai/skills/ │
│ ☐ Sincronizar tareas desde /docs/.ai/tasks/ │
│ │
│ Dirección: │
│ ○ Solo importar (repo → Nexus) │
│ ○ Solo exportar (Nexus → repo) │
│ ● Bidireccional │
│ │
│ Frecuencia de sincronización: │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ Cada 15 minutos ▼ │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Sincronización manual¶
Para sincronizar inmediatamente:
- Ve a Git en el proyecto
- Haz clic en Sincronizar ahora
- Espera a que complete
Estructura de carpetas¶
El repositorio debe tener esta estructura para sincronización:
repositorio/
├── docs/
│ └── .ai/
│ ├── agents/
│ │ ├── agent-1.md
│ │ └── agent-2.md
│ ├── procedures/
│ │ ├── procedure-1.md
│ │ └── procedure-2.md
│ └── skills/
│ ├── skill-1.md
│ └── skill-2.md
└── ...
Webhooks¶
Configura webhooks para sincronización automática:
GitHub¶
- En GitHub, ve a Settings > Webhooks
- Añade webhook con URL de Nexus
- Selecciona eventos:
push - Guarda
GitLab¶
- En GitLab, ve a Settings > Webhooks
- Configura URL y eventos
- Añade el webhook
Historial de sincronización¶
┌─────────────────────────────────────────────────────────────────┐
│ Historial de sincronización │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Fecha │ Dirección │ Cambios │ Estado │
├────────────────────┼───────────┼────────────────┼───────────────┤
│ 2024-01-15 10:30 │ Importar │ 3 agentes │ ✅ Éxito │
│ 2024-01-15 09:15 │ Exportar │ 1 procedim. │ ✅ Éxito │
│ 2024-01-14 18:00 │ Importar │ 0 cambios │ ✅ Sin cambios│
│ 2024-01-14 15:30 │ Importar │ Error │ ❌ Fallo │
│ │
└─────────────────────────────────────────────────────────────────┘
Resolución de conflictos¶
Si hay conflictos entre Nexus y el repositorio:
- Nexus detecta el conflicto
- Muestra las diferencias
- Elige qué versión mantener:
- Versión local (Nexus)
- Versión remota (Git)
- Combinar manualmente
Desvincular repositorio¶
- Ve a Git en el proyecto
- En el repositorio, haz clic en Desvincular
- Confirma la acción
Nota
Desvincular no elimina los datos ya sincronizados en Nexus.
Siguiente: Plantillas - Crear proyectos desde plantillas.