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 содержит инструкцию запуска решения.