Files
Govor/docs/operations.md
T
Artemy 632ac04b56 Add forwarding, friend controls, and benefits
Add message forwarding and reply lookup, friend removal and blocking endpoints, and database-backed Govor+ privileges with customizable profile tags. Include migrations, integration tests, and updated API and operations documentation.
2026-10-31 18:29:40 +07:00

5.3 KiB

Обновления, резервные копии и восстановление

Перед обновлением

Зафиксируйте текущий commit/digest образа, список миграций, адрес БД, путь uploads и предыдущий успешный релиз. Сделайте согласованную резервную копию БД и файлов вне сервера. Секреты храните отдельно с ограниченным доступом. Проверьте восстановление копии на отдельной среде.

Миграции E2EE/парольного восстановления меняют протоколы клиента и сервера. Порядок перехода старых устройств описан в E2EE и восстановлении. Старые ключи, которых нет ни на устройстве, ни в архиве, сервер восстановить не может.

Порядок релиза

  1. Собрать и проверить конкретную ревизию, сохранить digest образа.
  2. Проверить совместимость миграций с работающим кодом; при необходимости остановить запись.
  3. Применить миграции тем же артефактом через --migrate-only. Не запускать конкурирующие миграции.
  4. Запустить API с постоянными каталогами и нужным runtime.
  5. Проверить внешний /server/ready, вход и refresh, историю, старое вложение, новый файл и WSS.
  6. Проверить восстановление на новом устройстве и реальный push, если они входят в релиз.

VPS-скрипт сериализует деплои, но автоматического отката БД нет. Если миграция завершилась ошибкой, схема уже могла измениться; сначала выясните состояние. Команды VPS и возврат образа.

Что сохранять

Ресурс Для чего нужен
PostgreSQL Пользователи, сообщения, права, сессии, архивы ключей и ссылки на файлы
uploads Сами бинарные вложения, аватары, медиа реакций
Runtime-секреты и конфигурация Подключение, подпись JWT, хеширование refresh, Firebase, домен
Образ и конфигурация релиза Повторяемый запуск совместимой версии
Пользовательский код/пароль и доверенное устройство Расшифровка архива E2EE; операторская копия БД их не заменяет

Логи полезны для расследования, но не заменяют БД. Ограничьте их срок хранения и следите за размером: журналы могут содержать идентификаторы и внутренние ошибки. Не публикуйте runtime.env, токены и зашифрованные архивы в открытых обращениях поддержки.

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

  1. Поднимите изолированную среду и совместимый образ.
  2. Восстановите согласованные копии БД и uploads; проверьте пути и права записи.
  3. Восстановите runtime-конфигурацию. Смена JWT-секрета инвалидирует подпись старых токенов; смена EncryptionOption:Secret нарушает поиск старых refresh-хешей и требует нового входа.
  4. Убедитесь, что миграции соответствуют коду, проверьте ready и пользовательские сценарии.
  5. Переключите трафик после проверки. Не подключайте тестовое восстановление к production Firebase без намерения отправлять уведомления.

Отключённый Firebase использует NullPushProvider и считает задачи обработанными; это не буфер для отложенной доставки. После восстановления старой БД push-задачи могут повториться: клиент дедуплицирует по messageId.

Несколько экземпляров

OnlineUserStore, ConnectionStore, SRP challenge и rate limiter локальны процессу. Несколько реплик требуют согласования SignalR/presence, маршрутизации/общего одноразового хранилища challenge и общих файлов. Одна только общая PostgreSQL не обеспечивает такую согласованность.