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 скрипт завершается с ненулевым кодом до запуска новых реплик, а прежние реплики работают и обслуживают запросы