Сервер в кладовке
docker

Как я обновляю контейнеры и больше не ломаю базы

Несколько сервисов у меня живут в Docker: фотогалерея, менеджер документов, медиасервер. Первые полгода я обновлял их как попало и пару раз получал сломанную базу после мажорного обновления. Теперь есть порядок.

Фиксированные теги вместо latest

В compose.yaml у каждого образа указана конкретная версия:

services:
  app:
    image: ghcr.io/example/app:2.14.3
  db:
    image: postgres:16.4

С тегом latest обновление происходит незаметно — при любом пересоздании контейнера. С фиксированной версией я точно знаю, что запущено, и обновляюсь осознанно.

Порядок обновления

  1. Прочитать примечания к выпуску. Особенно для мажорных версий: там пишут про миграции и несовместимые изменения.
  2. Сделать дамп базы и снимок каталога с данными.
  3. Поменять тег в compose.yaml.
  4. Обновить:
docker compose pull
docker compose up -d
docker compose logs -f --tail=100

up -d пересоздаёт только те контейнеры, у которых изменился образ или конфигурация. Логи смотрю до тех пор, пока не увижу, что миграции прошли.

Базы данных отдельно

PostgreSQL между мажорными версиями (15 → 16) нельзя обновить сменой тега: формат данных другой. Нужен дамп и восстановление в новой версии или pg_upgrade. Поэтому версию базы я меняю редко и всегда отдельным шагом.

Уборка

docker image prune

Удаляет образы без тегов, оставшиеся после обновлений. За год их накопилось на 30 ГБ.

Автоматические обновления контейнеров (Watchtower и подобные) я пробовал и отказался: удобно, пока одно из обновлений молча не сломает сервис в момент, когда вас нет дома.
← Все заметки