Эксплуатация

Обновление, резервные копии, мониторинг и разбор проблем — всё, что нужно после первого запуска.

Обновление

Обновление — это новый образ на том же томе. Данные, токены и ссылки сохраняются.

docker compose pull
docker compose up -d

Или без compose:

docker pull flytachi/s5w:latest
docker stop -t 45 s5w && docker rm s5w
docker run -d --name s5w … flytachi/s5w:latest   # та же команда, тот же том

• Перед обновлением сделайте резервную копию — см. ниже.
• Закрепляйте версию в рабочем развёртывании (flytachi/s5w:<версия>, а не latest): так обновление происходит, когда вы решили, а не при случайном pull.
• Читайте заметки к выпуску — в них описано, что меняется для тех, кто обновляется. Для перехода с 1.0.x — отдельная страница.

Резервное копирование

Всё состояние сервиса — в томе /var/lib/s5w: база, файлы и ключ подписи. Копия тома — это полная копия сервиса.

1. Остановите контейнер

   docker stop -t 45 s5w

   Копия работающего тома может оказаться несогласованной: база и файлы на диске меняются независимо. Остановка занимает несколько секунд.

2. Скопируйте том в архив

   docker run --rm \
     -v s5w_data:/data:ro \
     -v "$PWD":/backup \
     --entrypoint tar flytachi/s5w:latest \
     czf /backup/s5w-$(date +%F).tar.gz -C /data .

3. Запустите контейнер

   docker start s5w

Если том подключён каталогом хоста (/srv/s5w), вместо второго шага подойдёт любой инструмент копирования каталогов — tar, rsync, снимок ФС — пока контейнер остановлен.

Копия базы без остановки

Для дополнительной страховки метаданные можно выгрузить на ходу:

docker exec s5w pg_dump -U s5w -h /run/postgresql -Fc s5w > s5w-db-$(date +%F).dump

Это копия только базы. Полное восстановление делается из копии тома.

Восстановление

1. Создайте том и распакуйте в него архив

   docker volume create s5w_data
   docker run --rm \
     -v s5w_data:/data \
     -v "$PWD":/backup:ro \
     --entrypoint tar flytachi/s5w:latest \
     xzpf /backup/s5w-2026-11-08.tar.gz -C /data

   Флаг p сохраняет владельцев и права: каталогу базы они обязательны.

2. Запустите контейнер на этом томе

   Той же командой, что и обычно. Сервис поднимается с теми же бакетами, файлами, токенами и временными ссылками: ключ подписи восстановлен вместе с томом.

Перенос на другой сервер — то же самое: архив с одного сервера, восстановление на другом.

Healthcheck

Отдельного эндпоинта здоровья нет. Признак того, что приложение принимает запросы, — GET /v1/check без токена отвечает 401.

services:
  s5w:
    # …
    healthcheck:
      test: ["CMD-SHELL", "test \"$$(curl -s -o /dev/null -w %{http_code} http://127.0.0.1:9090/v1/check)\" = 401"]
      interval: 30s
      timeout: 5s
      start_period: 30s
      retries: 3

Готовность базы отдельно:

docker exec s5w pg_isready -h /run/postgresql -U s5w

Мониторинг

docker exec s5w su-exec winter php call app status

Команда показывает каждую часть — HTTP, планировщик, панель — с состоянием, PID, временем работы и числом перезапусков. Растущее число перезапусков — повод смотреть лог.

Логи

docker logs -f s5w              # всё: приложение, PostgreSQL, супервизор
docker logs --since 1h s5w      # за последний час

Все части пишут в вывод контейнера, его собирает Docker и любой сборщик логов. Уровень задаёт LOG_LEVEL — см. Настройку.

Команды обслуживания

docker exec -it s5w sh                                     # shell в контейнере
docker exec s5w su-exec winter php call app status        # состояние частей
docker exec -it s5w psql -U s5w -h /run/postgresql s5w     # psql во встроенную базу
docker exec s5w su-exec winter php call db migrate         # создать недостающие таблицы

Команды приложения выполняются от пользователя winter — поэтому su-exec winter.

Обслуживание по расписанию (сроки хранения, очистка, пересчёт места) работает внутри контейнера само — отдельный cron не нужен. Список задач — в архитектуре.

Типовые проблемы