Автор / группа: Авзалов Артур Марсович / БПИ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"dockercompose--env-file.envup-d--build--waitdockercompose--env-file.envps
makecheckPYTHON=pythonmaketestPYTHON=pythonpythontests/idempotency_parallel.py
Локальные испытания проводились на двух компьютерах с 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 содержит инструкцию моего решения.
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, если заявлен: не заявлен
Что реализовано и что перенесено
Сохранены обязательные возможности предыдущих лабораторных: регистрация и авторизация пользователей, PostgreSQL, Redis-сессии, чаты, сообщения, миграции и курсорная пагинация.
Реализованы требования лабораторной 3:
api1,api2) за HAProxy с балансировкой round-robin.127.0.0.1:8080.X-Instance-IdиX-Request-Id.Idempotency-Keyдля отправки сообщений. Ключи и результаты сохраняются в PostgreSQL, конкурентные запросы синхронизируются транзакционной advisory lock.201, использование ключа с другим телом —409. Дубли сообщений не создаются.Приложение разделено на модули
app/, включая API, модели, аутентификацию и работу с хранилищами.Команды запуска из чистого clone
Windows PowerShell, Docker Desktop, Python и make:
Проверки persistence и failover:
После failover восстановить обе реплики:
Результаты проверок и ссылка на REPORT.md
Локальные испытания проводились на двух компьютерах с Windows и Docker Desktop, 06.11.2026.
Функциональные проверки:
make check— PASS.make test— PASS, в том числе после поочерёдного пересоздания реплик.tests/idempotency_parallel.py— PASS: два API, одно сообщение, повтор201, конфликт содержимого409.Migrations up to date.healthy.Отказоустойчивость:
api1.api2— публичный smoke прошёл через оставшуюся реплику. На втором компьютере первый запрос получил кратковременный503от HAProxy, затем работа восстановилась. Точное время восстановления дляapi2не замерялось.Нагрузочные измерения на втором компьютере:
Поочерёдное пересоздание
api1, затемapi2выполнялось при активном нагрузочном тесте. Обе реплики восстановились до состоянияhealthy, тест завершился с нулём ошибок.Подробная архитектура, сценарии отказов, измерения и ограничения представлены в REPORT.md. Сводные JSON-результаты — в
evidence/.Ограничения / известные ошибки
503.api2отдельно не измерялось.Источники и использование ИИ
Использованы документация FastAPI, Pydantic, PostgreSQL, psycopg, Redis, HAProxy и Docker Compose.
ChatGPT применялся для проектирования архитектуры, генерации и рефакторинга кода, подготовки миграций, инфраструктурных конфигураций, тестов и документации. Функциональные проверки, эксперименты отказоустойчивости и нагрузочные измерения выполнены локально.
Чек-лист
make checkиmake testвыполнены; результаты приведены.Принято. Закрываю МР.
Pull request closed