1. 簡述

Watchtower 是一個可以實現(xiàn)自動化更新 Docker 基礎鏡像與容器的實用工具。它監(jiān)視正在運行的容器以及相關的鏡像，當檢測到 reg-istry 中的鏡像與本地的鏡像有差異時，它會拉取最新鏡像并使用最初部署時相同的參數(shù)重新啟動相應的容器，

2. 啟動

Watch-tower 本身被打包為 Docker 鏡像，因此可以像運行任何其他容器一樣運行它：

docker run -d \
    --name watchtower \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower

然后所有容器都會自動更新，也包括 Watch-tower 本身。

選項參數(shù)：

$ docker run --rm containrrr/watchtower -h

Watchtower automatically updates running Docker containers whenever a new image is released.
More information available at https://github.com/containrrr/watchtower/.

Usage:
  watchtower [flags]

Flags:
  -a, --api-version string                          api version to use by docker client (default "1.24")
  -c, --cleanup                                     remove previously used images after updating
  -d, --debug                                       enable debug mode with verbose logging
      --enable-lifecycle-hooks                      Enable the execution of commands triggered by pre- and post-update lifecycle hooks
  -h, --help                                        help for watchtower
  -H, --host string                                 daemon socket to connect to (default "unix:///var/run/docker.sock")
  -S, --include-stopped                             Will also include created and exited containers
  -i, --interval int                                poll interval (in seconds) (default 300)
  -e, --label-enable                                watch containers where the com.centurylinklabs.watchtower.enable label is true
  -m, --monitor-only                                Will only monitor for new images, not update the containers
      --no-pull                                     do not pull any new images
      --no-restart                                  do not restart any containers
      --notification-email-delay int                Delay before sending notifications, expressed in seconds
      --notification-email-from string              Address to send notification emails from
      --notification-email-server string            SMTP server to send notification emails through
      --notification-email-server-password string   SMTP server password for sending notifications
      --notification-email-server-port int          SMTP server port to send notification emails through (default 25)
      --notification-email-server-tls-skip-verify
                                                    Controls whether watchtower verifies the SMTP server's certificate chain and host name.
                                                    Should only be used for testing.

      --notification-email-server-user string       SMTP server user for sending notifications
      --notification-email-subjecttag string        Subject prefix tag for notifications via mail
      --notification-email-to string                Address to send notification emails to
      --notification-gotify-token string            The Gotify Application required to query the Gotify API
      --notification-gotify-url string              The Gotify URL to send notifications to
      --notification-msteams-data                   The MSTeams notifier will try to extract log entry fields as MSTeams message facts
      --notification-msteams-hook string            The MSTeams WebHook URL to send notifications to
      --notification-slack-channel string           A string which overrides the webhook's default channel. Example: #my-custom-channel
      --notification-slack-hook-url string          The Slack Hook URL to send notifications to
      --notification-slack-icon-emoji string        An emoji code string to use in place of the default icon
      --notification-slack-icon-url string          An icon image URL string to use in place of the default icon
      --notification-slack-identifier string        A string which will be used to identify the messages coming from this watchtower instance (default "watchtower")
  -n, --notifications strings                        notification types to send (valid: email, slack, msteams, gotify)
      --notifications-level string                  The log level used for sending notifications. Possible values: panic, fatal, error, warn, info or debug (default "info")
      --remove-volumes                              remove attached volumes before updating
      --revive-stopped                              Will also start stopped containers that were updated, if include-stopped is active
  -R, --run-once                                    Run once now and exit
  -s, --schedule string                             the cron expression which defines when to update
  -t, --stop-timeout duration                       timeout before a container is forcefully stopped (default 10s)
  -v, --tlsverify                                   use TLS and verify the remote

3. 使用示例

3.1 自動清除舊鏡像

官方給出的默認啟動命令在長期使用后會堆積非常多的標簽為 none 的舊鏡像，如果放任不管會占用大量的磁盤空間。要避免這種情況可以加入 --cleanup 選項，這樣每次更新都會把舊的鏡像清理掉。

docker run -d \
    --name watchtower \
    --restart unless-stopped \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower -c

3.2 選擇性自動更新

某些容器可能需要穩(wěn)定的運行，經(jīng)常更新或重啟可能會造成一些問題，可以使用一些選項參數(shù)來選擇與控制容器的更新。

