koichakaev aa33e40ee5 Добавить результаты нагрузочных проверок
Сохранить доказательства выполнения лабораторной работы 3.
2026-11-06 19:14:21 +03:00

Лабораторная 3. Балансировка и отказ API-реплики

Решение сохраняет API и постоянные данные ЛР2, добавляет HAProxy, масштабируемый пул API-реплик, общие PostgreSQL/Valkey, X-Instance-Id и атомарный Idempotency-Key для POST сообщений. На «5» выбран трек 1: измерение цены масштабирования при фиксированном и растущем бюджете ресурсов.

Запуск

Требуется Docker Compose v2. Создайте .env по .env.example, задайте уникальный POSTGRES_PASSWORD и запустите:

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.

Проверки

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:

make rolling-update

Скрипт сначала добавляет временную третью реплику, ждёт её readiness, затем удаляет старые контейнеры по одному и возвращает пул к двум. Во время операции запустите параллельно make load и проверьте, что сообщения читаются после замены.

Трек 1: масштабирование

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:

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).

S
Description
No description provided
Readme
74 KiB
Languages
Python 93.6%
Makefile 3.4%
Shell 3%