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 # Configuración de Watchtower
## Variables de entorno ## Enfoque con flags (recomendado)
- `WATCHTOWER_SCHEDULE`: cron (UTC). Ejemplo diario 03:00: `0 0 3 * * *` En el compose actual se usan flags en `command` por claridad:
- `WATCHTOWER_CLEANUP`: elimina imágenes antiguas (`true` recomendado) ```yaml
- `WATCHTOWER_INCLUDE_STOPPED`: incluir contenedores detenidos command:
- `WATCHTOWER_TIMEOUT`: segundos por parada/arranque - --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 ```yaml
services: services:
watchtower: watchtower:
image: containrrr/watchtower:latest image: containrrr/watchtower:latest
container_name: watchtower container_name: watchtower
restart: always restart: unless-stopped
environment: environment:
- TZ=Europe/Madrid - TZ=Europe/Madrid
- WATCHTOWER_CLEANUP=true
- WATCHTOWER_INCLUDE_STOPPED=false
- WATCHTOWER_SCHEDULE=0 0 3 * * *
volumes: volumes:
- /var/run/docker.sock:/var/run/docker.sock - /var/run/docker.sock:/var/run/docker.sock:ro
command: --label-enable command:
- --label-enable
- --cleanup
- --schedule=0 30 3 * * *
- --stop-timeout=30s
``` ```
## Etiquetado de servicios ## Etiquetado de servicios
@@ -28,29 +50,30 @@ services:
labels: labels:
- "com.centurylinklabs.watchtower.enable=true" - "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 ## Buenas prácticas
- Programa en horas de baja actividad - Programa en horas de baja actividad (madrugada)
- Mantén backups en servicios con estado - Mantén backups en servicios con estado
- Revisa logs tras actualizaciones - 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 ## Ejemplos de etiquetas
### Portainer (actualizable) ### Portainer (actualizable)
`yaml ```yaml
labels: labels:
- "com.centurylinklabs.watchtower.enable=true" - "com.centurylinklabs.watchtower.enable=true"
` ```
### NGINX Proxy Manager (excluir) ### NGINX Proxy Manager (excluir)
`yaml ```yaml
labels: labels:
- "com.centurylinklabs.watchtower.enable=false" - "com.centurylinklabs.watchtower.enable=false"
` ```
### Servicios críticos ### Servicios críticos
- Programa ventanas con WATCHTOWER_SCHEDULE - Programa ventanas con WATCHTOWER_SCHEDULE

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