## Лабораторная 3 Автор / группа: Кондрашов Никита / БПИ2304 Целевая оценка (3/4/5): 5 Трек 5: трек 1 — цена масштабирования API Что реализовано и что перенесено: Перенесены пользователи, чаты, участники, сообщения, keyset-пагинация и Bearer-сессии из предыдущей лабораторной. Добавлены PostgreSQL, отдельный запуск миграций, Redis как общий кэш профилей, HAProxy и две API-реплики. Идемпотентность сообщений хранится в PostgreSQL: конкурентные запросы с одинаковым ключом создают одно сообщение, а повтор ключа с другим телом возвращает 409. Добавлены health/readiness checks, graceful shutdown, failover и последовательный перезапуск реплик. Команды запуска из чистого clone (выполнять из корня `mtusi2026lab3`): ```sh [ -f .env ] || cp .env.example .env mkdir -p secrets [ -f secrets/database_password ] || openssl rand -hex 32 > secrets/database_password chmod 600 secrets/database_password docker compose --env-file .env config --quiet docker compose --env-file .env build api migrate docker compose --env-file .env up -d postgres redis docker compose --env-file .env run --rm migrate docker compose --env-file .env up -d --scale api=2 api load_balancer docker compose --env-file .env ps ``` Дождаться статуса `healthy`, затем проверить сервис: ```sh curl --fail http://localhost:8080/health/ready make check make validate make test make test-grade4 make test-persistence ACTION_SCRIPT=scripts/restart.sh ``` Проверка отказа каждой API-реплики: ```sh for c in $(docker compose ps -q api); do docker inspect --format '{{.Config.Hostname}}' "$c" done ``` Подставить один из выведенных hostname в `TARGET_INSTANCE_ID`, восстановить две реплики после теста и повторить со вторым: ```sh make test-failover-target TARGET_INSTANCE_ID=ВСТАВЬТЕ_HOSTNAME OUTPUT=evidence/failover-api1.json docker compose --env-file .env up -d --scale api=2 api make test-failover-target TARGET_INSTANCE_ID=ВСТАВЬТЕ_HOSTNAME OUTPUT=evidence/failover-api2.json docker compose --env-file .env up -d --scale api=2 api ``` Для проверки rolling restart запустить `make load OUTPUT=evidence/rolling-restart-load.json` и `make rolling-restart` одновременно в двух терминалах. Эксперимент трека 5: ```sh python3 scripts/benchmark.py --duration 10 --concurrency 8 --repeats 3 ``` Результаты проверок и ссылка на REPORT.md: `make check`, `make validate`, Compose config, `make test`, `make test-grade4`, `make test-persistence`, отказы обеих реплик и rolling restart под нагрузкой выполнены. Smoke, контракт, конкурирующая идемпотентность и persistence прошли. Восстановление записей после отказов — 2,463 и 2,529 с; при rolling restart за 30 секунд выполнено 11 200 успешных запросов и зарегистрирована 1 ошибка. Подробные результаты и ограничения — в [REPORT.md](../REPORT.md), итоговый вывод проверок — в [evidence/acceptance.log](../evidence/acceptance.log). Результаты трека масштабирования — в [evidence/benchmark/summary.csv](../evidence/benchmark/summary.csv) и [графике](../evidence/benchmark/throughput.svg): при фиксированном бюджете 1 CPU/512 MiB throughput составил 319/267/186 RPS для 1/2/4 реплик; при удвоении бюджета для двух реплик — 564 RPS, дальнейшее увеличение до четырёх реплик дало 568 RPS. Ограничения / известные ошибки: Локальный single-node Compose. PostgreSQL, HAProxy и Docker host не реплицированы; их отказ не проверялся. Нагрузочный тест closed-loop и характеризует только этот стенд и профиль. Источники и использование ИИ: использованы контракт и тесты лабораторной, документация Docker Compose и HAProxy. ИИ использовался при исправлении ошибок, проверке изменений и подготовке документации. - [x] Обязательный минимум лабораторной реализован; межлабораторные переходы описаны в REPORT.md. - [x] Контракт и публичные тесты не ослаблялись. - [x] `make check`, `make validate`, `make test` и дополнительные проверки выполнены; вывод сохранён в evidence. - [x] Проверены persistence, отказ каждой API-реплики и rolling restart под нагрузкой. - [x] Секреты находятся в локальных игнорируемых файлах; отчёт и тестовые доказательства не содержат токенов. - [x] README задания сохранён; REPORT.md описывает запуск, архитектуру, эксперименты и ограничения.