110 lines
2.9 KiB
Markdown
110 lines
2.9 KiB
Markdown
# 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"
|
|
``` |