Wiki: actualizar a flags, horario 03:30 y etiquetas correctas

2025-11-30 12:08:20 +01:00
parent a4b7ccf6f4
commit a43a848bb9
2 changed files with 43 additions and 20 deletions

@@ -1,26 +1,48 @@
# Configuración de Watchtower
## Variables de entorno
- `WATCHTOWER_SCHEDULE`: cron (UTC). Ejemplo diario 03:00: `0 0 3 * * *`
- `WATCHTOWER_CLEANUP`: elimina imágenes antiguas (`true` recomendado)
- `WATCHTOWER_INCLUDE_STOPPED`: incluir contenedores detenidos
- `WATCHTOWER_TIMEOUT`: segundos por parada/arranque
## Enfoque con flags (recomendado)
En el compose actual se usan flags en `command` por claridad:
```yaml
command:
- --label-enable # Solo contenedores con label enable=true
- --cleanup # Elimina imágenes antiguas tras actualizar
- --schedule=0 30 3 * * * # Diario a las 03:30 (TZ del contenedor)
- --stop-timeout=30s # Tiempo de gracia al parar servicios
```
## Compose de referencia
## Variables de entorno (alternativa)
Equivalentes si prefieres usar environment:
- `WATCHTOWER_LABEL_ENABLE=true`
- `WATCHTOWER_CLEANUP=true`
- `WATCHTOWER_SCHEDULE=0 30 3 * * *`
- `WATCHTOWER_TIMEOUT=30s`
Ejemplo:
```yaml
environment:
- TZ=Europe/Madrid
- WATCHTOWER_LABEL_ENABLE=true
- WATCHTOWER_CLEANUP=true
- WATCHTOWER_SCHEDULE=0 30 3 * * *
- WATCHTOWER_TIMEOUT=30s
```
## Compose de referencia (flags)
```yaml
services:
watchtower:
image: containrrr/watchtower:latest
container_name: watchtower
restart: always
restart: unless-stopped
environment:
- TZ=Europe/Madrid
- WATCHTOWER_CLEANUP=true
- WATCHTOWER_INCLUDE_STOPPED=false
- WATCHTOWER_SCHEDULE=0 0 3 * * *
volumes:
- /var/run/docker.sock:/var/run/docker.sock
command: --label-enable
- /var/run/docker.sock:/var/run/docker.sock:ro
command:
- --label-enable
- --cleanup
- --schedule=0 30 3 * * *
- --stop-timeout=30s
```
## Etiquetado de servicios
@@ -28,29 +50,30 @@ services:
labels:
- "com.centurylinklabs.watchtower.enable=true"
```
Solo los servicios etiquetados se actualizarán (con `--label-enable`).
Solo los servicios con `com.centurylinklabs.watchtower.enable=true` se actualizarán.
## Buenas prácticas
- Programa en horas de baja actividad
- Programa en horas de baja actividad (madrugada)
- Mantén backups en servicios con estado
- Revisa logs tras actualizaciones
- Excluye servicios críticos si prefieres actualizarlos manualmente (`enable=false`)
---
Última actualización: Nov 2025
Última actualización: Nov 2025 (horario 03:30 y 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
- Programa ventanas con WATCHTOWER_SCHEDULE

@@ -25,4 +25,4 @@ labels:
- [Troubleshooting](Troubleshooting.md)
---
Última actualización: Nov 2025
Última actualización: Nov 2025 (flags y horario 03:30)