Files
mtusi2026lab3/.github/pull_request_template.md

4.4 KiB
Raw Permalink Blame History

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