Чеклист переключения (cutover)

Stable

Практический чеклист переключения приложения на SPG99 после миграции.

Обновлено: 5 марта 2026 г.

Cutover лучше воспринимать как отдельную короткую операцию с заранее подготовленным планом, а не как “последний шаг где‑нибудь вечером”.

До окна переключения

  • подтверждён целевой tenant, БД и финальный DSN;
  • команда знает, какой способ миграции использовался: pg_dump / pg_restore или согласованная репликация;
  • заранее проверены приложение, миграции и основные запросы на целевой базе;
  • определён путь отката и ответственные за него.

Непосредственно перед cutover

  • заморозьте изменения схемы на источнике;
  • завершите или согласуйте фоновые джобы, которые могут продолжать запись;
  • сделайте финальную проверку данных и подключения к цели;
  • если используется репликация, убедитесь, что лаг минимален или равен нулю.

Само переключение

  1. Остановите запись на источник.
  2. Обновите секреты и DSN приложения.
  3. Перезапустите приложение или его connection pool.
  4. Выполните smoke‑test чтения и записи уже против SPG99.

После переключения

  • проверьте состояние БД в Console;
  • посмотрите Metrics и Logs;
  • подтвердите, что бизнес‑критичные операции проходят нормально;
  • оставьте старый источник в режиме ожидания на согласованное короткое окно, если требуется безопасный rollback.

Что особенно важно не забыть

  • обновить DSN во всех сервисах и background workers, а не только в основном приложении;
  • пересобрать или очистить старые пулы соединений;
  • убрать устаревшие секреты после завершения окна отката.