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

72 lines
4.5 KiB
Markdown

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