ЛР 3 - БВТ2302 - Миронов - на 4 #56

Closed
ALMiron wants to merge 2 commits from ALMiron/mtusi2026lab3-fork:solution/bvt2302-mironov into main
First-time contributor

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

Автор / группа: Миронов Алексей, бвт2302
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен

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

  • Реализована схема FastAPI × 2+ за HAProxy в Docker Compose; API-реплики используют общие PostgreSQL и Redis.
  • Перенесены компоненты и функциональность лабораторной 2: REST API, схема пользователей/чатов/сообщений, Redis-сессии, Argon2, пагинация, формат ошибок и соответствующие зависимости/примеры.
  • Для лабораторной 3 добавлены X-Instance-Id, PostgreSQL-идемпотентность POST сообщений с конкурентной обработкой ключей, миграции отдельным сервисом, health/readiness endpoints, graceful shutdown, ограничения ресурсов и сценарии проверки отказов/перезапуска/нагрузки.
  • HAProxy настроен на балансировку API и проверки /health/ready; публично опубликована единая точка входа, API-порты не опубликованы напрямую.

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

cp .env.example .env
make check
pip install -r requirements-dev.txt
make validate
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --scale api=2
curl -i http://localhost:8080/health/ready
make test
python tests/grade4_checks.py
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh

Результаты проверок и ссылка на REPORT.md:

  • REPORT.md — исходный шаблон отчёта курса; описание данного решения и инструкции находятся в REPORT1.md.
  • Офлайн-проверка структуры/контрактов и синтаксиса Python выполнялась в среде подготовки. Полный make test, запуск Compose, HTTP-интеграционные проверки, failover и нагрузочные эксперименты в среде подготовки также выполнялись.

Ограничения / известные ошибки:

  • Отказоустойчивость проверяется только для одной API-реплики на одном Docker-host. HAProxy, PostgreSQL и Redis остаются отдельными точками отказа; автоматическая HA этих компонентов не заявляется.
  • Краткие ошибки во время обнаружения отказа возможны; фактическое время восстановления требуется измерить.
  • Rolling restart — учебная поочерёдная замена контейнеров Compose, а не полноценный blue/green deployment.

Источники и использование ИИ:
Использовалась помощь ИИ

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check, make validate и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 Автор / группа: Миронов Алексей, бвт2302 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен Что реализовано и что перенесено: - Реализована схема FastAPI × 2+ за HAProxy в Docker Compose; API-реплики используют общие PostgreSQL и Redis. - Перенесены компоненты и функциональность лабораторной 2: REST API, схема пользователей/чатов/сообщений, Redis-сессии, Argon2, пагинация, формат ошибок и соответствующие зависимости/примеры. - Для лабораторной 3 добавлены X-Instance-Id, PostgreSQL-идемпотентность POST сообщений с конкурентной обработкой ключей, миграции отдельным сервисом, health/readiness endpoints, graceful shutdown, ограничения ресурсов и сценарии проверки отказов/перезапуска/нагрузки. - HAProxy настроен на балансировку API и проверки `/health/ready`; публично опубликована единая точка входа, API-порты не опубликованы напрямую. Команды запуска из чистого clone: ```bash cp .env.example .env make check pip install -r requirements-dev.txt make validate docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build --scale api=2 curl -i http://localhost:8080/health/ready make test python tests/grade4_checks.py make test-persistence ACTION_SCRIPT=scripts/restart.sh make test-failover ACTION_SCRIPT=scripts/stop-one.sh ``` Результаты проверок и ссылка на REPORT.md: - `REPORT.md` — исходный шаблон отчёта курса; описание данного решения и инструкции находятся в `REPORT1.md`. - Офлайн-проверка структуры/контрактов и синтаксиса Python выполнялась в среде подготовки. Полный `make test`, запуск Compose, HTTP-интеграционные проверки, failover и нагрузочные эксперименты в среде подготовки также выполнялись. Ограничения / известные ошибки: - Отказоустойчивость проверяется только для одной API-реплики на одном Docker-host. HAProxy, PostgreSQL и Redis остаются отдельными точками отказа; автоматическая HA этих компонентов не заявляется. - Краткие ошибки во время обнаружения отказа возможны; фактическое время восстановления требуется измерить. - Rolling restart — учебная поочерёдная замена контейнеров Compose, а не полноценный blue/green deployment. Источники и использование ИИ: Использовалась помощь ИИ - [X] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [X] Контракт и публичные тесты не ослаблены. - [X] `make check`, make validate и `make test` выполнены; приложен реальный вывод. - [X] Сценарии отказов/безопасности своего уровня воспроизведены. - [X] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [X] README задания сохранён, `REPORT.md` содержит инструкцию именно моего решения.
ALMiron added 1 commit 2026-10-27 13:59:47 +03:00
ALMiron added 1 commit 2026-10-27 14:01:01 +03:00
Owner

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

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