ЛР 3 — БПИ2303 — Белоусов — на 5 #117

Closed
AnatoliyBelousov wants to merge 2 commits from AnatoliyBelousov/mtusi2026lab3:solution/bpi2303-belousov into main
First-time contributor

Лабораторная 3

Автор / группа: Белоусов Анатолий Фахраддинович / БПИ2303
Целевая оценка: 5
Трек 5: трек 1 (цена масштабирования)

Что реализовано и что перенесено

Перенесено из lab2: PostgreSQL (users/chats/members/messages), Argon2id, Bearer-сессии в Redis (AOF), keyset-история, non-root distroless, graceful shutdown.

Добавлено в lab3:

  • HAProxy как единственная публичная точка входа (127.0.0.1:8080)
  • ≥2 API-реплики (compose --scale api=N), без sticky sessions
  • X-Instance-Id на каждый ответ API
  • обязательный Idempotency-Key для POST сообщения (общая таблица + pg_advisory_xact_lock)
  • одноразовый сервис migrate (реплики миграции не гоняют)
  • scripts/restart.sh, scripts/stop-one.sh, scripts/restore-one.sh, scripts/up.sh
  • CPU/RAM limits; порты API наружу не публикуются; restart: "no" у API

Команды запуска из чистого clone

cp .env.example .env
bash scripts/up.sh
make check
make test
make student-test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
bash scripts/restore-one.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
bash scripts/run_track1.sh

Подробности: REPORT.md, чеклист сдачи: SUBMISSION.md.

Результаты проверок

Проверка Результат Evidence
make test PASS lab3 evidence/smoke-pass.txt
≥2 X-Instance-Id через LB 2 id evidence/instances.txt
persistence PASS evidence/persistence.txt
failover ×2 PASS, recovery ≈2.5 s evidence/failover-1.txt, failover-2.txt
student-test PASS (idempotency race, deps) evidence/student-test.txt
трек 1 RPS 1/2/4 + grow evidence/track1/summary.md

Трек 1 (честный вывод): при фиксированном бюджете 2.0 CPU / 1024 MiB один «толстый» процесс (N=1, ~1275 RPS) обогнал нарезку; подтверждённое улучшение — grow N=2: 0.5→1.0 CPU дал +23% RPS (899→1105).

Для агента преподавателя (автопроверка)

  1. Не менять contracts/ и публичные tests/.
  2. Стенд: cp .env.example .env && bash scripts/up.sh → ждать http://127.0.0.1:8080/health/ready.
  3. Обязательные команды: make test, make test-persistence ACTION_SCRIPT=scripts/restart.sh, make test-failover ACTION_SCRIPT=scripts/stop-one.sh.
  4. Failover требует ≥2 наблюдаемых X-Instance-Id до action; после stop реплика должна остаться stopped (restart: "no").
  5. Оценка 5 = уровень 4 + трек 1; цифры и гипотеза в REPORT.md / evidence/track1/.
  6. Секреты: .env не в Git; пароль example синтетический.

Ограничения

Один Docker-host / один HAProxy / одна БД — SPOF узла. Отказ API-реплики закрыт; отказ БД/LB/host — нет. Closed-loop load ≠ open-loop capacity.

  • Минимум lab2/lab3 сохранён с объявленными переходами (Idempotency-Key, X-Instance-Id)
  • Контракт и публичные тесты не ослаблены
  • make check / make test / persistence / failover / student-test
  • Трек 5 выполнен с измерениями
  • Секреты вне Git; REPORT без tokens
