ЛР 3 — БПИ2301 — Авзалов — на 4 #112

Closed
Ferraronp wants to merge 2 commits from Ferraronp/mtusi2026lab3:main into main
First-time contributor

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

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

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

Сохранены обязательные возможности предыдущих лабораторных: регистрация и авторизация пользователей, PostgreSQL, Redis-сессии, чаты, сообщения, миграции и курсорная пагинация.

Реализованы требования лабораторной 3:

  • Две взаимозаменяемые реплики FastAPI (api1, api2) за HAProxy с балансировкой round-robin.
  • Единая публичная точка входа 127.0.0.1:8080.
  • Общие PostgreSQL и Redis, отсутствие локального состояния сессий в репликах.
  • Заголовки X-Instance-Id и X-Request-Id.
  • Обязательный Idempotency-Key для отправки сообщений. Ключи и результаты сохраняются в PostgreSQL, конкурентные запросы синхронизируются транзакционной advisory lock.
  • Повтор запроса возвращает исходный результат 201, использование ключа с другим телом — 409. Дубли сообщений не создаются.
  • Отдельный сервис миграций с координацией выполнения.
  • HAProxy healthchecks, readiness, таймауты и graceful shutdown.
  • CPU/RAM-лимиты для контейнеров.
  • Скрипты отказа реплики, перезапуска и поочерёдной замены.
  • Дополнительный тест конкурентной идемпотентности и нагрузочные эксперименты.

Приложение разделено на модули app/, включая API, модели, аутентификацию и работу с хранилищами.

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

Windows PowerShell, Docker Desktop, Python и make:

Copy-Item .env.example .env
# Установить локальный POSTGRES_PASSWORD в .env

$env:PYTHONUTF8 = "1"

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

make check PYTHON=python
make test PYTHON=python
python tests/idempotency_parallel.py

Проверки persistence и failover:

python tests/resilience.py --mode persistence --action-script scripts/restart.cmd
python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd

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

docker compose --env-file .env up -d --no-deps --wait api1 api2

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

Локальные испытания проводились на двух компьютерах с Windows и Docker Desktop, 06.11.2026.

Функциональные проверки:

  • make check — PASS.
  • make test — PASS, в том числе после поочерёдного пересоздания реплик.
  • tests/idempotency_parallel.py — PASS: два API, одно сообщение, повтор 201, конфликт содержимого 409.
  • Persistence — PASS: сохранены подтверждённые данные и действующая Bearer-сессия.
  • Повторная миграция — Migrations up to date.
  • После всех экспериментов обе реплики и остальные сервисы — healthy.

Отказоустойчивость:

  • Автоматический failover — PASS в трёх прогонах: восстановление за 6,281 с, 8,282 с и 8,328 с при требовании не более 10 секунд.
  • В первых двух прогонах подтверждена остановка api1.
  • Ручная остановка api2 — публичный smoke прошёл через оставшуюся реплику. На втором компьютере первый запрос получил кратковременный 503 от HAProxy, затем работа восстановилась. Точное время восстановления для api2 не замерялось.
  • Подтверждённые данные после отказов сохранились.

Нагрузочные измерения на втором компьютере:

Метрика Обычная нагрузка Rolling update
Длительность 30 с 90 с
Конкурентность 4 4
Успешные запросы 60 168
Ошибки 0 0
RPS 1,882 1,861
p50 2093 мс 2094 мс
p95 2125 мс 2156 мс
p99 2329 мс 6172 мс

Поочерёдное пересоздание api1, затем api2 выполнялось при активном нагрузочном тесте. Обе реплики восстановились до состояния healthy, тест завершился с нулём ошибок.

Подробная архитектура, сценарии отказов, измерения и ограничения представлены в REPORT.md. Сводные JSON-результаты — в evidence/.

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

  • PostgreSQL, Redis, балансировщик и Docker-host не имеют резервирования. Проверена устойчивость к отказу одной API-реплики, но не всего хоста.
  • При обнаружении отключённой реплики возможен кратковременный 503.
  • Время восстановления при ручной остановке api2 отдельно не измерялось.
  • Поочерёдная замена тестировалась на одной версии приложения; обновление на несовместимую версию API или схему БД не проверялось.
  • Linux-интеграционные сценарии отдельно не запускались.
  • Для внешнего доступа требуется TLS; текущий стенд предназначен для localhost.

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

Использованы документация FastAPI, Pydantic, PostgreSQL, psycopg, Redis, HAProxy и Docker Compose.

ChatGPT применялся для проектирования архитектуры, генерации и рефакторинга кода, подготовки миграций, инфраструктурных конфигураций, тестов и документации. Функциональные проверки, эксперименты отказоустойчивости и нагрузочные измерения выполнены локально.

Чек-лист

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; результаты приведены.
  • Сценарии отказов и безопасности своего уровня воспроизведены.
  • Секреты и приватные ключи находятся вне Git; отчёт не содержит токенов.
  • README задания сохранён, REPORT.md содержит инструкцию моего решения.
