jauderho/watchtower

watchtower 镜像文档

镜像概述

watchtower是一个自动化Docker容器基础镜像更新工具，能够监控运行中的容器，当检测到基础镜像有更新时，自动拉取新镜像、停止旧容器并使用新镜像重启，确保容器始终运行在最新版本。

核心功能与特性

• 自动化更新：自动检测容器基础镜像更新并执行更新操作
• 多平台支持：提供最新的多平台镜像，适配不同架构环境
• 定时构建：上游版本发布后1小时内构建新镜像，且至少每周重建一次，确保镜像时效性
• 轻量级设计：资源占用低，不影响主机正常运行

使用场景与适用范围

• 生产环境中需要保持容器安全补丁更新的场景
• 开发环境中快速获取依赖镜像更新的场景
• 管理多个Docker容器以减少手动更新工作量的场景
• 需要自动化运维流程以提高容器管理效率的场景

使用方法与配置说明

基本使用

启动watchtower容器需挂载Docker守护进程socket文件，以实现与Docker引擎的通信：

bash
docker run --rm -it -v /var/run/docker.sock:/var/run/docker.sock jauderho/watchtower:latest

常用配置参数

环境变量

命令行参数

• --interval：检查间隔（秒），如--interval 3600表示每小时检查
• --cleanup：清理旧镜像，等同于WATCHTOWER_CLEANUP=true
• --debug：启用调试模式，输出详细日志

部署示例

定时检查并清理旧镜像

bash
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e WATCHTOWER_SCHEDULE="0 0 * * *" \
  -e WATCHTOWER_CLEANUP=true \
  jauderho/watchtower:latest

docker-compose配置

yaml
version: '3'
services:
  watchtower:
    image: jauderho/watchtower:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - WATCHTOWER_SCHEDULE=0 0 * * *
      - WATCHTOWER_CLEANUP=true
    restart: always

镜像信息

• 构建状态：https://github.com/jauderho/dockerfiles/workflows/watchtower/badge.svg](https://github.com/jauderho/dockerfiles/actions)
• 最新版本：
• 拉取次数：
• 镜像大小：