Watchtower: автообновление Docker-контейнеров

Docker и контейнеры
Watchtower: автообновление Docker-контейнеров

Watchtower — небольшой контейнер, который следит за образами ваших приложений и автоматически обновляет их, как только в реестре появляется новая версия. Обновление контейнеров вручную (docker pull, остановка, пересоздание) быстро превращается в рутину, а забытый устаревший образ — это дыра в безопасности. Watchtower снимает эту рутину: проверяет обновления по расписанию, скачивает свежий образ, аккуратно пересоздаёт контейнер с теми же параметрами и может прислать уведомление. В статье настроим Watchtower с нуля, разберём режимы работы, уведомления и подводные камни автообновлений в продакшене.

Как работает Watchtower

Watchtower подключается к Docker API через сокет и периодически сравнивает digest (хеш) локального образа с образом в реестре. Если хеши разошлись — значит, вышла новая версия под тем же тегом. Тогда Watchtower:

  1. Скачивает новый образ (pull).
  2. Останавливает старый контейнер.
  3. Создаёт новый с теми же настройками: порты, тома, переменные окружения, сети, restart-политика.
  4. Удаляет старый контейнер (и, опционально, старый образ).

Важно понимать: Watchtower следит за тегом, а не за версией. Если контейнер запущен из nginx:latest, обновление придёт, когда в реестре обновится latest. Контейнер, прибитый к nginx:1.25.3, Watchtower обновлять не будет — хеш такого тега не меняется. Это ключевой момент, к которому вернёмся в разделе про продакшен.

Установка Watchtower

Базовый запуск — один контейнер:

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

По умолчанию Watchtower проверяет обновления каждые 24 часа и следит за всеми контейнерами на хосте. Проверить, что он запустился и что видит:

docker logs watchtower

В логах будет строка вида Watching N containers — это количество контейнеров под наблюдением.

Настройка интервала и расписания

Частоту проверок задают двумя способами.

Интервал в секундах — например, раз в 6 часов:

docker run -d \
  --name watchtower \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --interval 21600

Cron-расписание — гибче, привязка к времени. Каждый день в 4 утра:

docker run -d \
  --name watchtower \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --schedule "0 0 4 * * *"

Формат cron у Watchtower шестипольный (первое поле — секунды). Ночное расписание удобно тем, что пересоздание контейнеров с кратким простоем приходится на время минимальной нагрузки.

Выборочное обновление контейнеров

Обновлять всё подряд рискованно. Есть два подхода к тому, чтобы Watchtower трогал только нужное.

Подход 1. Обновлять только помеченные контейнеры. Watchtower запускается с флагом --label-enable, а нужные контейнеры помечаются меткой:

docker run -d \
  --name watchtower \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --label-enable

Тогда в Compose-файле сервиса, который хотим автообновлять:

services:
  web:
    image: myapp:latest
    restart: unless-stopped
    labels:
      - "com.centurylinklabs.watchtower.enable=true"

Подход 2. Исключить конкретные контейнеры из общего наблюдения — той же меткой со значением false:

services:
  database:
    image: postgres:16
    labels:
      - "com.centurylinklabs.watchtower.enable=false"

Второй подход особенно важен для баз данных: автоматически подменять образ СУБД под работающими данными опасно. Как правильно хранить и переносить данные контейнеров, разбирали в статье про тома и данные Docker.

Уведомления в Telegram и на почту

Гораздо спокойнее, когда обновления не молча происходят, а приходят сообщением. Watchtower умеет слать уведомления в Telegram, email, Slack и другие каналы через shoutrrr.

Пример с Telegram: нужен токен бота (от @BotFather) и chat_id.

docker run -d \
  --name watchtower \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e WATCHTOWER_NOTIFICATIONS=shoutrrr \
  -e WATCHTOWER_NOTIFICATION_URL="telegram://ТОКЕН@telegram?chats=CHAT_ID" \
  containrrr/watchtower \
  --schedule "0 0 4 * * *"

Полезный флаг для тишины в спокойные дни — WATCHTOWER_NOTIFICATIONS_LEVEL=info шлёт отчёт только когда что-то реально обновилось. А чтобы разово проверить настройку уведомлений, добавьте --run-once: Watchtower выполнит одну проверку, отчитается и завершится.

Очистка старых образов

После обновления старый образ остаётся на диске и со временем их накапливается много. Флаг --cleanup удаляет предыдущий образ сразу после успешного обновления:

docker run -d \
  --name watchtower \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --cleanup --schedule "0 0 4 * * *"

