Автор / группа: Возжин Сергей, БПИ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.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Лабораторная 3
Автор / группа: Возжин Сергей, БПИ2301
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен
Что реализовано и что перенесено
Из lab2 перенесены FastAPI-приложение, PostgreSQL, Redis-сессии, Argon2id, opaque Bearer-аутентификация, миграции Alembic, keyset-пагинация, единый формат ошибок и
X-Request-Id.Для lab3 реализовано:
localhost:8080./health/readyс автоматическим исключением недоступной реплики.X-Instance-Id, позволяющий определить обработавшую запрос реплику.Idempotency-Keyпри отправке сообщения.(sender_id, chat_id, idempotency_key).INSERT ... ON CONFLICT DO NOTHING.409.Наружу опубликован только порт HAProxy. API, PostgreSQL и Redis доступны только внутри Compose-сети. Данные PostgreSQL и Redis сохраняются в named volumes.
Команды запуска из чистого clone
Принято. Закрываю МР.
Pull request closed