Files
mtusi2026lab3/docs/pull_request_lab3.md

49 lines
5.7 KiB
Markdown

## Лабораторная 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
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](https://gitea.privcloud.tech/kolya/mtusi2026lab3/src/branch/solution/bpi2302-kushnarenko/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 и повторил проверки.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] Проверки, эквивалентные make check и make test, выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Секреты и приватные ключи находятся вне Git; отчёт не содержит токенов.
- [x] README задания сохранён, REPORT.md содержит инструкцию запуска решения.