Горизонтальное масштабирование за LB с общими сессиями Redis, X-Instance-Id, обязательным Idempotency-Key в PostgreSQL, сценариями failover/persistence и измерением цены масштабирования при фиксированном CPU/RAM бюджете.
57 lines
2.8 KiB
Markdown
57 lines
2.8 KiB
Markdown
# Как сдать лабораторную 3 (для меня)
|
||
|
||
Краткий чеклист перед защитой и после замечаний ревью.
|
||
|
||
## Что уже сделано в этом PR
|
||
|
||
- База — решение lab2 (PostgreSQL + Redis-сессии + Argon2id).
|
||
- Lab3: HAProxy → API×2+, `X-Instance-Id`, обязательный `Idempotency-Key`, общие сессии, одноразовый `migrate`.
|
||
- Оценка **5**, трек **1** (цена масштабирования): `scripts/run_track1.sh` → `evidence/track1/`.
|
||
- Публичные проверки: `make test`, `test-persistence`, `test-failover` (обе реплики), `make student-test`.
|
||
|
||
## Перед защитой (локально)
|
||
|
||
```sh
|
||
cp .env.example .env
|
||
bash scripts/up.sh
|
||
make check
|
||
make test
|
||
make student-test
|
||
make test-persistence ACTION_SCRIPT=scripts/restart.sh
|
||
bash scripts/restore-one.sh
|
||
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
|
||
bash scripts/restore-one.sh
|
||
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
|
||
# трек 5 — долго (~10–20 мин), пересоздаёт стенд:
|
||
bash scripts/run_track1.sh
|
||
```
|
||
|
||
После трека стенд сам возвращается к `API_REPLICAS=2`.
|
||
|
||
## Что говорить на защите
|
||
|
||
1. Через LB показать ≥2 разных `X-Instance-Id` на одной сессии (без sticky).
|
||
2. `make test-failover ACTION_SCRIPT=scripts/stop-one.sh` — одна реплика down, запись идёт через другую ≤10 с, дублей нет.
|
||
3. Persistence: тот же Bearer после `scripts/restart.sh`.
|
||
4. Трек 1: гипотеза про фиксированный CPU/RAM бюджет; цифры в `evidence/track1/summary.md`.
|
||
5. SPOF: один Docker-host, один HAProxy, одна БД — отказ API-реплики закрыт, узла БД/LB — нет.
|
||
|
||
## PR
|
||
|
||
- Ветка: `solution/bpi2303-belousov`
|
||
- База PR: `mtusi2026/mtusi2026lab3` → `main`
|
||
- Заголовок: `ЛР 3 — БПИ2303 — Белоусов — на 5`
|
||
- Не коммитить `.env`, токены, volumes.
|
||
- После замечаний — пуш в ту же ветку, тот же PR.
|
||
|
||
## Если что-то красное
|
||
|
||
| Симптом | Что проверить |
|
||
| --- | --- |
|
||
| `less than two API instances` | `bash scripts/restore-one.sh`, в `.env` должно быть `API_REPLICAS=2` |
|
||
| failover видит остановленную реплику | у `api` в compose `restart: "no"`; `stop-one.sh` делает `docker stop` |
|
||
| порт 8080 занят | остановить другой стенд (lab2 и т.п.) |
|
||
| student-test не видит БД | Postgres проброшен на `127.0.0.1:5432` |
|
||
|
||
Подробности архитектуры и таблица доказательств — в `REPORT.md`.
|