rosscado/watchtower

Watchtower

镜像概述

Watchtower是一款监控Docker容器的工具，能够自动检测容器基础镜像的更新，并使用新镜像重启容器，无需手动操作。它支持本地及远程Docker主机监控，适配私有仓库认证，可帮助用户轻松维护容器化应用的最新版本。

核心功能

• 自动更新：检测镜像更新并重启容器，保留原启动参数
• 私有仓库支持：通过环境变量或挂载配置文件实现私有镜像仓库认证
• 灵活监控：可指定监控特定容器或所有容器
• 旧镜像清理：更新后自动删除旧镜像，避免存储占用
• 远程主机监控：支持连接远程Docker主机，通过TLS确保安全
• 依赖处理：自动识别容器间链接关系，按正确顺序启停容器

使用场景

• 持续部署场景：推送新镜像后自动更新生产环境容器
• 批量管理：同时监控多个容器的镜像更新
• 远程维护：管理云端或其他服务器上的Docker容器
• 资源优化：自动清理旧镜像释放存储空间

配置说明

基本部署

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

私有仓库配置

bash
docker run -d \
  --name watchtower \
  -v /home/<user>/.docker/config.json:/config.json \
  -v /var/run/docker.sock:/var/run/docker.sock \
  rosscado/watchtower --debug

指定监控容器

bash
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  rosscado/watchtower nginx redis

关键参数

• --interval/-i： polling间隔（秒），默认300秒
• --cleanup：更新后清理旧镜像
• --no-pull：仅监控本地镜像缓存，不拉取远程镜像
• --host/-h：指定Docker主机地址，支持远程TCP端点
• --tlsverify：启用TLS验证远程Docker主机

停止信号配置

通过标签指定容器停止信号：

bash
docker run -d --label=com.centurylinklabs.watchtower.stop-signal=SIGHUP someimage

远程主机监控（TLS安全连接）

bash
docker run -d \
  --name watchtower \
  -e DOCKER_HOST=$DOCKER_HOST \
  -v $DOCKER_CERT_PATH:/etc/ssl/docker \
  rosscado/watchtower --tlsverify

自我更新

若Watchtower监控本地Docker主机（挂载/var/run/docker.sock），则会自动检测自身镜像更新并重启，保持工具本身为最新版本。