Files
Govor/docs/operations.md
Artemy def724e0ee docs: split messaging and privileges guides
Organize reply/forward and friendship guidance into focused endpoint docs, add Govor+ privilege, profile-tag, and realtime guides, and document migrations and verification results.
2026-10-31 18:35:50 +07:00

6.0 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 не обеспечивает такую согласованность.

Миграции сообщений и привилегий

Перед запуском версии с ответами/пересылками и Govor+ примените MessagingAndUserBenefits и UserBenefitsRevision обычным способом проекта: dotnet run --project Govor.API -- --migrate-only. Добавляются nullable-поля происхождения пересылки в Messages, таблица UserBenefits и её ревизия. Старые сообщения и пользователи сохраняются; специальные права автоматически не назначаются.