Даже с --cleanup со временем скапливается мусор из dangling-образов и оборванных слоёв. Как навести порядок вручную и настроить регулярную очистку — в статье про очистку диска от Docker.

Ключевые параметры Watchtower

ПараметрНазначение
--interval NИнтервал проверки в секундах
--schedule "cron"Расписание в формате cron (6 полей)
--cleanupУдалять старый образ после обновления
--label-enableОбновлять только помеченные контейнеры
--run-onceОдна проверка и выход (для теста)
--monitor-onlyТолько уведомлять, не обновлять
--rolling-restartОбновлять контейнеры по одному, а не все сразу
--include-stoppedУчитывать и остановленные контейнеры

Watchtower в продакшене: осторожно

Автообновление удобно, но в продакшене к нему нужно относиться серьёзно. Главные риски:

  • **Тег latest непредсказуем.** Новая версия может сломать совместимость. В критичных сервисах используйте фиксированные минорные теги (app:1.4) и обновляйте осознанно, либо ставьте --monitor-only, чтобы Watchtower только уведомлял, а решение принимали вы.
  • Даунтайм при пересоздании. Контейнер на секунды-минуты становится недоступен. Для сервисов с одним экземпляром это заметный простой; смягчает ситуацию --rolling-restart и ночное расписание.
  • Базы данных обновлять автоматически нельзя. Всегда исключайте СУБД меткой enable=false.
  • Нет отката. Watchtower не откатит сломанное обновление сам. Поэтому перед автообновлениями настройте резервное копирование — как это делать для контейнеров, описано в статье про бэкап Docker-контейнеров.

Разумный компромисс: --monitor-only для критичных сервисов и полное автообновление — для второстепенных (мониторинг, вспомогательные утилиты). Общие практики надёжной эксплуатации собраны в материале Docker Compose в продакшене.

Пример: Watchtower в docker-compose.yml

services:
  watchtower:
    image: containrrr/watchtower
    container_name: watchtower
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - WATCHTOWER_CLEANUP=true
      - WATCHTOWER_SCHEDULE=0 0 4 * * *
      - WATCHTOWER_LABEL_ENABLE=true
      - WATCHTOWER_NOTIFICATIONS=shoutrrr
      - WATCHTOWER_NOTIFICATION_URL=telegram://ТОКЕН@telegram?chats=CHAT_ID

Такой сервис добавляется в общий стек и обновляет только контейнеры с меткой watchtower.enable=true, присылая отчёт в Telegram.

Частые вопросы

Обновит ли Watchtower контейнер с фиксированным тегом версии?

Нет. Watchtower отслеживает изменение образа под конкретным тегом. Если контейнер запущен из postgres:16.2, этот тег в реестре не меняется, поэтому обновления не будет. Автообновление имеет смысл только для «плавающих» тегов вроде latest или мажорных 16.

Будет ли простой при обновлении?

Да, короткий. Watchtower останавливает старый контейнер и запускает новый, поэтому сервис недоступен на время пересоздания — обычно от нескольких секунд до минуты. Чтобы минимизировать эффект, используйте расписание на ночные часы и флаг --rolling-restart при нескольких контейнерах.

Как обновлять сам Watchtower?

Watchtower по умолчанию следит и за собственным образом, поэтому обновляется автоматически: он корректно пересоздаёт свой контейнер. Если хотите обновить вручную, выполните docker pull его образа и пересоздайте контейнер обычным способом.

Можно ли только получать уведомления без автообновления?

Да, для этого есть режим --monitor-only. Watchtower будет проверять реестр и сообщать о доступных обновлениях через настроенный канал, но сами контейнеры не тронет. Это безопасный вариант для продакшена, когда решение об обновлении вы принимаете сами.

Watchtower работает с приватным реестром?

Да. Watchtower использует учётные данные Docker из ~/.docker/config.json — достаточно один раз выполнить docker login на хосте и примонтировать конфиг в контейнер, либо передать данные через переменные окружения. Это удобно, если образы вы храните в собственном реестре.


Автообновление раскрывается, когда на сервере крутится несколько сервисов и следить за ними вручную становится тяжело. Тариф Pro от Cheap-Host — 12 vCPU, 16 ГБ RAM, 128 ГБ NVMe за 750₽/мес, KVM в Москве — комфортно тянет стек приложений вместе с Watchtower и панелью управления. Сервер выдаётся за 45–60 секунд. Выбрать тариф на Cheap-Host →

Читайте также