Watchtower — небольшой контейнер, который следит за образами ваших приложений и автоматически обновляет их, как только в реестре появляется новая версия. Обновление контейнеров вручную (docker pull, остановка, пересоздание) быстро превращается в рутину, а забытый устаревший образ — это дыра в безопасности. Watchtower снимает эту рутину: проверяет обновления по расписанию, скачивает свежий образ, аккуратно пересоздаёт контейнер с теми же параметрами и может прислать уведомление. В статье настроим Watchtower с нуля, разберём режимы работы, уведомления и подводные камни автообновлений в продакшене.
Как работает Watchtower
Watchtower подключается к Docker API через сокет и периодически сравнивает digest (хеш) локального образа с образом в реестре. Если хеши разошлись — значит, вышла новая версия под тем же тегом. Тогда Watchtower:
- Скачивает новый образ (
pull). - Останавливает старый контейнер.
- Создаёт новый с теми же настройками: порты, тома, переменные окружения, сети, restart-политика.
- Удаляет старый контейнер (и, опционально, старый образ).
Важно понимать: 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 →