forked from mtusi2026/mtusi2026lab3
4.4 KiB
4.4 KiB
Лабораторная 3
Автор / группа: Гуреев Дмитрий, БПИ2301
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: Трек 1 — «Цена масштабирования»
Что реализовано и что перенесено
Перенесено из lab2: in-memory → PostgreSQL + Flyway, JPA, регистрация с password KDF, Basic → opaque Bearer-сессии (PG + Redis TTL), чаты/участники/сообщения, курсорная пагинация, идемпотентность сообщений, Compose (db, redis, api), REPORT.md.
Новое в lab3:
- несколько реплик API за nginx (
--scale api=N), без publish портов api на хост; /health/live,/health/ready, graceful shutdown (markNotReady+server.shutdown);- заголовки
X-Request-Id,X-Instance-Id; - one-shot migrate, у api
FLYWAY_ENABLED=false; scripts/restart.sh(рестарт без удаления volumes);- CPU/RAM limits на api, без
container_nameу масштабируемого api; - сценарии отказа реплик, rolling-замена под нагрузкой, параллельная идемпотентность;
- эксперимент Трека 1 (фиксированный суммарный CPU/RAM, 1/2/4 реплики, saturation, одно улучшение) — детали в
REPORT.md.
Команды запуска из чистого clone
git clone https://gitea.privcloud.tech/Dmitry/mtusi2026lab3
cd mtusi2026lab3/Lido
cp .env.example .env # при наличии; секреты не коммитить
docker compose build
docker compose run --rm migrate
docker compose up -d --scale api=3
curl -sf http://127.0.0.1:8080/health/live
curl -sf http://127.0.0.1:8080/health/ready
cd ..
make test BASE_URL=http://127.0.0.1:8080
# make test-persistence ACTION_SCRIPT=scripts/restart.sh
cd Lido && docker compose stop # безопасная остановка
# docker compose down -v # только для полного сброса учебных данных
Результаты проверок и ссылка на REPORT.md
make test— PASS (smoke публичного контракта черезBASE_URLна nginx).- Persistence / restart — hook без
down -v, данные и сессии сохраняются. - Отказ реплик: recovery live через LB ~3.8 / 4.4 / 7.2 s; в окне stop при 20 VU — порядка ~21% неуспешных live-проверок.
- Идемпотентность: 20 параллельных POST с одним ключом → один
message.id; другой body → 409.
Подробные таблицы, методика Трека 1, ограничения: REPORT.md.
Ограничения / известные ошибки
- PostgreSQL и nginx — SPOF; отказ узла БД не маскируется и не заявляется как пережитый.
- Redis — кэш сессий; source of truth — PG.
- Один хост Docker; k6 на той же машине искажает «чистый» RPS.
- Dev-пароли только через env, не в образе и не в отчёте (токенов в REPORT нет).
Источники и использование ИИ
Документация Spring Boot, PostgreSQL, Redis, nginx, Flyway, k6. ИИ — разбор multi-instance, health, идемпотентности и структуры отчёта; реализация, прогоны и цифры — авторские.
- Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- Контракт и публичные тесты не ослаблены.
make checkиmake testвыполнены; приложен реальный вывод.- Сценарии отказов/безопасности своего уровня воспроизведены.
- Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- README задания сохранён,
REPORT.mdсодержит инструкцию именно моего решения.