## Лабораторная 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 ```bash 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](./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, идемпотентности и структуры отчёта; реализация, прогоны и цифры — авторские. --- - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] `make check` и `make test` выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, `REPORT.md` содержит инструкцию именно моего решения.