Files
mtusi2026lab3/docs/pull_request_lab3.md
T

5.7 KiB

Лабораторная 3

Автор / группа: Кушнаренко Николай Вячеславович, БПИ2302

Целевая оценка (3/4/5): 5

Трек 5: Трек 1 — цена масштабирования.

Что реализовано и что перенесено: Перенесён мессенджер из ЛР2: PostgreSQL, сессии Bearer, кэш Valkey, миграции и проверки доступа. Добавлены HAProxy и несколько stateless API-реплик с общими сессиями; наружу опубликован только балансировщик. Отправка сообщений требует Idempotency-Key: повторы через разные реплики возвращают прежнее сообщение, другое тело с тем же ключом даёт 409. Ключ и сообщение сохраняются атомарно в PostgreSQL. Добавлены X-Instance-Id, graceful shutdown, скрипты перезапуска, остановки реплики, восстановления и rolling update.

Трек 1: исследованы 1/2/4 реплики при фиксированных суммарных CPU и RAM, а также рост ресурсов до 8 реплик. Измерена загрузка компонентов и выявлено насыщение PostgreSQL. Сравнены несколько SQL-запросов на отправку с одной серверной функцией. Историческая серия A имела постоянный CPU, но растущую RAM; методика исправлена, серия повторена 11.11.2026 при суммарных 2 CPU и 1024 MiB RAM. Новые данные сохранены отдельно от октябрьских. Пиковый средний RPS в повторной серии A вырос на 25.0 % при одинаковых ресурсах.

Команды запуска из чистого clone:

sh scripts/init-secrets.sh
cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
# Дождаться /health/ready, затем:
python3 tests/smoke.py --base-url http://127.0.0.1:8080
python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://127.0.0.1:8080
python3 tests/resilience.py --mode failover --action-script scripts/stop-one.sh --base-url http://127.0.0.1:8080
sh scripts/restore-replicas.sh

На Windows: PYTHONUTF8=1, вместо .sh в тестах использовать scripts/restart.cmd и scripts/stop-one.cmd. Подробности — REPORT.md.

Результаты проверок:

  • 11.11.2026: smoke, persistence и failover — PASS; 31 собственный тест API, идемпотентности, топологии, expiry и отказов зависимостей — OK.
  • Полная валидация OpenAPI — PASS. Команды и вывод — evidence/checks_2026-11-11.txt.
  • Исторические эксперименты: поочерёдный отказ реплик без потерь и дублей подтверждённых сообщений; rolling update без клиентских ошибок. Данные — evidence/failover_sequence.json, evidence/rolling_update.json.
  • Исследование масштабирования: исходные JSON, график и разбор лимитов, узкого места и улучшения — в evidence/ и REPORT.md. Даты новых и исторических замеров указаны раздельно.

Ограничения / известные ошибки: Стенд на одном Docker-хосте, HAProxy и PostgreSQL остаются единичными точками отказа. Отказ хоста не покрывается. Возможна временно устаревшая запись кэша сессии, если Valkey недоступен при logout. Эксперименты выполнены на одном компьютере; в повторе 11.11.2026 присутствовала фоновая нагрузка другого Docker-проекта. Два повтора не дают оценки статистической значимости.

Источники и использование ИИ: Python, uvicorn, asyncpg, redis-py, argon2-cffi; PostgreSQL, Valkey, HAProxy; aiohttp и matplotlib для экспериментов. ИИ-ассистенты использовались для помощи с кодом, тестами и отчётом. Codex проверил подготовку к сдаче, исправил методику фиксации RAM и повторил проверки.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • Проверки, эквивалентные make check и make test, выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Секреты и приватные ключи находятся вне Git; отчёт не содержит токенов.
  • README задания сохранён, REPORT.md содержит инструкцию запуска решения.