Organize reply/forward and friendship guidance into focused endpoint docs, add Govor+ privilege, profile-tag, and realtime guides, and document migrations and verification results.
6.0 KiB
Обновления, резервные копии и восстановление
Перед обновлением
Зафиксируйте текущий commit/digest образа, список миграций, адрес БД, путь uploads и предыдущий успешный релиз. Сделайте согласованную резервную копию БД и файлов вне сервера. Секреты храните отдельно с ограниченным доступом. Проверьте восстановление копии на отдельной среде.
Миграции E2EE/парольного восстановления меняют протоколы клиента и сервера. Порядок перехода старых устройств описан в E2EE и восстановлении. Старые ключи, которых нет ни на устройстве, ни в архиве, сервер восстановить не может.
Порядок релиза
- Собрать и проверить конкретную ревизию, сохранить digest образа.
- Проверить совместимость миграций с работающим кодом; при необходимости остановить запись.
- Применить миграции тем же артефактом через
--migrate-only. Не запускать конкурирующие миграции. - Запустить API с постоянными каталогами и нужным runtime.
- Проверить внешний
/server/ready, вход и refresh, историю, старое вложение, новый файл и WSS. - Проверить восстановление на новом устройстве и реальный push, если они входят в релиз.
VPS-скрипт сериализует деплои, но автоматического отката БД нет. Если миграция завершилась ошибкой, схема уже могла измениться; сначала выясните состояние. Команды VPS и возврат образа.
Что сохранять
| Ресурс | Для чего нужен |
|---|---|
| PostgreSQL | Пользователи, сообщения, права, сессии, архивы ключей и ссылки на файлы |
uploads |
Сами бинарные вложения, аватары, медиа реакций |
| Runtime-секреты и конфигурация | Подключение, подпись JWT, хеширование refresh, Firebase, домен |
| Образ и конфигурация релиза | Повторяемый запуск совместимой версии |
| Пользовательский код/пароль и доверенное устройство | Расшифровка архива E2EE; операторская копия БД их не заменяет |
Логи полезны для расследования, но не заменяют БД. Ограничьте их срок хранения и следите за размером: журналы могут содержать идентификаторы и внутренние ошибки. Не публикуйте runtime.env, токены и зашифрованные архивы в открытых обращениях поддержки.
Восстановление после потери сервера
- Поднимите изолированную среду и совместимый образ.
- Восстановите согласованные копии БД и uploads; проверьте пути и права записи.
- Восстановите runtime-конфигурацию. Смена JWT-секрета инвалидирует подпись старых токенов; смена
EncryptionOption:Secretнарушает поиск старых refresh-хешей и требует нового входа. - Убедитесь, что миграции соответствуют коду, проверьте ready и пользовательские сценарии.
- Переключите трафик после проверки. Не подключайте тестовое восстановление к 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 и её ревизия. Старые сообщения и пользователи сохраняются; специальные права автоматически не назначаются.