Files
mtusi2026lab3/.github/pull_request_template.md

70 lines
4.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## Лабораторная 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` содержит инструкцию именно моего решения.