ditchitall/watchtower

ditchitall/watchtower 镜像文档

镜像概述

ditchitall/watchtower 是一个用于自动监控和更新Docker容器的工具镜像。它通过与Docker守护进程交互，定期检查容器使用的镜像是否有更新，若存在更新则自动拉取新镜像并重启容器，同时支持清理旧镜像、调试跟踪等功能，适用于需要保持容器镜像最新的场景。

核心功能与特性

• 自动更新容器：定期检查容器镜像的最新版本，自动拉取更新并重启容器
• 旧镜像清理：更新完成后自动清理不再使用的旧版本镜像，节省存储空间
• 调试与跟踪：支持开启调试模式（--debug）和详细跟踪日志（--trace），便于问题排查
• 灵活配置：可通过命令参数自定义检查间隔、镜像源等更新策略

使用场景

• 生产环境中需要自动保持应用容器最新版本的场景
• 开发环境中快速测试最新镜像功能的场景
• 需要定期清理冗余镜像以优化存储资源的场景

使用方法与配置说明

基本部署方式

docker-compose 配置示例

yaml
version: "3"
services:
  watchtower:
    image: ditchitall/watchtower:latest
    restart: unless-stopped  # 除非手动停止，否则始终重启容器
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 挂载Docker守护进程套接字，用于与Docker交互
      - /var/www/prod/.docker/config.json:/config.json  # 挂载Docker配置文件（如镜像仓库认证信息）
    env_file: .env  # 从.env文件加载环境变量
    command: --interval 30 --cleanup --debug --trace  # 自定义命令参数

docker run 命令示例

bash
docker run -d \
  --name watchtower \
  --restart unless-stopped \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/www/prod/.docker/config.json:/config.json \
  --env-file .env \
  ditchitall/watchtower:latest \
  --interval 30 --cleanup --debug --trace

配置参数说明

卷挂载（volumes）

• /var/run/docker.sock:/var/run/docker.sock：必填，挂载Docker守护进程的Unix套接字，使watchtower能够与Docker引擎通信，获取容器和镜像信息
• /var/www/prod/.docker/config.json:/config.json：可选，挂载Docker配置文件，用于包含私有镜像仓库的认证信息（如Docker Hub、私有registry的登录凭证）

环境变量（env_file）

通过.env文件可配置的环境变量（具体支持的变量需参考镜像内部实现，常见包括）：

• WATCHTOWER_REGISTRY_USER：私有镜像仓库用户名
• WATCHTOWER_REGISTRY_PASSWORD：私有镜像仓库密码
• WATCHTOWER_NOTIFICATIONS：通知方式配置（如邮件、Slack等）

命令参数（command）

• --interval 30：设置检查镜像更新的时间间隔，单位为秒（此处为30秒检查一次）
• --cleanup：更新容器后自动删除旧版本镜像
• --debug：开启调试模式，输出更详细的运行日志
• --trace：开启跟踪模式，输出最详细的日志信息（包括HTTP请求等）

其他常用命令参数

• --include-stopped：同时检查已停止的容器
• --exclude：排除指定名称的容器不进行更新
• --rollback：更新失败时回滚到上一版本
• --timeout：设置容器停止和启动的超时时间（单位秒）