ЛР 3 — БПИ2304 — Кондрашов — на 5 #154

Closed
makkelay wants to merge 1 commits from makkelay/mtusi2026lab3:solution/bpi2304-nikko into main
First-time contributor

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

Автор / группа: Кондрашов Никита / БПИ2304
Целевая оценка (3/4/5): 5
Трек 5: трек 1 — цена масштабирования API

Что реализовано и что перенесено: Перенесены пользователи, чаты, участники, сообщения, keyset-пагинация и Bearer-сессии из предыдущей лабораторной. Добавлены PostgreSQL, отдельный запуск миграций, Redis как общий кэш профилей, HAProxy и две API-реплики. Идемпотентность сообщений хранится в PostgreSQL: конкурентные запросы с одинаковым ключом создают одно сообщение, а повтор ключа с другим телом возвращает 409. Добавлены health/readiness checks, graceful shutdown, failover и последовательный перезапуск реплик.

Команды запуска из чистого clone (выполнять из корня mtusi2026lab3):

[ -f .env ] || cp .env.example .env
mkdir -p secrets
[ -f secrets/database_password ] || openssl rand -hex 32 > secrets/database_password
chmod 600 secrets/database_password

docker compose --env-file .env config --quiet
docker compose --env-file .env build api migrate
docker compose --env-file .env up -d postgres redis
docker compose --env-file .env run --rm migrate
docker compose --env-file .env up -d --scale api=2 api load_balancer
docker compose --env-file .env ps

Дождаться статуса healthy, затем проверить сервис:

curl --fail http://localhost:8080/health/ready
make check
make validate
make test
make test-grade4
make test-persistence ACTION_SCRIPT=scripts/restart.sh

Проверка отказа каждой API-реплики:

for c in $(docker compose ps -q api); do
  docker inspect --format '{{.Config.Hostname}}' "$c"
done

Подставить один из выведенных hostname в TARGET_INSTANCE_ID, восстановить две реплики после теста и повторить со вторым:

make test-failover-target TARGET_INSTANCE_ID=ВСТАВЬТЕ_HOSTNAME OUTPUT=evidence/failover-api1.json
docker compose --env-file .env up -d --scale api=2 api
make test-failover-target TARGET_INSTANCE_ID=ВСТАВЬТЕ_HOSTNAME OUTPUT=evidence/failover-api2.json
docker compose --env-file .env up -d --scale api=2 api

Для проверки rolling restart запустить make load OUTPUT=evidence/rolling-restart-load.json и make rolling-restart одновременно в двух терминалах. Эксперимент трека 5:

python3 scripts/benchmark.py --duration 10 --concurrency 8 --repeats 3

Результаты проверок и ссылка на REPORT.md: make check, make validate, Compose config, make test, make test-grade4, make test-persistence, отказы обеих реплик и rolling restart под нагрузкой выполнены. Smoke, контракт, конкурирующая идемпотентность и persistence прошли. Восстановление записей после отказов — 2,463 и 2,529 с; при rolling restart за 30 секунд выполнено 11 200 успешных запросов и зарегистрирована 1 ошибка. Подробные результаты и ограничения — в REPORT.md, итоговый вывод проверок — в evidence/acceptance.log. Результаты трека масштабирования — в evidence/benchmark/summary.csv и графике: при фиксированном бюджете 1 CPU/512 MiB throughput составил 319/267/186 RPS для 1/2/4 реплик; при удвоении бюджета для двух реплик — 564 RPS, дальнейшее увеличение до четырёх реплик дало 568 RPS.

Ограничения / известные ошибки: Локальный single-node Compose. PostgreSQL, HAProxy и Docker host не реплицированы; их отказ не проверялся. Нагрузочный тест closed-loop и характеризует только этот стенд и профиль.

Источники и использование ИИ: использовался при исправлении ошибок, проверке изменений и подготовке документации.

  • Обязательный минимум лабораторной реализован; межлабораторные переходы описаны в REPORT.md.
  • Контракт и публичные тесты не ослаблялись.
  • make check, make validate, make test и дополнительные проверки выполнены; вывод сохранён в evidence.
  • Проверены persistence, отказ каждой API-реплики и rolling restart под нагрузкой.
  • Секреты находятся в локальных игнорируемых файлах; отчёт и тестовые доказательства не содержат токенов.
  • README задания сохранён; REPORT.md описывает запуск, архитектуру, эксперименты и ограничения.
