Files
mtusi2026lab3/evidence/rolling-update.md
T

56 lines
2.5 KiB
Markdown

# Поочерёдная замена API под нагрузкой
Дата: 2026-10-23.
## Сценарий
Нагрузка выполнялась через HAProxy на `http://localhost:8080`:
```sh
python3 tests/load.py \
--base-url http://localhost:8080 \
--duration 30 \
--concurrency 4 \
--output evidence/rolling-update-load.json
```
Во время нагрузки выполнен `scripts/rolling-update.sh`. Скрипт по очереди удаляет одну API-реплику, создаёт замену и перед переходом ко второй ждёт две реплики в состоянии `healthy`.
## Наблюдение реплик
До замены:
```text
486287bf812aecec7bba303bd502e06fe6758602ef248e5933ecfd02964a388a healthy
03f5832b4b2a570d245a01a308e7756db170b54caeeb7ec9e6c2a0e4cf2241a6 healthy
```
После замены:
```text
c1fa8669e26796af661b85f947369a9be8245c18c5f560c74a24f772d1015bbd healthy
3d931568da47ff5723fd7089e876ea5d5825abe1ec73506b3625180686425cd4 healthy
```
Обе исходные реплики заменены новыми контейнерами. Одновременно останавливалась только одна реплика.
## Результат нагрузки
- Длительность: 30,017 с.
- Concurrency: 4.
- Успешные запросы: 10 512.
- Ошибки: 0.
- Error ratio: 0,0.
- Successful RPS: 350,206.
- p50: 5,169 мс.
- p95: 50,037 мс.
- p99: 61,382 мс.
Машиночитаемый результат сохранён в `evidence/rolling-update-load.json`.
## Совместимость миграции
Миграция lab3 добавляет nullable-поле `idempotency_key` и уникальность `(sender_id, chat_id, idempotency_key)`. Старая версия API может продолжать записывать `NULL`, а новая версия читает старые сообщения без ключа. Поэтому схема совместима с поочерёдной заменой приложения.
Ограничение: создание уникального ограничения может блокировать запись на большой таблице. В учебном стенде миграция выполняется отдельно до запуска API и проверена на малом наборе данных; online-миграция большой production-таблицы не заявляется.