Files
mtusi2026lab3/README.md
T

64 lines
6.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Лабораторная 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).