<div class="entry-content l-h-2x" id="md_handsome_origin"><h2>前言</h2><p>在早前部署<code>Awesome TTRSS</code>时,作者在<code>docker-compose</code>里配置了<code>Watchtower</code>,于是找到 Github 官方项目研究了下,根据官方文档简单整理了一下常用参数以备用.</p><p><div class="tip inlineBlock share"><strong>Watchtower</strong> 是一款实现自动化更新 Docker 镜像与容器的实用工具.它监控着所有正在运行的容器以及相关镜像,当检测本地镜像与镜像仓库中的镜像有差异时,会自动拉取最新镜像并使用最初部署时的参数重新启动相应的容器.</div><p><button class="btn m-b-xs btn-dark btn-addon" onclick='window.open("https://github.com/containrrr/watchtower","_blank")'><i class="fa fa-github fa-lg"></i>containrrr/watchtower</button></p><p><div class="tip inlineBlock success">本文为<a href="https://www.ioiox.com/stille.html" target="_blank"> Stille </a>原创文章.经实践,测试,整理发布.如需转载请联系作者获得授权,并注明转载地址.</div><hr><h2>部署</h2><h3>快速启动</h3><p>执行以下标准命令启动 Watchtower 容器,并每 5 分钟一次检查所有容器的镜像是否为最新版,如发现镜像更新将会自动<code>停止容器</code>,<code>删除容器</code>,<code>拉取最新镜像</code>,在以之前启动容器的命令<code>启动容器</code>.</p> ``` docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower ``` <h3>清理旧镜像</h3><p>镜像在更新后旧镜像标签会变为<code>none</code>,长期自动更新会导致过多的<code>none</code>镜像占用空间,加入<code>--cleanup</code>参数可以在每次更新后自动删除<code>none</code>镜像.</p> ``` docker run -d --name watchtower --restart always -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --cleanup ``` <h3>指定容器更新</h3> <p>如无需自动更新所有稳定运行的容器,可以配置仅更新指定容器,只需要在命令后加上容器名.例如<strong>只更新</strong><code>nginx</code>和<code>redis</code>.</p> ``` docker run -d --name watchtower --restart always -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --cleanup nginx redis ``` <p><div class="tip inlineBlock warning">注意指定容器需填写 <strong>容器名</strong> ,并非镜像名.由于部分容器启动时可能没有定义 <strong>--name</strong> 参数,请执行 <strong>docker ps</strong> 查询核对容器名.</div><h3>配置自动更新频率</h3><p>Watchtower 默认每 5 分钟轮询一次,可以使用以下参数配置更新的频率.</p><ul><li><code>--interval</code>,<code>-i</code> 配置更新周期,默认300秒.</li><li><code>--schedule</code>,<code>-s</code> 配置定时更新,使用<code>Cron表达式</code>,例如`0 0 1 * * * `即每天凌晨1点更新.</li></ul> <p><div class="tip inlineBlock error"><strong>注意:</strong>当使用 <strong>-s</strong> 参数来配置定时更新时,由于容器内默认为 <strong>UTC</strong> 时间,上述设置的 <strong>凌晨1点</strong> 实际上是北京时间 <strong>早上9点</strong> .可以通过加上 <strong>-e TZ=Asia/Shanghai</strong> 环境变量来定义时区,此时配置的时间则为北京时间.</div> <h4>每小时更新一次</h4> ``` docker run -d --name watchtower --restart always -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --cleanup -i 3600 ``` ## 手动更新 ``` docker run -d --name watchtower --restart always -e TZ=Asia/Shanghai -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --cleanup -s 0 0 1 * * * ``` 使用手动更新的方式,运行一次<code>Watch tower</code>容器来更新所需的容器,更新后会自动删除本次运行的<code>Watch tower</code>容器.只需要加上<code>--rm</code>和<code>--run-once</code>参数即可.同时也可以配合以上<code>指定容器</code>或指<code>定排除容器</code>的参数来使用. <h4>手动更新所有容器</h4> ``` docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --cleanup --run-once ``` <h4>手动更新指定容器</h4> ``` docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --cleanup --run-once nginx redis ``` <p><div class="tip inlineBlock warning">注意指定容器需填写 <strong>容器名</strong> ,并非镜像名.由于部分容器启动时可能没有定义 <strong>--name</strong> 参数,请执行 <strong>docker ps</strong> 查询核对容器名.</div> <p>手动运行更新时会出现以下消息,表示正在更新,请耐心等待几分钟.</p><pre><code class="lang-shell">time="2020-02-18T03:58:24Z" level=info msg="Running a one time update."</code></pre><p>随后提示找到更新镜像,停止容器,更新镜像,重启容器并移除旧镜像.至此更新完毕.</p> <pre><code class="lang-shell"> time="2020-02-18T04:02:45Z" level=info msg="Found new xxxx/xxxx:latest image (sha256:10383f5b5720d7e1fxxxx137034c69b7f6xxxxxxafcc4e9d508b561af77)" time="2020-02-18T04:02:45Z" level=info msg="Stopping /xxxx (2e9ce1ebe319f3a35d80bxxxxxxxxxx6763ada155da957acb24fe76fc8a8c5) with SIGTERM" time="2020-02-18T04:02:46Z" level=info msg="Creating /xxxx" time="2020-02-18T04:02:46Z" level=info msg="Removing image sha256:ff4ee4caaa237174080c0d545xxxxxxxxxxxxxxx5d740ddc51e7737839cb5" </code></pre> ## docker-compose写法 <pre><code class="lang-shell">version: "3" services: watchtower : image: containrrr/watchtower container_name: watchtower restart: always tty: true hostname: bili-help volumes: - /var/run/docker.sock:/var/run/docker.sock environment: - TZ=Asia/Shanghai command: nginx redis --cleanup --schedule "0 0 4 * * *"</code></pre> <h2>结语</h2> 其他更多参数以及功能请参考官方文档: <button class="btn m-b-xs btn-info btn-addon" onclick='window.open("https://containrrr.github.io/watchtower/","_blank")'> <i class="glyphicon glyphicon-tower"></i>官方文档 Documentation</button></p><hr class="content-copyright" style="margin-top:50px" /> <div align="center"><p class="content-copyright"><div class="tip inlineBlock success"> 本文为<a class="content-copyright" href="https://www.ioiox.com/stille.html"> Stille </a>原创文章.经实践,测试,整理发布.如需转载请联系作者获得授权,并注明转载地址.</p> <p align="left">本文链接 <a class="content-copyright" href="https://www.ioiox.com/archives/84.html">https://www.ioiox.com/archives/84.html</a> </div></p></div></div> WMI Scripting HTML 当前访问者IP地址及地址归属： Last modification：April 17th, 2023 at 06:33 pm © 允许规范转载 Support 如果觉得我的文章对你有用，请随意赞赏 ×Close Appreciate the author Sweeping payments