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