# 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:**
   ```env
   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

```bash
# 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

```yaml
# 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"
```