====== Watchtower: автоматически обновляем докер-контейнеры ======

Сайт: https://github.com/containrrr/watchtower

Документация: https://containrrr.dev/watchtower/

===== Настройки =====

Watchtower наблюдает за запущенными docker-контейнерами, периодически проверяет обновления версий образов (по умолчанию раз в сутки). Если вышла новая версия контейнера - скачивает ее и перезапускает контейнер. Причем все это можно гибко настраивать под ваши хотелки.

Запуск (Docker):
<code>
docker run -d \
    --name watchtower \
    --restart=unless-stopped \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower
</code>

Запуск (Docker Compose) с настройками:
  * уведомления в Telegram
  * запускать каждое воскресенье в 07:45 утра по Москве
  * перезапускать контейнеры по очереди
  * удалять старые образы

<code>
version: '3.3'

services:
  watchtower:
    image: containrrr/watchtower
    container_name: watchtower
    restart: unless-stopped
    volumes:
      - '/var/run/docker.sock:/var/run/docker.sock'
    environment:
      - TZ=Europe/Moscow
      - WATCHTOWER_NOTIFICATIONS_HOSTNAME=MyOwnHostName
      - WATCHTOWER_LIFECYCLE_HOOKS=True
      - WATCHTOWER_NOTIFICATIONS=shoutrrr
      - WATCHTOWER_NOTIFICATION_URL=telegram://BOT_TOKEN@telegram/?channels=CHAT_ID
      - WATCHTOWER_DEBUG=false
      - WATCHTOWER_CLEANUP=true
      - WATCHTOWER_ROLLING_RESTART=true
      - WATCHTOWER_SCHEDULE=0 45 07 * * 0
</code>

Однако далеко не всегда требуется жить на последней версии (те самые любимые всеми latest). Поэтому можно настроить исключения, необходимо добавить метку (label): https://containrrr.dev/watchtower/container-selection/

<code>
LABEL com.centurylinklabs.watchtower.enable="false"
</code>

Или сразу при запуске:

<code>
docker run -d --label=com.centurylinklabs.watchtower.enable=false someimage
</code>

При обновлении контейнеров остаются старые версии. Можно, конечно, запускать в кроне что-то вроде <code>docker image prune -f</code> но гораздо удобнее указывать флаг <code>--cleanup</code>

Так же зачастую нам требуется однозначно указать время обновления (например ночью, когда нагрузка минимальна), это можно сделать флагом <code>--schedule "0 0 4 * * *"</code> в привычном формате cron'а, но состоящем из 6 полей вместо 5 привычных (добавлены секунды), подробнее тут: https://pkg.go.dev/github.com/robfig/cron@v1.2.0#hdr-CRON_Expression_Format

Еще очень удобен флаг <code>--rolling-restart</code> для перезапуска контейнеров по очереди, а не сразу всех.

Так же можно работать с другим Docker-хостом: <code>--host, -H</code>, указав адрес в виде <code>"tcp://hostname:port"</code>

Еще много полезного можно посмотреть на страничке с документацией (ссылка в самом начале заметки).

===== Мониторинг =====

За всеми такими действиями нужен глаз да глаз, чтобы если что-то пошло не так можно было быстрее понять причину. Для этого можно включить сбор метрик при помощи Prometheus: https://containrrr.dev/watchtower/metrics/

Чтобы заработало, нужно:
  * Задать API token: <code>--http-api-token YOU_TOKEN</code>
  * Включить API endpoint: </code>--http-api-metrics</code>

===== Уведомления =====

Для понимания что происходит при работе - можно использовать уведомления, подробно расписано тут: https://containrrr.dev/watchtower/notifications/

Уведомления в Telegram: создаем нашего бота в Telegram и получаем его токен, узнаем id нашего чата и добавляем переменные среды (env) как указано ниже:

<code>
docker run -d \
  --name watchtower \
  --restart=unless-stopped \
  -e WATCHTOWER_LIFECYCLE_HOOKS=1 \
  -e WATCHTOWER_NOTIFICATIONS=shoutrrr \
  -e WATCHTOWER_NOTIFICATION_URL=telegram://BOT_TOKEN@telegram/?channels=CHAT_ID \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower
</code>

===== Шаблон для сервиса =====

<code>
version: '3'

services:
  app-monitored-by-watchtower:
    image: myapps/monitored-by-watchtower
    labels:
      - "com.centurylinklabs.watchtower.enable=true"

  watchtower:
    image: containrrr/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: --cleanup --schedule "00 50 23 * * *" --http-api-update
    environment:
      - WATCHTOWER_HTTP_API_TOKEN=mytoken
    labels:
      - "com.centurylinklabs.watchtower.enable=false"
    ports:
      - 8080:8080
</code>

{{tag>docker image watchtower обновление}}