Docker-Watchtower(自动更新)

**相关链接**
---
- Watchtower：https://containrrr.dev/watchtower/
  - 参数解释：https://containrrr.dev/watchtower/arguments/
  - 容器标签：https://containrrr.dev/watchtower/container-selection/
- GitHub：https://github.com/containrrr/watchtower
- Docker：https://registry.hub.docker.com/r/containrrr/watchtower
- Shoutrrr(呐喊)：https://containrrr.dev/shoutrrr/
  - 支持的通知方式：https://containrrr.dev/shoutrrr/v0.8/services/overview/
  - GitHub：https://github.com/containrrr/shoutrrr/

## Docker
```bash
# 自动监控并更新
docker run -d --name watchtower -e TZ=Asia/Shanghai -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower [指定容器名称(不指定则所有)]
  docker run -d --name watchtower -e TZ=Asia/Shanghai -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower  # 自动监控并更新容器(所有)
  docker run -d --name watchtower -e TZ=Asia/Shanghai -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower [容器1] [容器2]  # 自动监控并更新容器(指定)

# 一次性更新容器(配合--rm可实现更新后自动删除该容器)
docker run --name watchtower -e TZ=Asia/Shanghai -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --run-once [指定容器名称(不指定则所有)]
  docker run --name watchtower -e TZ=Asia/Shanghai -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --run-once  # 一次性更新容器(所有)
  docker run --name watchtower -e TZ=Asia/Shanghai -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --run-once [容器1] [容器2]  # 一次性更新容器(指定)
```

## docker-compose
虽然 watchtower 自带有轮询，但容器一直运行的，我们可以设置为 立即运行更新尝试并退出 + 宿主机定期启动 来实现定时启动检测完成后自动关闭
```bash
nano docker-compose.yml  # 创建并编辑配置文件
docker-compose up -d  # 部署并运行

docker logs -f watchtower  # 查看更新情况
```
```bash
services:
  watchtower:
    image: containrrr/watchtower  # 使用containrrr/watchtower镜像
    container_name: watchtower  # 指定容器名称
    # command: [容器1] [容器2]  # 指定更新容器(不设定则默认为全部运行中的容器)
    environment:  # 设置环境变量
      TZ: Asia/Shanghai  # 设置时区
      # ########################### 更新设置 ###########################
      WATCHTOWER_CLEANUP: true  # 更新后删除旧镜像
      # WATCHTOWER_RUN_ONCE: true  # 立即对容器名称列表运行一次更新尝试,然后退出(不进行轮询)
      # WATCHTOWER_LABEL_ENABLE: true  # 启用标签过滤(需提前设置标签)
      # WATCHTOWER_DISABLE_CONTAINERS: [容器1] [容器2]  # 排除特定容器,哪怕标签设为更新也会被排除
      # WATCHTOWER_ROLLING_RESTART: true  # 一次重新启动一个容器,而不是一次停止和启动所有容器
      # ==================== 设置轮询时间(二选一) ====================
      # WATCHTOWER_SCHEDULE: 0 0 */7 * *  # 定时任务方式,默认0 0 * * * 表示每天凌晨0点0分
      # WATCHTOWER_POLL_INTERVAL: 86400  # 轮询间隔方式(s),默认86400(s)=24(h)
      # ########################### 设置Shoutrrr通知_新 ###########################
      # WATCHTOWER_NOTIFICATION_REPORT: "true"  # 启用通知
      # WATCHTOWER_NOTIFICATION_URL: smtp://ai773203918@qq.com:xxx@smtp.qq.com:465/?from=ai773203918@qq.com&to=ai773203918@qq.com  # 设置通知
      # WATCHTOWER_NOTIFICATION_TEMPLATE: "{{range .}}{{.Time.Format \"2006-01-02 15:04:05\"}} ({{.Level}}): {{.Message}}{{println}}{{end}}"  # 设置通知模板
      # ########################### 设置邮件通知_旧 ###########################
      # WATCHTOWER_NOTIFICATIONS: email  # 设置通知方式为邮件
      # WATCHTOWER_NOTIFICATION_EMAIL_FROM: ai773203918@qq.com  # 设置发件邮箱
      # WATCHTOWER_NOTIFICATION_EMAIL_TO: ai773203918@qq.com  # 设置收件邮箱
      # WATCHTOWER_NOTIFICATION_EMAIL_SERVER_USER: ai773203918@qq.com  # 邮箱身份验证的用户名
      # WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PASSWORD: xxx  # 邮箱身份验证的授权码
      # WATCHTOWER_NOTIFICATION_EMAIL_SERVER: smtp.qq.com  # 设置邮箱服务器
      # WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PORT: 465  # 设置邮箱服务器端口
      # WATCHTOWER_NOTIFICATION_EMAIL_SUBJECTTAG: Watchtower_NAS  # 主题标记前缀,多个Watchtower有用
      # WATCHTOWER_NOTIFICATION_EMAIL_SERVER_TLS_SKIP_VERIFY: true  # 设置是否跳过TLS验证
      # WATCHTOWER_NOTIFICATION_EMAIL_DELAY: 2  # 发送通知之前的延迟(s)
      # # ########################### 设置Gotify通知_旧 ###########################
      # WATCHTOWER_NOTIFICATIONS: gotify  # 设置通知方式为Gotify
      # WATCHTOWER_NOTIFICATION_GOTIFY_URL: "https://my.gotify.tld/"  # Gotify服务器地址
      # WATCHTOWER_NOTIFICATION_GOTIFY_TOKEN: "SuperSecretToken"  # Gotify的 apptoken
      # WATCHTOWER_NOTIFICATION_GOTIFY_TLS_SKIP_VERIFY: true  # 跳过TLS验证
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 挂载docker.sock文件
```

