Files
mtusi2026lab3/openspec/changes/rolling-update/specs/db-migrations/spec.md
T
2026-10-11 00:26:36 +03:00

4.5 KiB

Spec Delta

ADDED Requirements

Requirement: Совместимость миграции с работающей версией

Миграция SHALL только расширять схему:

  • новая таблица;
  • новая колонка, допускающая NULL или со значением по умолчанию;
  • новый индекс.

Удаление и переименование таблицы, колонки или ограничения, а также новое ограничение, которое нарушит запись прежней версии, MUST NOT входить в ту же поставку, что и код, которому они нужны. Такое изменение выполняется отдельной миграцией после того, как реплик прежней версии не осталось (expand/contract). Если так сделать нельзя, ограничение SHALL описываться в REPORT.md.

Реплики прежнего образа SHALL обслуживать обязательные запросы на схеме после новой миграции. Откат кода к прежнему образу MUST NOT требовать отката схемы.

Ожидание блокировки таблицы миграцией SHALL быть ограничено сроком. Долгая транзакция приложения не должна заставить миграцию держать очередь за собой и остановить запись остальных реплик. По истечении срока миграция SHALL завершаться ошибкой без изменения схемы, а её повторный запуск SHALL проходить.

Scenario: Старый образ на новой схеме

  • WHEN стенд работает на образе прежнего commit, и миграции нового образа применены, а реплики не заменены
  • THEN make test и make student_test через LB проходят на прежних репликах

Scenario: Запись прежней версии

  • WHEN после новой миграции сообщение отправлено через реплику прежнего образа
  • THEN ответ 201, а сообщение видно в истории через реплику любого образа

Scenario: Блокировка не получена

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

Requirement: Однократные миграции при замене реплик

Поочерёдная замена реплик (load-balancing) SHALL применять миграции один раз за запуск: отдельным одноразовым контейнером на новом образе, после сборки образа и до запуска первой новой реплики. Реплики MUST NOT запускать миграции сами. Если миграция завершилась ошибкой, замена MUST NOT начинаться: работающие реплики не трогаются, скрипт завершается с ненулевым кодом.

Scenario: Одна миграция на замену

  • WHEN выполнен make rolling_update для двух реплик
  • THEN в журнале замены одна миграция до первой новой реплики, в журналах реплик записей alembic нет, а ревизия схемы после замены — последняя

Scenario: Миграция упала

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