## Лабораторная 3 **Автор / группа:** Авзалов Артур Марсович / БПИ2301 **Целевая оценка (3/4/5):** 4 **Трек 5, если заявлен:** не заявлен ### Что реализовано и что перенесено Сохранены обязательные возможности предыдущих лабораторных: регистрация и авторизация пользователей, PostgreSQL, Redis-сессии, чаты, сообщения, миграции и курсорная пагинация. Реализованы требования лабораторной 3: - Две взаимозаменяемые реплики FastAPI (`api1`, `api2`) за HAProxy с балансировкой round-robin. - Единая публичная точка входа `127.0.0.1:8080`. - Общие PostgreSQL и Redis, отсутствие локального состояния сессий в репликах. - Заголовки `X-Instance-Id` и `X-Request-Id`. - Обязательный `Idempotency-Key` для отправки сообщений. Ключи и результаты сохраняются в PostgreSQL, конкурентные запросы синхронизируются транзакционной advisory lock. - Повтор запроса возвращает исходный результат `201`, использование ключа с другим телом — `409`. Дубли сообщений не создаются. - Отдельный сервис миграций с координацией выполнения. - HAProxy healthchecks, readiness, таймауты и graceful shutdown. - CPU/RAM-лимиты для контейнеров. - Скрипты отказа реплики, перезапуска и поочерёдной замены. - Дополнительный тест конкурентной идемпотентности и нагрузочные эксперименты. Приложение разделено на модули `app/`, включая API, модели, аутентификацию и работу с хранилищами. ### Команды запуска из чистого clone Windows PowerShell, Docker Desktop, Python и make: ```powershell Copy-Item .env.example .env # Установить локальный POSTGRES_PASSWORD в .env $env:PYTHONUTF8 = "1" docker compose --env-file .env up -d --build --wait docker compose --env-file .env ps make check PYTHON=python make test PYTHON=python python tests/idempotency_parallel.py ``` Проверки persistence и failover: ```powershell python tests/resilience.py --mode persistence --action-script scripts/restart.cmd python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd ``` После failover восстановить обе реплики: ```powershell docker compose --env-file .env up -d --no-deps --wait api1 api2 ``` ### Результаты проверок и ссылка на REPORT.md Локальные испытания проводились на двух компьютерах с Windows и Docker Desktop, 06.11.2026. **Функциональные проверки:** - `make check` — PASS. - `make test` — PASS, в том числе после поочерёдного пересоздания реплик. - `tests/idempotency_parallel.py` — PASS: два API, одно сообщение, повтор `201`, конфликт содержимого `409`. - Persistence — PASS: сохранены подтверждённые данные и действующая Bearer-сессия. - Повторная миграция — `Migrations up to date`. - После всех экспериментов обе реплики и остальные сервисы — `healthy`. **Отказоустойчивость:** - Автоматический failover — PASS в трёх прогонах: восстановление за **6,281 с, 8,282 с и 8,328 с** при требовании не более 10 секунд. - В первых двух прогонах подтверждена остановка `api1`. - Ручная остановка `api2` — публичный smoke прошёл через оставшуюся реплику. На втором компьютере первый запрос получил кратковременный `503` от HAProxy, затем работа восстановилась. Точное время восстановления для `api2` не замерялось. - Подтверждённые данные после отказов сохранились. **Нагрузочные измерения на втором компьютере:** | Метрика | Обычная нагрузка | Rolling update | |---|---:|---:| | Длительность | 30 с | 90 с | | Конкурентность | 4 | 4 | | Успешные запросы | 60 | 168 | | Ошибки | 0 | 0 | | RPS | 1,882 | 1,861 | | p50 | 2093 мс | 2094 мс | | p95 | 2125 мс | 2156 мс | | p99 | 2329 мс | 6172 мс | Поочерёдное пересоздание `api1`, затем `api2` выполнялось **при активном нагрузочном тесте**. Обе реплики восстановились до состояния `healthy`, тест завершился с нулём ошибок. Подробная архитектура, сценарии отказов, измерения и ограничения представлены в REPORT.md. Сводные JSON-результаты — в `evidence/`. ### Ограничения / известные ошибки - PostgreSQL, Redis, балансировщик и Docker-host не имеют резервирования. Проверена устойчивость к отказу одной API-реплики, но не всего хоста. - При обнаружении отключённой реплики возможен кратковременный `503`. - Время восстановления при ручной остановке `api2` отдельно не измерялось. - Поочерёдная замена тестировалась на одной версии приложения; обновление на несовместимую версию API или схему БД не проверялось. - Linux-интеграционные сценарии отдельно не запускались. - Для внешнего доступа требуется TLS; текущий стенд предназначен для localhost. ### Источники и использование ИИ Использованы документация FastAPI, Pydantic, PostgreSQL, psycopg, Redis, HAProxy и Docker Compose. ChatGPT применялся для проектирования архитектуры, генерации и рефакторинга кода, подготовки миграций, инфраструктурных конфигураций, тестов и документации. Функциональные проверки, эксперименты отказоустойчивости и нагрузочные измерения выполнены локально. ### Чек-лист - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] `make check` и `make test` выполнены; результаты приведены. - [x] Сценарии отказов и безопасности своего уровня воспроизведены. - [x] Секреты и приватные ключи находятся вне Git; отчёт не содержит токенов. - [x] README задания сохранён, REPORT.md содержит инструкцию моего решения.
Ferraronp added 1 commit 2026-11-06 19:00:05 +03:00
Ferraronp added 1 commit 2026-11-06 19:04:34 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-07 17:46:25 +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#112