webhippie/watchtower Docker 镜像 - 轩辕镜像

watchtower

基于Alpine Linux构建的Watchtower Docker镜像，用于自动监控和更新Docker容器。Watchtower能够定期检查容器镜像的更新，自动拉取新镜像并重启容器，简化容器的维护流程。

版本

可用版本请查看 Docker Hub、Quay 或 GitHub仓库 中的相关文件夹。

卷

• 无

端口

• 无

可用环境变量

console
DOCKER_API_VERSION = 1.24
WATCHTOWER_CLEANUP = false
WATCHTOWER_DEBUG = false
WATCHTOWER_ENABLE_LIFECYCLE_HOOKS = false
WATCHTOWER_HOST = unix:///var/run/docker.sock
WATCHTOWER_HTTP_API_METRICS = false
WATCHTOWER_HTTP_API_PERIODIC_POLLS = false
WATCHTOWER_HTTP_API_TOKEN =
WATCHTOWER_HTTP_API_UPDATE = false
WATCHTOWER_INCLUDE_RESTARTING = false
WATCHTOWER_INCLUDE_STOPPED = false
WATCHTOWER_INTERVAL = 300
WATCHTOWER_LABEL_ENABLE = false
WATCHTOWER_MONITOR_ONLY = false
WATCHTOWER_NO_COLOR = false
WATCHTOWER_NO_PULL = false
WATCHTOWER_NO_RESTART = false
WATCHTOWER_NO_STARTUP_MESSAGE = false
WATCHTOWER_OPTS =
WATCHTOWER_REMOVE_VOLUMES = false
WATCHTOWER_REVIVE_STOPPED = false
WATCHTOWER_ROLLING_RESTART = false
WATCHTOWER_RUN_ONCE = false
WATCHTOWER_SCHEDULE =
WATCHTOWER_SCOPE =
WATCHTOWER_STOP_TIMEOUT =
WATCHTOWER_TLS_VERIFY = false
WATCHTOWER_TRACE = false
WATCHTOWER_WARN_ON_HEAD_FAILURE =

环境变量说明

继承的环境变量

• webhippie/alpine

使用示例

Docker Run 命令

bash
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e WATCHTOWER_INTERVAL=600 \  # 10分钟检查一次
  -e WATCHTOWER_CLEANUP=true \   # 清理旧镜像
  -e WATCHTOWER_LABEL_ENABLE=true \  # 通过标签控制更新
  webhippie/watchtower

Docker Compose 配置

yaml
version: '3'
services:
  watchtower:
    image: webhippie/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - WATCHTOWER_SCHEDULE=0 3 * * *  # 每天凌晨3点检查
      - WATCHTOWER_DEBUG=true
      - WATCHTOWER_NO_RESTART=false  # 更新后重启容器
    restart: unless-stopped

核心功能与特性

• 自动更新：定期检查容器镜像更新，自动拉取并重启容器
• 灵活调度：支持固定间隔或cron表达式定时检查
• 选择性更新：通过标签控制特定容器的更新行为
• 清理功能：可自动清理更新后遗留的旧镜像
• 监控模式：支持仅监控不执行更新的模式
• 生命周期钩子：可选启用容器的生命周期钩子（需配置WATCHTOWER_ENABLE_LIFECYCLE_HOOKS）

使用场景

• 开发环境中自动更新依赖服务
• 小型生产环境中简化容器维护
• 需要定期更新的无状态服务
• 希望减少手动更新操作的场景

贡献

Fork -> Patch -> Push -> Pull Request

作者

• Thomas Boerger

许可证

MIT

版权

console
Copyright (c) 2015 Thomas Boerger <[***]>