ЛР 3 — БПИ2302 — Мякишев — на 4 #63

Closed
vest1ter wants to merge 2 commits from vest1ter/mtusi2026lab3:solution/bpi2302-myakishev into main
First-time contributor

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

Автор / группа: Мякишев Владислав, БПИ2302
Целевая оценка (3/4/5): 4

Что реализовано и что перенесено: из lab2 перенесены приложение (FastAPI + SQLAlchemy), миграции, Argon2id, JWT + серверные сессии в PostgreSQL, свои тесты. В lab3 добавлены X-Instance-Id, обязательный Idempotency-Key (таблица idempotency_keys, одна транзакция, конкурентные повторы через уникальный индекс), graceful shutdown (SIGTERM -> ready=503 -> drain 3 с), стенд HAProxy + 2 реплики API без портов наружу + разовый migrate + PostgreSQL с лимитами CPU/RAM, хуки stop-one/restart/restore-replicas и scripts/experiments.py.

Команды запуска из чистого clone:
powershell -ExecutionPolicy Bypass -File scripts\init-secrets.ps1 (Linux: sh scripts/init-secrets.sh)
docker compose --env-file .env up -d --build --wait
python tests/smoke.py --base-url http://localhost:8080
Подробно (persistence, failover, эксперименты, свои тесты) — REPORT.md, раздел «Запуск из чистого clone».

Результаты проверок и ссылка на REPORT.md: make check и smoke PASS; pytest 44 passed; persistence PASS; failover PASS для обеих реплик (восстановление 4.85/5.46 с, 0 неудачных попыток); остановка каждой реплики под нагрузкой (2 серии) — 0 ошибок, 0 потерь, 0 дублей; 480 параллельных запросов с 30 ключами — по одному сообщению на ключ; rolling update 2 -> 4 -> 2 под нагрузкой — 0 ошибок. Вывод и JSON в evidence/, разбор — REPORT.md.

Ограничения / известные ошибки: LB и PostgreSQL — единые точки отказа (одна машина, без репликации БД); оборванный запрос клиент должен повторить с тем же ключом; idempotency_keys не очищается периодически; ответы самого LB без X-Request-Id; обычный docker compose up --build пересоздаёт все реплики разом (без простоя — rolling-скрипт).

Источники и использование ИИ: документация Compose, HAProxy 3.0, PostgreSQL; при разработке использовался ИИ-ассистент Claude (код, конфигурация); все запуски и измерения выполнены на стенде автора.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 Автор / группа: Мякишев Владислав, БПИ2302 Целевая оценка (3/4/5): 4 Что реализовано и что перенесено: из lab2 перенесены приложение (FastAPI + SQLAlchemy), миграции, Argon2id, JWT + серверные сессии в PostgreSQL, свои тесты. В lab3 добавлены X-Instance-Id, обязательный Idempotency-Key (таблица idempotency_keys, одна транзакция, конкурентные повторы через уникальный индекс), graceful shutdown (SIGTERM -> ready=503 -> drain 3 с), стенд HAProxy + 2 реплики API без портов наружу + разовый migrate + PostgreSQL с лимитами CPU/RAM, хуки stop-one/restart/restore-replicas и scripts/experiments.py. Команды запуска из чистого clone: powershell -ExecutionPolicy Bypass -File scripts\init-secrets.ps1 (Linux: sh scripts/init-secrets.sh) docker compose --env-file .env up -d --build --wait python tests/smoke.py --base-url http://localhost:8080 Подробно (persistence, failover, эксперименты, свои тесты) — REPORT.md, раздел «Запуск из чистого clone». Результаты проверок и ссылка на REPORT.md: make check и smoke PASS; pytest 44 passed; persistence PASS; failover PASS для обеих реплик (восстановление 4.85/5.46 с, 0 неудачных попыток); остановка каждой реплики под нагрузкой (2 серии) — 0 ошибок, 0 потерь, 0 дублей; 480 параллельных запросов с 30 ключами — по одному сообщению на ключ; rolling update 2 -> 4 -> 2 под нагрузкой — 0 ошибок. Вывод и JSON в evidence/, разбор — REPORT.md. Ограничения / известные ошибки: LB и PostgreSQL — единые точки отказа (одна машина, без репликации БД); оборванный запрос клиент должен повторить с тем же ключом; idempotency_keys не очищается периодически; ответы самого LB без X-Request-Id; обычный `docker compose up --build` пересоздаёт все реплики разом (без простоя — rolling-скрипт). Источники и использование ИИ: документация Compose, HAProxy 3.0, PostgreSQL; при разработке использовался ИИ-ассистент Claude (код, конфигурация); все запуски и измерения выполнены на стенде автора. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
vest1ter added 2 commits 2026-10-29 11:25:19 +03:00
- X-Instance-Id в каждом ответе; обязательный Idempotency-Key, таблица idempotency_keys
  (миграция 0002, одна транзакция, конкурентные повторы через уникальный индекс)
- graceful shutdown: SIGTERM -> ready=503 -> drain 3 с -> закрытие порта
- compose: lb (HAProxy) + api x2 без портов + разовый migrate + postgres, лимиты CPU/RAM
- хуки stop-one/restart/restore-replicas, scripts/experiments.py (failover, idempotency, rolling)
- свои тесты: 44 (13 новых); evidence: smoke, pytest, persistence, failover, эксперименты
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-31 00:08:42 +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#63