forked from mtusi2026/mtusi2026lab3
64 lines
6.6 KiB
Markdown
64 lines
6.6 KiB
Markdown
# Лабораторная 3. Балансировка и отказ API-реплики
|
||
|
||
Решение сохраняет API и постоянные данные ЛР2, добавляет HAProxy, масштабируемый пул API-реплик, общие PostgreSQL/Valkey, `X-Instance-Id` и атомарный `Idempotency-Key` для POST сообщений. На «5» выбран трек 1: измерение цены масштабирования при фиксированном и растущем бюджете ресурсов.
|
||
|
||
## Запуск
|
||
|
||
Требуется Docker Compose v2. Создайте `.env` по `.env.example`, задайте уникальный `POSTGRES_PASSWORD` и запустите:
|
||
|
||
```sh
|
||
cp .env.example .env
|
||
# замените POSTGRES_PASSWORD случайным локальным значением
|
||
|
||
docker compose --env-file .env up -d --build --scale api=2
|
||
curl -i http://127.0.0.1:8080/health/ready
|
||
```
|
||
|
||
Публичен только `127.0.0.1:${APP_PORT}` у HAProxy. У API нет опубликованных host ports. Миграция выполняется отдельным одноразовым сервисом под PostgreSQL advisory lock до старта реплик. Она применима повторно, записывает версии в `schema_migrations` и меняет схему до приема HTTP трафика.
|
||
|
||
HAProxy использует DNS `api` для обнаружения IP Compose-задач, round robin и активный `GET /health/ready` с интервалом 1 секунду (backend исключается после двух неудач, возвращается после двух успехов). DNS-записи проверяются раз в 2 секунды. Connect timeout — 1 секунда, запрос к upstream — 10 секунд. API обрабатывает SIGTERM и закрывает listener; Compose ждёт до 10 секунд перед SIGKILL.
|
||
|
||
## Проверки
|
||
|
||
```sh
|
||
make check
|
||
make validate
|
||
make test BASE_URL=http://127.0.0.1:8080
|
||
make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://127.0.0.1:8080
|
||
make test-idempotency BASE_URL=http://127.0.0.1:8080
|
||
make test-failover ACTION_SCRIPT=scripts/stop-one.sh BASE_URL=http://127.0.0.1:8080
|
||
```
|
||
|
||
Failover проверка останавливает одну конкретную реплику по `X-Instance-Id` (равен Docker hostname/short ID), затем оставляет её остановленной. `docker compose ps` показывает фактическое состояние. Верните реплики командой `docker compose --env-file .env up -d --scale api=2`.
|
||
|
||
Rolling replacement с сохранением второй реплики и живого LB:
|
||
|
||
```sh
|
||
make rolling-update
|
||
```
|
||
|
||
Скрипт сначала добавляет временную третью реплику, ждёт её readiness, затем удаляет старые контейнеры по одному и возвращает пул к двум. Во время операции запустите параллельно `make load` и проверьте, что сообщения читаются после замены.
|
||
|
||
## Трек 1: масштабирование
|
||
|
||
```sh
|
||
make track1
|
||
```
|
||
|
||
Исследование сравнивает 1/2/4 реплики при фиксированном бюджете и 1/2/4/8 при растущем бюджете с общим пределом CPU 2 ядра и памяти 1 GiB, затем выполняет серию с фиксированными лимитами 0,5 CPU / 256 MiB на реплику. Для каждой точки задаётся одинаковая нагрузка `tests/load.py`; healthcheck --wait до 180 секунд и пять секунд стабилизации после смены топологии, затем 30 секунд и concurrency 16 (можно задавать `BENCH_SECONDS`, `BENCH_CONCURRENCY`). Результаты и график создаются в `evidence/track1-results.json` и `evidence/track1-rps.svg`. Для сдачи требуется не менее трёх прогонов каждой точки; сводить нужно медианы и разброс, а в отчёте указать лимиты Docker Desktop, версию runtime, длительность, успешные RPS, долю ошибок и p50/p95/p99.
|
||
|
||
Для поиска точки насыщения есть повторяемый rate-controlled профиль и парный тест лимита API:
|
||
|
||
```sh
|
||
make track1-offered # 8 API: предложенные 250/500/750/1000 RPS, 3 повтора
|
||
make track1-offered-scale # 8 против 12 API при 1000 RPS, 3 повтора
|
||
```
|
||
|
||
`track1-offered` ограничивает число одновременно ожидающих запросов, повторно использует HTTP-клиент в потоках и считает throughput по полной длительности вместе с drain. `track1-offered-scale` возвращает пул к 8 репликам перед очисткой тестовых таблиц, затем поднимает вариант. JSON, график и наблюдение об исчерпании соединений PostgreSQL сохраняются в `evidence/`.
|
||
|
||
Генератор closed-loop, поэтому он подвержен coordinated omission и включает стоимость клиента. На одном Docker-host база и LB также ограничивают результат. Замеры процесса не являются доказательством роста пропускной способности production-системы.
|
||
|
||
## Лимиты и хранение
|
||
|
||
Контейнеры имеют лимиты ресурсов. API реплики не имеют отдельных volumes; общее состояние сообщений и идемпотентных ключей лежит в PostgreSQL. PostgreSQL — источник истины сессий; Valkey хранит только восстанавливаемую TTL-подсказку и включён с AOF. Именованные volumes `postgres_data` и `valkey_data` общие для сервиса, не удаляются restart/failover проверками. На одном узле остаются SPOF: host, HAProxy, PostgreSQL и Valkey-хост (при потере Valkey сессии продолжают проверяться через PostgreSQL).
|