README: alinear con compose (flags, schedule 03:30, etiquetado y buenas prácticas)

This commit is contained in:
2025-11-30 12:06:27 +01:00
parent 4629bf255d
commit 103af25a65

View File

@@ -4,9 +4,10 @@
[Watchtower](https://containrrr.dev/watchtower/) monitoriza imágenes y actualiza contenedores automáticamente cuando hay nuevas versiones.
## Características
- Actualiza servicios etiquetados
- Limpieza de imágenes antiguas (`WATCHTOWER_CLEANUP=true`)
- Programación vía cron (`WATCHTOWER_SCHEDULE`)
- Actualiza solo contenedores etiquetados (flag `--label-enable`)
- Limpieza de imágenes antiguas (flag `--cleanup`)
- Programación vía cron con flag `--schedule`
- Tiempo de gracia en parada (`--stop-timeout`)
- Notificaciones (Shoutrrr: Telegram, Slack, Email, etc.)
## Despliegue
@@ -17,23 +18,41 @@ docker compose up -d
```
## Etiquetado de servicios
Para que un servicio se auto-actualice, añade:
Para que un servicio se auto-actualice, añade la label:
```yaml
labels:
- "com.centurylinklabs.watchtower.enable=true"
```
Para excluir explícitamente:
```yaml
labels:
- "com.centurylinklabs.watchtower.enable=false"
```
## Variables de entorno
Edita `.env` o el `docker-compose.yaml`:
- `WATCHTOWER_SCHEDULE`: cron (UTC) p.ej. `0 0 3 * * *` (diario 03:00)
- `WATCHTOWER_CLEANUP`: `true` para borrar imágenes antiguas
- `WATCHTOWER_NOTIFICATIONS` y `WATCHTOWER_NOTIFICATION_URL`: ver Shoutrrr
## Configuración (flags usados)
El `docker-compose.yaml` utiliza flags en lugar de variables de entorno para mayor claridad:
```yaml
command:
- --label-enable # Solo contenedores con label enable=true
- --cleanup # Elimina imágenes antiguas tras actualizar
- --schedule=0 30 3 * * * # Ejecuta cada día a las 03:30 (TZ configurado)
- --stop-timeout=30s # Tiempo de gracia al parar contenedores
```
Si prefieres variables en vez de flags, puedes usar:
```yaml
environment:
- WATCHTOWER_LABEL_ENABLE=true
- WATCHTOWER_CLEANUP=true
- WATCHTOWER_SCHEDULE=0 30 3 * * *
- WATCHTOWER_TIMEOUT=30s
```
## Buenas prácticas
- Etiqueta solo servicios que quieras actualizar
- Usa horarios de baja actividad
- Revisa logs en actualizaciones críticas
- Mantén backups si actualizas servicios de estado
- Usa horarios de baja actividad (madrugada)
- Revisa logs tras cambios de versiones críticas
- Mantén backups si actualizas servicios con datos persistentes
- Excluye servicios que gestionas manualmente (`enable=false`)
## Troubleshooting
```bash
@@ -41,23 +60,23 @@ docker logs watchtower --tail=200
```
---
Última actualización: Nov 2025
Última actualización: Nov 2025 (compose con flags)
## Ejemplos de etiquetas
### Portainer (actualizable)
`yaml
```yaml
labels:
- "com.centurylinklabs.watchtower.enable=true"
`
```
### NGINX Proxy Manager (excluir)
`yaml
```yaml
labels:
- "com.centurylinklabs.watchtower.enable=false"
`
```
### Servicios críticos (incluir solo en ventanas)
- Usa WATCHTOWER_SCHEDULE para horarios de mantenimiento.
- Considera WATCHTOWER_INCLUDE_STOPPED=true si paras antes.
### Servicios críticos (actualizar manualmente)
- Programa ventanas con `--schedule`
- Opcional: parar primero y usar `WATCHTOWER_INCLUDE_STOPPED=true`