Files
mtusi2026lab3/SUBMISSION.md
T
Mlvn b1972bcfd8 Реализовать lab3: HAProxy, API×N, идемпотентность и трек 1.
Горизонтальное масштабирование за LB с общими сессиями Redis, X-Instance-Id,
обязательным Idempotency-Key в PostgreSQL, сценариями failover/persistence и
измерением цены масштабирования при фиксированном CPU/RAM бюджете.
2026-11-06 21:07:00 +03:00

57 lines
2.8 KiB
Markdown
Raw 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 (для меня)
Краткий чеклист перед защитой и после замечаний ревью.
## Что уже сделано в этом 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`.