beatkind/watchtower

Watchtower

[!NOTE]
这是 https://github.com/containrrr 项目 https://github.com/containrrr/watchtower 的分支版本。
我不是该项目的原作者，仅对其进行了一些修改并尽可能保持更新。
欢迎贡献、建议和提示，只需提交issue或pull request。请注意，我并非专业开发人员，只是一名平台工程师。

镜像概述和主要用途

Watchtower是一款用于自动化Docker容器基础镜像更新的工具。它能够监控容器的基础镜像，当检测到新镜像推送到镜像仓库时，自动拉取新镜像、优雅关闭现有容器，并使用初始部署时的相同配置选项重启容器，从而实现容器应用的无缝更新。

核心功能和特性

• 自动化更新：无需手动干预，自动检测并拉取容器基础镜像的新版本
• 优雅重启：在更新过程中，会先优雅关闭现有容器，确保数据安全和服务平滑过渡
• 配置保留：重启容器时使用初始部署时的所有选项（如端口映射、环境变量、数据卷等），保持部署一致性
• 轻量部署：通过简单的Docker命令即可部署，无需复杂配置

使用场景和适用范围

Watchtower适用于以下场景：

• 家庭实验室环境
• 媒体中心（如Plex、Emby等应用容器）
• 本地开发环境
• 非关键业务的个人或小型项目

注意：不推荐在商业或生产环境中使用Watchtower。对于生产环境，建议采用Kubernetes等容器编排平台；若希望简化Kubernetes使用，可考虑MicroK8s或k3s等轻量级解决方案。

使用方法和配置说明

快速启动

通过以下命令即可部署Watchtower容器，实现对本地Docker环境中容器的自动更新监控：

bash
$ docker run --detach \
    --name watchtower \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    beatkind/watchtower

命令说明：

• --detach：后台运行容器
• --name watchtower：指定容器名称为watchtower
• --volume /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程的Unix套接字，使Watchtower能够与Docker引擎通信

完整文档

完整的使用文档和高级配置说明可访问：<[***]>