forked from mtusi2026/mtusi2026lab3
70 lines
4.4 KiB
Markdown
70 lines
4.4 KiB
Markdown
## Лабораторная 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` содержит инструкцию именно моего решения. |