ЛР 3 — БПИ2301 — Возжин — на 4 #48

Closed
vozzhin wants to merge 3 commits from vozzhin/mtusi2026lab3:solution/BPI2301-Vozzhin into main
First-time contributor

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

Автор / группа: Возжин Сергей, БПИ2301
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен

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

Из lab2 перенесены FastAPI-приложение, PostgreSQL, Redis-сессии, Argon2id, opaque Bearer-аутентификация, миграции Alembic, keyset-пагинация, единый формат ошибок и X-Request-Id.

Для lab3 реализовано:

  • HAProxy как единственная публичная точка входа на localhost:8080.
  • Две реплики API без локального значимого состояния.
  • Балансировка round-robin между репликами.
  • Health checks /health/ready с автоматическим исключением недоступной реплики.
  • Заголовок X-Instance-Id, позволяющий определить обработавшую запрос реплику.
  • Общие PostgreSQL и Redis для обеих API-реплик.
  • Обязательный Idempotency-Key при отправке сообщения.
  • Общая идемпотентность через PostgreSQL с уникальностью
    (sender_id, chat_id, idempotency_key).
  • Конкурентная обработка одинакового ключа через INSERT ... ON CONFLICT DO NOTHING.
  • Повтор запроса с тем же телом возвращает исходное сообщение, с другим телом — 409.
  • Миграция Alembic для поля и ограничения идемпотентности.
  • Лимиты CPU/RAM для API, HAProxy, PostgreSQL, Redis и migrate.
  • Graceful shutdown API и таймауты HAProxy.
  • Скрипты перезапуска, остановки одной реплики и поочерёдной замены реплик.
  • Нагрузочные, persistence, failover и rolling-update эксперименты.

Наружу опубликован только порт HAProxy. API, PostgreSQL и Redis доступны только внутри Compose-сети. Данные PostgreSQL и Redis сохраняются в named volumes.

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

cp .env.example .env
# заменить POSTGRES_PASSWORD и соответствующий пароль в DATABASE_URL

docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait
docker compose --env-file .env ps

make check
make validate PYTHON=.venv/bin/python
make test
make test-idempotency PYTHON=.venv/bin/python
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh

После failover восстановить две реплики:

docker compose --env-file .env up -d --wait --wait-timeout 60 api lb

Для проверки второй реплики повторно выполняется failover после восстановления первой.

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

- make check — PASS.
- OpenAPI validation — PASS.
- Публичный smoke make test — PASS.
- Pytest идемпотентности — 5 passed.
- 20 параллельных запросов с одним Idempotency-Key прошли через HAProxy и обе API-реплики.
- Все конкурентные ответы содержали один ID сообщения.
- В истории сохранилось ровно одно сообщение.
- Повтор с другим телом и тем же ключом вернул 409.
- Persistence после рестарта API, PostgreSQL и Redis — PASS; данные и прежний Bearer-token сохранились.
- Чистый запуск проверен в отдельном Compose-проекте с пустыми volumes.
Лабораторная 3 Автор / группа: Возжин Сергей, БПИ2301 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен ## Что реализовано и что перенесено Из lab2 перенесены FastAPI-приложение, PostgreSQL, Redis-сессии, Argon2id, opaque Bearer-аутентификация, миграции Alembic, keyset-пагинация, единый формат ошибок и `X-Request-Id`. Для lab3 реализовано: - HAProxy как единственная публичная точка входа на `localhost:8080`. - Две реплики API без локального значимого состояния. - Балансировка round-robin между репликами. - Health checks `/health/ready` с автоматическим исключением недоступной реплики. - Заголовок `X-Instance-Id`, позволяющий определить обработавшую запрос реплику. - Общие PostgreSQL и Redis для обеих API-реплик. - Обязательный `Idempotency-Key` при отправке сообщения. - Общая идемпотентность через PostgreSQL с уникальностью `(sender_id, chat_id, idempotency_key)`. - Конкурентная обработка одинакового ключа через `INSERT ... ON CONFLICT DO NOTHING`. - Повтор запроса с тем же телом возвращает исходное сообщение, с другим телом — `409`. - Миграция Alembic для поля и ограничения идемпотентности. - Лимиты CPU/RAM для API, HAProxy, PostgreSQL, Redis и migrate. - Graceful shutdown API и таймауты HAProxy. - Скрипты перезапуска, остановки одной реплики и поочерёдной замены реплик. - Нагрузочные, persistence, failover и rolling-update эксперименты. Наружу опубликован только порт HAProxy. API, PostgreSQL и Redis доступны только внутри Compose-сети. Данные PostgreSQL и Redis сохраняются в named volumes. ## Команды запуска из чистого clone ```sh cp .env.example .env # заменить POSTGRES_PASSWORD и соответствующий пароль в DATABASE_URL docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build --wait docker compose --env-file .env ps make check make validate PYTHON=.venv/bin/python make test make test-idempotency PYTHON=.venv/bin/python make test-persistence ACTION_SCRIPT=scripts/restart.sh make test-failover ACTION_SCRIPT=scripts/stop-one.sh После failover восстановить две реплики: docker compose --env-file .env up -d --wait --wait-timeout 60 api lb Для проверки второй реплики повторно выполняется failover после восстановления первой. ## Результаты проверок - make check — PASS. - OpenAPI validation — PASS. - Публичный smoke make test — PASS. - Pytest идемпотентности — 5 passed. - 20 параллельных запросов с одним Idempotency-Key прошли через HAProxy и обе API-реплики. - Все конкурентные ответы содержали один ID сообщения. - В истории сохранилось ровно одно сообщение. - Повтор с другим телом и тем же ключом вернул 409. - Persistence после рестарта API, PostgreSQL и Redis — PASS; данные и прежний Bearer-token сохранились. - Чистый запуск проверен в отдельном Compose-проекте с пустыми volumes.
vozzhin added 2 commits 2026-10-23 18:55:54 +03:00
vozzhin added 1 commit 2026-10-23 18:57:03 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-24 16:16:58 +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#48