freenas/watchtower

Watchtower

镜像概述

Watchtower是一款监控Docker容器的工具，能够自动检测容器基础镜像的更新，并使用新镜像重启容器。只需将新镜像推送到Docker Hub或私有镜像仓库，Watchtower就会拉取新镜像，优雅关闭现有容器，并用初始部署时的相同配置重启容器，简化容器化应用的更新流程。

核心功能

• 自动监控容器基础镜像变化，触发容器重启
• 支持监控所有容器或指定容器
• 可通过轮询间隔（默认5分钟）或Cron表达式设置检查频率
• 清理更新后的旧镜像，避免系统镜像堆积
• 智能处理关联容器的启停顺序，保证依赖关系正常
• 支持自定义容器停止信号
• 可自动更新自身（需挂载宿主机Docker socket）

使用场景

• 持续部署场景：推送新镜像后自动更新应用
• 减少手动操作：无需手动停止、拉取镜像、重启容器
• 管理关联容器：确保多容器应用更新时依赖顺序正确
• 保持工具自身更新：Watchtower可自动升级到最新版本

配置说明

参数选项

启动Watchtower时可通过以下参数自定义行为：

• --host, -h：Docker守护进程连接地址，默认unix:///var/run/docker.sock，支持远程TCP地址（如tcp://hostname:port），也可通过DOCKER_HOST环境变量设置
• --interval, -i：轮询间隔（秒），默认300秒（5分钟）
• --schedule, -s：Cron表达式，定义检查频率（与--interval二选一）
• --no-pull：不拉取新镜像，仅监控本地镜像缓存
• --cleanup：更新后删除旧镜像
• --tlsverify：使用TLS连接Docker并验证证书
• --debug：启用调试模式，输出详细日志
• --help：显示帮助信息

部署示例

监控所有容器

bash
docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock freenas/watchtower

监控指定容器（如wetty）

bash
docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock freenas/watchtower wetty

设置轮询间隔为10分钟

bash
docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock freenas/watchtower --interval 600

使用Cron表达式（每天凌晨2点检查）

bash
docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock freenas/watchtower --schedule "0 0 2 * * ?"

启用清理旧镜像功能

bash
docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock freenas/watchtower --cleanup

关联容器处理

Watchtower会检测容器间的链接关系，确保启停顺序正确。例如，若WordPress容器链接到MySQL容器，当MySQL镜像更新时，Watchtower会先停止WordPress，再停止MySQL，重启时先启动MySQL，再启动WordPress，保证依赖正常。

容器停止信号

默认使用SIGTERM信号停止容器，若需自定义，可给容器添加标签com.centurylinklabs.watchtower.stop-signal，值为目标信号（如SIGKILL）。

自动更新自身

若Watchtower挂载了宿主机的/var/run/docker.sock，则会监控自身镜像更新，当新镜像推送后自动重启升级。