Monitoreo de actualizaciones de imágenes
Monitorea registros de imágenes de contenedores en segundo plano y recibe notificaciones cuando hay una nueva versión disponible.
Los monitoreos de actualización de imágenes permiten que Dockerman sondee registros en segundo plano y envíe una notificación cuando hay una nueva versión de imagen disponible. Por defecto solo notifica y nunca activa una actualización automática, por lo que tú mantienes el control.
Cómo funciona
- Te suscribes a las imágenes que te importan (por host, por referencia de imagen).
- El programador en segundo plano ejecuta la tarea
image_upgrade_checken un intervalo configurable (por defecto: cada 6 horas). - Para cada imagen suscrita, Dockerman resuelve una credencial de registro a través del resolutor de credenciales y luego compara el digest local con el digest del registro remoto. Las credenciales ambiguas fallan de forma cerrada — la verificación da error en lugar de adivinar.
- Cuando se encuentran nuevos digests, Dockerman envía una única notificación agrupada a través de tus canales de notificación configurados y escribe un cursor de historial para que la próxima ejecución continúe donde esta lo dejó.
Suscribirse a una imagen
Abre el menú de acciones del contenedor (el mismo dropdown que tiene Verificar actualización y Actualizar) y haz clic en Monitorear actualizaciones.
La suscripción está vinculada al host y referencia de imagen, por lo que sobrevive a reconstrucciones de contenedores.
Abre el menú overflow del stack Compose y haz clic en Monitorear todas las imágenes para actualizaciones. Esto suscribe todas las imágenes del stack de una vez.
Para cancelar la suscripción de imágenes individuales más tarde, usa la página dedicada de monitoreos.
La página de Monitoreo de actualizaciones de imágenes
La página dedicada muestra todas tus suscripciones en un solo lugar.
Barra superior:
- Intervalo de verificación dropdown — establece cada cuánto se ejecuta el programador (escribe directamente en la tarea del programador, por lo que hay una sola fuente de verdad)
- Canales por defecto — elige qué canales de notificación reciben notificaciones de actualización
- Verificar todas ahora — activa una verificación inmediata para todas las suscripciones
Tabla principal:
| Columna | Descripción |
|---|---|
| Imagen | La referencia de imagen (ej. jellyfin/jellyfin:latest) |
| Contenedores | Qué contenedores usan esta imagen en este host |
| Estado | Estado actual de verificación (ver abajo) |
| Última verificación | Cuándo se ejecutó la última verificación y qué encontró |
| Acciones | Eliminar suscripción, activar verificación manual |
Haz clic en una fila para abrir el panel de historial mostrando cada verificación pasada con timestamps, digests y si se envió una notificación.
Estados de estado
| Estado | Significado |
|---|---|
unknown | No se ha ejecutado ninguna verificación aún |
up_to_date | Los digests local y remoto coinciden |
upgrade_available | Se encontró un digest más nuevo en el registro |
watchtower_managed | Todos los contenedores con esta imagen tienen la etiqueta enable=true de Watchtower, por lo que Dockerman delega a Watchtower |
orphaned | Ningún contenedor en ejecución usa esta imagen en este host (ej. el stack fue eliminado) |
error | La verificación falló (registro inalcanzable, error de autenticación, límite de tasa, etc.) |
Mensajes de notificación
Cuando se encuentra una o más actualizaciones en una sola ejecución de verificación, Dockerman envía un solo mensaje agregado:
Título: 3 actualizaciones de imagen disponibles en prod-nas
Cuerpo:
- jellyfin/jellyfin:latest -> a3f2e1 (1 contenedor: jellyfin)
- redis:7-alpine -> 8c91b4 (2 contenedores: cache, sessions)
- grafana/grafana:latest -> 5e44aa (1 contenedor: grafana)
Abrir Dockerman: dockerman://Hacer clic en el enlace profundo abre la ventana principal de Dockerman.
Cooldown de notificaciones
Las notificaciones están basadas en digest: Dockerman registra el último digest sobre el cual te notificó. Solo envía una nueva notificación cuando el digest remoto cambia de nuevo. Una vez que todos tus contenedores se actualizan al digest notificado, el cooldown se reinicia para que la próxima actualización del registro active una notificación fresca.
Coexistencia con Watchtower
Si ya ejecutas Watchtower, Dockerman detecta la etiqueta com.centurylinklabs.watchtower.enable=true en los contenedores y los maneja en consecuencia:
- Todos los contenedores etiquetados: La suscripción muestra estado
watchtower_managedy permanece silenciosa. - Mixto (algunos etiquetados, otros no): Dockerman filtra los contenedores gestionados por Watchtower y solo notifica sobre los restantes.
- Sin etiquetas: Dockerman trata todos los contenedores normalmente.
Dockerman solo reconoce la etiqueta explícita enable=true. Si tu Watchtower se ejecuta en modo por defecto (monitorea todo sin etiquetas), Dockerman no lo detecta. En ese caso puedes recibir notificaciones duplicadas de ambas herramientas.
Límites de tasa de registro
Dockerman deduplica verificaciones por referencia de imagen dentro de una sola ejecución, por lo que la misma imagen solo se consulta una vez independientemente de cuántos contenedores la usen. Cuando un registro devuelve un header Retry-After, Dockerman lo respeta. Sin el header, aplica un backoff por defecto de 15 minutos. Las suscripciones en backoff muestran el estado error con una nota sobre cuándo ocurrirá el próximo reintento.
Cancelar suscripción
Elimina una suscripción desde la página de Monitoreo de actualizaciones de imágenes. Una vez eliminada, no se envían más verificaciones ni notificaciones para esa imagen en ese host.
Consejos
- Comienza suscribiéndote a las 3-5 imágenes que más te importan (ej. tu servidor de medios, base de datos, proxy inverso).
- Mantén el intervalo por defecto de 6 horas a menos que tengas una razón específica para sondear más frecuentemente. Intervalos más cortos aumentan el uso de la API del registro.
- Usa el botón Verificar todas ahora después de agregar nuevas suscripciones para obtener un estado inmediato sin esperar la próxima ejecución programada.
- La notificación de actualización te dice que existe una nueva versión. Para actualizar realmente, usa las acciones existentes Verificar actualización y Actualizar en el menú del contenedor.