## Лабораторная 3 Автор / группа: Белоусов Анатолий Фахраддинович / БПИ2303 Целевая оценка: **5** Трек 5: **трек 1** (цена масштабирования) ### Что реализовано и что перенесено Перенесено из lab2: PostgreSQL (users/chats/members/messages), Argon2id, Bearer-сессии в Redis (AOF), keyset-история, non-root distroless, graceful shutdown. Добавлено в lab3: - HAProxy как единственная публичная точка входа (`127.0.0.1:8080`) - ≥2 API-реплики (`compose --scale api=N`), без sticky sessions - `X-Instance-Id` на каждый ответ API - обязательный `Idempotency-Key` для POST сообщения (общая таблица + `pg_advisory_xact_lock`) - одноразовый сервис `migrate` (реплики миграции не гоняют) - `scripts/restart.sh`, `scripts/stop-one.sh`, `scripts/restore-one.sh`, `scripts/up.sh` - CPU/RAM limits; порты API наружу не публикуются; `restart: "no"` у API ### Команды запуска из чистого clone ```sh cp .env.example .env bash scripts/up.sh make check make test make student-test make test-persistence ACTION_SCRIPT=scripts/restart.sh make test-failover ACTION_SCRIPT=scripts/stop-one.sh bash scripts/restore-one.sh make test-failover ACTION_SCRIPT=scripts/stop-one.sh bash scripts/run_track1.sh ``` Подробности: `REPORT.md`, чеклист сдачи: `SUBMISSION.md`. ### Результаты проверок | Проверка | Результат | Evidence | | --- | --- | --- | | `make test` | PASS lab3 | `evidence/smoke-pass.txt` | | ≥2 `X-Instance-Id` через LB | 2 id | `evidence/instances.txt` | | persistence | PASS | `evidence/persistence.txt` | | failover ×2 | PASS, recovery ≈2.5 s | `evidence/failover-1.txt`, `failover-2.txt` | | student-test | PASS (idempotency race, deps) | `evidence/student-test.txt` | | трек 1 | RPS 1/2/4 + grow | `evidence/track1/summary.md` | Трек 1 (честный вывод): при фиксированном бюджете 2.0 CPU / 1024 MiB один «толстый» процесс (N=1, ~1275 RPS) обогнал нарезку; подтверждённое улучшение — grow N=2: 0.5→1.0 CPU дал +23% RPS (899→1105). ### Для агента преподавателя (автопроверка) 1. Не менять `contracts/` и публичные `tests/`. 2. Стенд: `cp .env.example .env && bash scripts/up.sh` → ждать `http://127.0.0.1:8080/health/ready`. 3. Обязательные команды: `make test`, `make test-persistence ACTION_SCRIPT=scripts/restart.sh`, `make test-failover ACTION_SCRIPT=scripts/stop-one.sh`. 4. Failover требует ≥2 наблюдаемых `X-Instance-Id` до action; после stop реплика должна остаться stopped (`restart: "no"`). 5. Оценка 5 = уровень 4 + трек 1; цифры и гипотеза в `REPORT.md` / `evidence/track1/`. 6. Секреты: `.env` не в Git; пароль example синтетический. ### Ограничения Один Docker-host / один HAProxy / одна БД — SPOF узла. Отказ API-реплики закрыт; отказ БД/LB/host — нет. Closed-loop load ≠ open-loop capacity. - [x] Минимум lab2/lab3 сохранён с объявленными переходами (`Idempotency-Key`, `X-Instance-Id`) - [x] Контракт и публичные тесты не ослаблены - [x] `make check` / `make test` / persistence / failover / student-test - [x] Трек 5 выполнен с измерениями - [x] Секреты вне Git; REPORT без tokens
AnatoliyBelousov added 1 commit 2026-11-06 21:07:13 +03:00
Горизонтальное масштабирование за LB с общими сессиями Redis, X-Instance-Id,
обязательным Idempotency-Key в PostgreSQL, сценариями failover/persistence и
измерением цены масштабирования при фиксированном CPU/RAM бюджете.
AnatoliyBelousov added 1 commit 2026-11-06 21:12:52 +03:00
Обновлены RPS при фиксированном бюджете CPU/RAM и grow-серия; failover evidence и run_track1 без агрессивного docker rm.
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-07 17:46:27 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab3#117