## 可选参数
| 参数(docker run) | 环境变量(docker-compose) | 说明 |
| --- | --- | --- |
| [容器名称] | | 默认为全部运行中容器,添加容器名称设置为仅指定容器更新,多个空格隔开,放在最后 |
| --label-enable | WATCHTOWER_LABEL_ENABLE | 启用标签过滤(需要提前设置标签) |
| -x,--disable-containers | WATCHTOWER_DISABLE_CONTAINERS | 排除特定容器,哪怕标签设为更新也会被排除 |
| --cleanup | WATCHTOWER_CLEANUP | 更新后删除旧映像 |
| -i,--interval | WATCHTOWER_POLL_INTERVAL | 轮询间隔(s),默认86400(s)=24(h),和`--schedule`二选一 |
| -s,--schedule "0 0 4 \* \* \*" | WATCHTOWER_SCHEDULE | 6 个字段中的 [cron 表达式](https://pkg.go.dev/github.com/robfig/cron@v1.2.0?tab=doc#hdr-CRON_Expression_Format),和`--interval`二选一 |
| -R,--run-once | WATCHTOWER_RUN_ONCE | 立即对容器名称列表运行一次更新尝试,然后退出 |
| --include-restarting | WATCHTOWER_INCLUDE_RESTARTING | 包括重新启动容器 |
| --include-stopped | WATCHTOWER_INCLUDE_STOPPED | 包括创建和退出的容器 |
| --revive-stopped | WATCHTOWER_REVIVE_STOPPED | 启动已更新映像的停止容器,配合`--include-stopped`使用 |
| --no-restart | WATCHTOWER_NO_RESTART | 更新后不要启动容器 |
| --remove-volumes | WATCHTOWER_REMOVE_VOLUMES | 更新后删除匿名卷,命名卷不会删除 |
| --rolling-restart | WATCHTOWER_ROLLING_RESTART | 一次重新启动一个映像,而不是一次停止和启动所有映像 |
| -H,--host | DOCKER_HOST | 连接Docker守护程序套接字,默认为unix:///var/run/docker.sock,可以指定 tcp://hostname:port 来连接远程Docker守护程序 |
| --no-pull | WATCHTOWER_NO_PULL | 不要拉取新映像,主要监控本地镜像更改(本地构建镜像) |
| -d,--debug | WATCHTOWER_DEBUG | 详细日志记录启用调试模式 |

## 容器标签
添加标签后,watchtower可以根据标签进行监听和更新操作
```bash
# docker run 时添加标签(部署容器时进行添加)
--label=com.centurylinklabs.watchtower.enable=false  # 排除容器
--label=com.centurylinklabs.watchtower.enable=true  # 监听并更新容器
--label=com.centurylinklabs.watchtower.monitor-only=true  # 监听容器但不更新

# docker-compose 中添加标签
labels:  # 在部署的容器中添加
  - "com.centurylinklabs.watchtower.enable=false"  # 排除容器
  - "com.centurylinklabs.watchtower.enable=true"  # 监听并更新容器
  - "com.centurylinklabs.watchtower.monitor-only=true"  # 监听容器但不更新

# Dockerfile 中添加标签(构建镜像时进行添加)
LABEL com.centurylinklabs.watchtower.enable="false"  # 排除容器
LABEL com.centurylinklabs.watchtower.enable="true"  # 监听并更新容器
LABEL com.centurylinklabs.watchtower.monitor-only="true"  # 监听容器但不更新
```

**相关教程**
[使用Watchtower自动更新Docker镜像与容器](https://mp.weixin.qq.com/s/g23UM0P5BDnd0wfIKZpmFg)
[使用Watchtower让Docker容器自动更新](https://baijiahao.baidu.com/s?id=1761926916615570849)
[如何使用 Watchtower 自动更新正在运行的 Docker 容器](https://www.51cto.com/article/716334.html)