v2tec/watchtower

v2tec/watchtower 镜像说明

镜像概述

Watchtower是一款Docker容器工具，用于监控运行中的容器，当容器的基础镜像更新时，自动拉取新镜像并重启容器，确保容器始终使用最新版本。支持从Docker Hub或私有镜像仓库拉取镜像，同时提供灵活的配置选项和通知机制。

核心功能

• 自动检测容器镜像更新并重启容器
• 支持私有镜像仓库认证（通过环境变量或挂载配置文件）
• 选择性监控指定容器或带特定标签的容器
• 处理关联容器的停止/启动顺序，避免依赖关系断裂
• 自定义容器停止信号，适配不同应用需求
• 清理旧镜像，防止磁盘空间占用
• 支持远程Docker主机监控
• 提供邮件、Slack等通知方式
• 支持自我更新（监控本地Docker daemon时）

使用场景

1. 微服务环境中自动更新服务容器，保持版本最新
2. 私有部署环境中，无需手动操作即可更新容器
3. 监控远程Docker主机上的容器状态
4. 需要及时收到容器更新通知的场景

配置说明

基础部署

运行Watchtower监控所有本地容器：

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

私有镜像仓库配置

通过挂载Docker配置文件访问私有仓库：

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

Docker Compose示例

监控私有仓库中的容器，每30秒检查一次：

yaml
version: "3"
services:
  app:
    image: index.docker.io/<org>/<image>:<tag>
    ports:
      - "443:3443"
      - "80:3080"
  watchtower:
    image: v2tec/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /root/.docker/config.json:/config.json
    command: --interval 30

关键参数说明

• --interval, -i：检查镜像更新的间隔时间（秒），默认300秒
• --schedule, -s：Cron表达式（6字段），指定检查时间（与interval二选一）
• --label-enable：仅监控带有com.centurylinklabs.watchtower.enable=true标签的容器
• --cleanup：更新后清理旧镜像
• --debug：启用调试模式
• --host, -h：指定远程Docker主机地址（如tcp://10.0.1.2:2375）

通知配置

邮件通知

bash
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e WATCHTOWER_NOTIFICATIONS=email \
  -e WATCHTOWER_NOTIFICATION_EMAIL_FROM=from@example.com \
  -e WATCHTOWER_NOTIFICATION_EMAIL_TO=to@example.com \
  -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER=smtp.example.com \
  -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER_USER=user@example.com \
  -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PASSWORD=your_password \
  v2tec/watchtower

Slack通知

bash
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e WATCHTOWER_NOTIFICATIONS=slack \
  -e WATCHTOWER_NOTIFICATION_SLACK_HOOK_URL="[***]" \
  -e WATCHTOWER_NOTIFICATION_SLACK_IDENTIFIER=watchtower-server \
  v2tec/watchtower