1. 容器更新列表

   # 只更新 nginx、redis 這兩個容器，可以把容器名稱追加到啟動命令的最后面
   docker run -d \
       --name watchtower \
       --restart unless-stopped \
       -v /var/run/docker.sock:/var/run/docker.sock \
       containrrr/watchtower -c \
       nginx redis
   
   
   # 建立一個更新列表文件, 通過變量的方式去調(diào)用這個列表：
   $ cat ~/.watchtower.list
   aria2-pro
   unlockmusic
   mtg
   
   $docker run -d \
       --name watchtower \
       --restart unless-stopped \
       -v /var/run/docker.sock:/var/run/docker.sock \
       containrrr/watchtower -c \
       $(cat ~/.watchtower.list)
   
   

2. 設置單個容器自動更新特征

給容器添加 com.centurylinklabs.watchtower.enable 這個 LA-BEL 并設置它的值為 false，或者在啟動命令中加入 --label com.centurylinklabs.watchtower.enable=false 參數(shù)可以排除相應的容器。

# openwrt-mini 鏡像的容器啟動命令，Watch-tower 將永遠忽略它的更新，即使它包含在自動更新列表中
docker run -d \
    --name openwrt-mini \
    --restart always \
    --network openwrt \
    --privileged \
    --label com.centurylinklabs.watchtower.enable=false \
    p3terx/openwrt-mini \
    /sbin/init

#當容器啟動命令中加入 --label com.centurylinklabs.watchtower.enable=true 參數(shù)，
#并且給 Watch-tower 加上 --label-enable 選項時，Watch-tower 將只更新這些包含此參數(shù)的容器
docker run -d \
    --name watchtower \
    --restart unless-stopped \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower -c \
    --label-enable

# 或者 --label-enable 可以簡寫為 -e：
docker run -d \
    --name watchtower \
    --restart unless-stopped \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower -ce

設置 com.centurylinklabs.watchtower.enable=false 參數(shù)后容器將永遠被 Watch-tower 忽略，包括后面將要提到的手動更新方式，所以一般不推薦這樣做，除非你愿意手動重建的原生方式更新

3.3 僅監(jiān)控更新情況，不更新

使用 --monitor-only 將僅監(jiān)控新鏡像并發(fā)送通知，不會更新容器。

4. 設置自動更新檢查頻率

默認情況下 Watch-tower 每 5 分鐘會輪詢一次，可以使用：--interval, -i - 設置更新檢測時間間隔，單位為秒。比如每隔 1 個小時檢查一次更新：

docker run -d \
    --name watchtower \
    --restart unless-stopped \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower -c \
    --interval 3600

--schedule, -s - 設置定時檢測更新時間。格式為 6 字段 Cron 表達式，而非傳統(tǒng)的 5 字段，即第一位是秒。比如每天凌晨 2 點檢查一次更新：

docker run -d \
    --name watchtower \
    --restart unless-stopped \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower -c \
    --schedule "0 0 2 * * *"

5. 手動更新

加上 --run-once 這個專用的選項，運行一次退出并刪掉容器，來實現(xiàn)手動更新容器。這對于偶爾更新一次那些不在自動更新列表中的容器非常有用。

docker run --rm \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower -c \
    --run-once \
    aria2-pro

--run-once 可以簡寫為 -R：

docker run --rm \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower -cR \
    aria2-pro

注意：

當這個容器設置過 com.centurylinklabs.watchtower.enable=false 參數(shù)時不會更新。

6. 發(fā)送提示

可以通過電子郵件、Slack 、MSTeams 以及 Gotify 發(fā)送通知

docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e WATCHTOWER_NOTIFICATIONS=email \
  -e WATCHTOWER_NOTIFICATION_EMAIL_FROM=fromaddress@gmail.com \
  -e WATCHTOWER_NOTIFICATION_EMAIL_TO=toaddress@gmail.com \
  -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER=smtp.gmail.com \
  -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PORT=587 \
  -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER_USER=fromaddress@gmail.com \
  -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PASSWORD=app_password \
  -e WATCHTOWER_NOTIFICATION_EMAIL_DELAY=2 \
  containrrr/watchtower

7. watchtower獲取私有鏡像服務的認證方式

docker run -d --name watchtower --restart always -v /root/.docker/config.json:/config.json -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -c

/root/.docker/config.json文件，在docker登錄阿里云的私有鏡像服務后會自動生成，生成的位置應該是在登錄后的根目錄文章來源地址http://www.zghlxwxcb.cn/news/detail-469157.html

到了這里，關于Watchtower—自動更新docker鏡像與容器的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持TOY模板網(wǎng)！