# Лабораторная 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).