Files
mtusi2026lab3/.github/pull_request_template.md
T
2026-11-15 22:00:21 +03:00

5.8 KiB
Raw Blame History

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

[ -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, затем проверить сервис:

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-реплики:

for c in $(docker compose ps -q api); do
  docker inspect --format '{{.Config.Hostname}}' "$c"
done

Подставить один из выведенных hostname в TARGET_INSTANCE_ID, восстановить две реплики после теста и повторить со вторым:

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:

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, итоговый вывод проверок — в evidence/acceptance.log. Результаты трека масштабирования — в evidence/benchmark/summary.csv и графике: при фиксированном бюджете 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. ИИ использовался при исправлении ошибок, проверке изменений и подготовке документации.

  • Обязательный минимум лабораторной реализован; межлабораторные переходы описаны в REPORT.md.
  • Контракт и публичные тесты не ослаблялись.
  • make check, make validate, make test и дополнительные проверки выполнены; вывод сохранён в evidence.
  • Проверены persistence, отказ каждой API-реплики и rolling restart под нагрузкой.
  • Секреты находятся в локальных игнорируемых файлах; отчёт и тестовые доказательства не содержат токенов.
  • README задания сохранён; REPORT.md описывает запуск, архитектуру, эксперименты и ограничения.