mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-16 20:56:03 +00:00
def724e0ee
Organize reply/forward and friendship guidance into focused endpoint docs, add Govor+ privilege, profile-tag, and realtime guides, and document migrations and verification results.
49 lines
6.0 KiB
Markdown
49 lines
6.0 KiB
Markdown
# Обновления, резервные копии и восстановление
|
|
|
|
## Перед обновлением
|
|
|
|
Зафиксируйте текущий commit/digest образа, список миграций, адрес БД, путь uploads и предыдущий успешный релиз. Сделайте согласованную резервную копию БД и файлов вне сервера. Секреты храните отдельно с ограниченным доступом. Проверьте восстановление копии на отдельной среде.
|
|
|
|
Миграции E2EE/парольного восстановления меняют протоколы клиента и сервера. Порядок перехода старых устройств описан в [E2EE](e2ee.md) и [восстановлении](password-recovery.md). Старые ключи, которых нет ни на устройстве, ни в архиве, сервер восстановить не может.
|
|
|
|
## Порядок релиза
|
|
|
|
1. Собрать и проверить конкретную ревизию, сохранить digest образа.
|
|
2. Проверить совместимость миграций с работающим кодом; при необходимости остановить запись.
|
|
3. Применить миграции тем же артефактом через `--migrate-only`. Не запускать конкурирующие миграции.
|
|
4. Запустить API с постоянными каталогами и нужным runtime.
|
|
5. Проверить внешний `/server/ready`, вход и refresh, историю, старое вложение, новый файл и WSS.
|
|
6. Проверить восстановление на новом устройстве и реальный push, если они входят в релиз.
|
|
|
|
VPS-скрипт сериализует деплои, но автоматического отката БД нет. Если миграция завершилась ошибкой, схема уже могла измениться; сначала выясните состояние. [Команды VPS и возврат образа](vps-deployment.md).
|
|
|
|
## Что сохранять
|
|
|
|
| Ресурс | Для чего нужен |
|
|
| --- | --- |
|
|
| 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 и её ревизия. Старые сообщения и пользователи сохраняются; специальные права автоматически не назначаются.
|