## Лабораторная 3 Автор / группа: Кондрашов Никита / БПИ2304 Целевая оценка (3/4/5): 5 Трек 5: трек 1 — цена масштабирования API Что реализовано и что перенесено: Перенесены пользователи, чаты, участники, сообщения, keyset-пагинация и Bearer-сессии из предыдущей лабораторной. Добавлены PostgreSQL, отдельный запуск миграций, Redis как общий кэш профилей, HAProxy и две API-реплики. Идемпотентность сообщений хранится в PostgreSQL: конкурентные запросы с одинаковым ключом создают одно сообщение, а повтор ключа с другим телом возвращает 409. Добавлены health/readiness checks, graceful shutdown, failover и последовательный перезапуск реплик. Команды запуска из чистого clone (выполнять из корня `mtusi2026lab3`): ```sh [ -f .env ] || cp .env.example .env mkdir -p secrets [ -f secrets/database_password ] || openssl rand -hex 32 > secrets/database_password chmod 600 secrets/database_password docker compose --env-file .env config --quiet docker compose --env-file .env build api migrate docker compose --env-file .env up -d postgres redis docker compose --env-file .env run --rm migrate docker compose --env-file .env up -d --scale api=2 api load_balancer docker compose --env-file .env ps ``` Дождаться статуса `healthy`, затем проверить сервис: ```sh curl --fail http://localhost:8080/health/ready make check make validate make test make test-grade4 make test-persistence ACTION_SCRIPT=scripts/restart.sh ``` Проверка отказа каждой API-реплики: ```sh for c in $(docker compose ps -q api); do docker inspect --format '{{.Config.Hostname}}' "$c" done ``` Подставить один из выведенных hostname в `TARGET_INSTANCE_ID`, восстановить две реплики после теста и повторить со вторым: ```sh make test-failover-target TARGET_INSTANCE_ID=ВСТАВЬТЕ_HOSTNAME OUTPUT=evidence/failover-api1.json docker compose --env-file .env up -d --scale api=2 api make test-failover-target TARGET_INSTANCE_ID=ВСТАВЬТЕ_HOSTNAME OUTPUT=evidence/failover-api2.json docker compose --env-file .env up -d --scale api=2 api ``` Для проверки rolling restart запустить `make load OUTPUT=evidence/rolling-restart-load.json` и `make rolling-restart` одновременно в двух терминалах. Эксперимент трека 5: ```sh python3 scripts/benchmark.py --duration 10 --concurrency 8 --repeats 3 ``` Результаты проверок и ссылка на REPORT.md: `make check`, `make validate`, Compose config, `make test`, `make test-grade4`, `make test-persistence`, отказы обеих реплик и rolling restart под нагрузкой выполнены. Smoke, контракт, конкурирующая идемпотентность и persistence прошли. Восстановление записей после отказов — 2,463 и 2,529 с; при rolling restart за 30 секунд выполнено 11 200 успешных запросов и зарегистрирована 1 ошибка. Подробные результаты и ограничения — в [REPORT.md](../REPORT.md), итоговый вывод проверок — в [evidence/acceptance.log](../evidence/acceptance.log). Результаты трека масштабирования — в [evidence/benchmark/summary.csv](../evidence/benchmark/summary.csv) и [графике](../evidence/benchmark/throughput.svg): при фиксированном бюджете 1 CPU/512 MiB throughput составил 319/267/186 RPS для 1/2/4 реплик; при удвоении бюджета для двух реплик — 564 RPS, дальнейшее увеличение до четырёх реплик дало 568 RPS. Ограничения / известные ошибки: Локальный single-node Compose. PostgreSQL, HAProxy и Docker host не реплицированы; их отказ не проверялся. Нагрузочный тест closed-loop и характеризует только этот стенд и профиль. Источники и использование ИИ: использовался при исправлении ошибок, проверке изменений и подготовке документации. - [x] Обязательный минимум лабораторной реализован; межлабораторные переходы описаны в REPORT.md. - [x] Контракт и публичные тесты не ослаблялись. - [x] `make check`, `make validate`, `make test` и дополнительные проверки выполнены; вывод сохранён в evidence. - [x] Проверены persistence, отказ каждой API-реплики и rolling restart под нагрузкой. - [x] Секреты находятся в локальных игнорируемых файлах; отчёт и тестовые доказательства не содержат токенов. - [x] README задания сохранён; REPORT.md описывает запуск, архитектуру, эксперименты и ограничения.
makkelay added 1 commit 2026-11-15 22:26:42 +03:00
makkelay changed title from [+] add project to ЛР 3 — БПИ2304 — Кондрашов — на 5 2026-11-15 22:27:14 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-19 15:19:01 +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#154