suite_logs/docs/DEPLOYMENT.md

Configuración de Despliegue Automático

Este documento explica cómo configurar el despliegue automático desde Gitea a Coolify.

Pasos de Configuración

1. En Gitea

1. Ve a tu repositorio en Gitea
2. Habilita Gitea Actions si no está habilitado
3. Configura los siguientes secrets en Settings → Secrets:
   • COOLIFY_TOKEN: Token de API de Coolify
   • COOLIFY_WEBHOOK_URL: URL del webhook de Coolify
   • COOLIFY_DEPLOYMENT_UUID: UUID del deployment en Coolify

2. En Coolify

1. Crear nuevo proyecto:

   • Nombre: suite-logs
   • Tipo: Docker Compose
   • Repositorio: URL de tu repositorio en Gitea

2. Configurar Source:

   • Branch: master (o main)
   • Auto Deploy: Habilitado
   • Dockerfile/Compose path: docker-compose.yml

3. Variables de entorno:

   COMPOSE_PROJECT_NAME=suite-logs
   

4. Configurar dominios/puertos:

   • Grafana: puerto 3500
   • Prometheus: puerto 9090
   • Loki: puerto 3100
   • Tempo: puerto 3200
   • Alloy: puerto 12345

5. Obtener webhook URL:

   • Ve a la configuración del proyecto
   • Copia la URL del webhook
   • Úsala como COOLIFY_WEBHOOK_URL en Gitea

3. Configuración de Red

Asegúrate de que Coolify tenga acceso a:

• Puerto 3500 (Grafana)
• Puerto 9090 (Prometheus)
• Puerto 3100 (Loki)
• Puerto 3200 (Tempo)
• Puerto 12345 (Alloy)

4. Monitoreo de Despliegues

El pipeline de Gitea Actions:

• Se ejecuta automáticamente en push a master/main
• Envía webhook a Coolify para iniciar despliegue
• Reporta estado del despliegue

Troubleshooting

Pipeline falla

1. Verifica que los secrets estén configurados correctamente
2. Revisa logs en Gitea Actions
3. Verifica conectividad entre Gitea y Coolify

Despliegue falla en Coolify

1. Revisa logs en Coolify dashboard
2. Verifica que docker-compose.yml sea válido
3. Asegúrate de que los volúmenes tengan permisos correctos

Servicios no se conectan

1. Verifica configuración de red en docker-compose.yml
2. Revisa logs de cada servicio
3. Verifica que los archivos de configuración existan

Comandos Útiles

# Verificar estado local
docker-compose ps

# Ver logs de todos los servicios
docker-compose logs -f

# Reiniciar servicios específicos
docker-compose restart grafana

# Limpiar y reiniciar todo
docker-compose down && docker-compose up -d

URLs de Acceso Post-Despliegue

Una vez desplegado en Coolify:

• Grafana: https://tu-dominio.com/grafana (o puerto configurado)
• Prometheus: https://tu-dominio.com/prometheus
• Loki: https://tu-dominio.com/loki
• Tempo: https://tu-dominio.com/tempo
• Alloy: https://tu-dominio.com/alloy

Secrets Necesarios en Gitea

# En Settings → Secrets de tu repositorio
COOLIFY_TOKEN: "tu_token_de_coolify_api"
COOLIFY_WEBHOOK_URL: "https://coolify.tudominio.com/webhooks/deploy/uuid"
COOLIFY_DEPLOYMENT_UUID: "uuid-de-tu-deployment"