tests/smoke.py — успешно (проверены сессии и идемпотентность).
tests/resilience.py --mode persistence — успешно (данные и токены переживают перезапуск).
tests/resilience.py --mode failover — успешно (восстановление записи заняло 3.4 сек, успело пройти 48 записей во время падения реплики).
scripts/track1_bench.py — при 1 реплике RPS 115, при 2 репликах RPS 121, при 4 репликах RPS падает до 100 (найден saturation point БД).
Ссылка на подробный анализ: REPORT.md
Ограничения / известные ошибки
Saturation Point (Трек 1): При увеличении количества реплик до 4-х RPS падает, а p95 растет. Узким местом становится общая база данных PostgreSQL (лимит пула соединений и CPU), а не сами API-реплики.
Единая точка отказа (SPOF): В текущей конфигурации БД (PostgreSQL) запущена в одном экземпляре.
Кроссплатформенность скриптов: Тесты отказоустойчивости запускаются через файлы .cmd (для Windows), так как окружение тестировалось на Windows. Для Linux/macOS потребуются эквивалентные .sh скрипты (они есть в виде примеров).
Сетевые сбои (Docker Desktop на Windows): При использовании библиотеки httpx с хоста наблюдались случайные 503 ошибки (Docker-proxy), поэтому скрипт нагрузочного тестирования track1_bench.py переписан на стандартный urllib.
Не реализовано / вне скоупа: репликация БД, мониторинг (Prometheus), оркестрация Docker Swarm (использован обычный Compose).
Источники и использование ИИ
FastAPI, SQLAlchemy 2.0.29 (async), asyncpg, Alembic, redis-py, Nginx, Pydantic 2. ИИ использовался для черновика конфигураций и скриптов, финальный код проверен вручную и прогнан на локальном стенде.
Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
Контракт и публичные тесты не ослаблены.
make check и make test выполнены; приложен реальный вывод.
Сценарии отказов/безопасности своего уровня воспроизведены (failover и idempotency).
Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3
Автор / группа: Максимова Снежана Игоревна / БПИ2302
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: Трек 1 (Цена масштабирования)
**Что реализовано и что перенесено**
Реализовано:
- Nginx в роли балансировщика (Round-Robin) для распределения трафика.
- Запуск нескольких API-реплик через Docker Compose (`--scale api=2`).
- Генерация заголовка `X-Instance-Id` в middleware приложения.
- Общая идемпотентность отправки сообщений (таблица `idempotency_keys` в PostgreSQL + обработка `IntegrityError` для защиты от гонок).
- Скрипты для тестов отказоустойчивости (`scripts/restart.cmd`, `scripts/stop-one.cmd`).
- Скрипт для нагрузочного тестирования (`scripts/track1_bench.py`).
Перенесено из предыдущей работы (lab2):
- Асинхронный REST API на FastAPI.
- PostgreSQL через SQLAlchemy 2.0 (async) + asyncpg.
- Redis для хранения сессий.
- Миграции Alembic.
- Публичные тесты (не ослаблены).
- README и конфигурация.
**Команды запуска из чистого clone**
```sh
git clone https://gitea.privcloud.tech/kleprer/mtusi2026lab3.git
cd mtusi2026lab3
git checkout solution/БПИ2302-Максимова
python -c "import shutil; shutil.copy('.env.example', '.env')" # Кроссплатформенное копирование
docker compose --env-file .env up -d --build --scale api=2
curl -s http://localhost:8080/health/ready # Windows: curl.exe -s ...
```
Дополнительные проверки (после старта контейнеров и ожидания статуса healthy):
```sh
python scripts/check_contract.py
python tests/smoke.py
python tests/resilience.py --mode persistence --action-script scripts/restart.cmd
python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd
python scripts/track1_bench.py 2 20 10
```
**Результаты проверок и ссылка на REPORT.md**
- `docker compose up` — успешно (запущены Nginx, PostgreSQL, Redis и 2 реплики API).
- `curl http://localhost:8080/health/ready` — `{"status":"ok"}`.
- `tests/smoke.py` — успешно (проверены сессии и идемпотентность).
- `tests/resilience.py --mode persistence` — успешно (данные и токены переживают перезапуск).
- `tests/resilience.py --mode failover` — успешно (восстановление записи заняло 3.4 сек, успело пройти 48 записей во время падения реплики).
- `scripts/track1_bench.py` — при 1 реплике RPS 115, при 2 репликах RPS 121, при 4 репликах RPS падает до 100 (найден saturation point БД).
- Ссылка на подробный анализ: REPORT.md
**Ограничения / известные ошибки**
- **Saturation Point (Трек 1):** При увеличении количества реплик до 4-х RPS падает, а p95 растет. Узким местом становится общая база данных PostgreSQL (лимит пула соединений и CPU), а не сами API-реплики.
- **Единая точка отказа (SPOF):** В текущей конфигурации БД (PostgreSQL) запущена в одном экземпляре.
- **Кроссплатформенность скриптов:** Тесты отказоустойчивости запускаются через файлы `.cmd` (для Windows), так как окружение тестировалось на Windows. Для Linux/macOS потребуются эквивалентные `.sh` скрипты (они есть в виде примеров).
- **Сетевые сбои (Docker Desktop на Windows):** При использовании библиотеки `httpx` с хоста наблюдались случайные 503 ошибки (Docker-proxy), поэтому скрипт нагрузочного тестирования `track1_bench.py` переписан на стандартный `urllib`.
- Не реализовано / вне скоупа: репликация БД, мониторинг (Prometheus), оркестрация Docker Swarm (использован обычный Compose).
**Источники и использование ИИ**
FastAPI, SQLAlchemy 2.0.29 (async), asyncpg, Alembic, redis-py, Nginx, Pydantic 2. ИИ использовался для черновика конфигураций и скриптов, финальный код проверен вручную и прогнан на локальном стенде.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены (failover и idempotency).
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Один ключ создаёт несколько сообщений. Шестнадцать одновременных отправок вернули один ID, но оставили семь строк в БД. Сообщение фиксируется раньше записи ключа повторного запроса; обе операции нужно выполнять в одной транзакции — app/repositories/messages.py:56.
История после успешной записи бывает устаревшей. После прогрева страницы limit=7 новое сообщение получило подтверждение, а следующее чтение вернуло ноль сообщений. Очистка кэша предусмотрена лишь для лимитов 10, 20 и 50; нужно обновлять все варианты страниц — app/repositories/messages.py:65.
Неверно обрабатывается ключ повторного запроса. Тот же ключ в другом чате даёт 409, пустой ключ принимается с 201, а ключ длиной 129 символов вызывает 500. Нужно учитывать чат при сравнении ключей и проверять их формат до записи — app/main.py:267.
Остались ошибки входа и доступа. Корректные учётные данные с UTF-8 паролем получают 401; непустое тело запроса на вход принимается с 201. Чужой курсор истории получает 200 вместо ошибки, неизвестный участник — 404 вместо 400. Нужно привести проверку входа, курсора и участника к контракту — app/main.py:169, app/main.py:324, app/main.py:216. Допустимый U+0000 при сохранении сообщения по-прежнему вызывает 500.
Балансировщик не подхватывает заменённые реплики. После последовательной замены двух API-контейнеров запросы попадали только на одну из трёх работающих реплик. Нужно обновлять адреса серверов в балансировщике — nginx/nginx.conf:8. При заморозке PostgreSQL или Redis запросы также ждут без ограниченного ответа; нужны согласованные таймауты.
Для стенда не заданы лимиты CPU и RAM — compose.yaml:38. Исследованию трека 1 недостаёт серии с ростом ресурсов, графиков и проверенного улучшения — REPORT.md:63. Короткий независимый повтор показал, что переход от двух реплик к четырём при том же бюджете ухудшил результат.
- Один ключ создаёт несколько сообщений. Шестнадцать одновременных отправок вернули один ID, но оставили семь строк в БД. Сообщение фиксируется раньше записи ключа повторного запроса; обе операции нужно выполнять в одной транзакции — [app/repositories/messages.py:56](https://gitea.privcloud.tech/kleprer/mtusi2026lab3/src/commit/fa7f5f2dd87304a3cc13ba294b473c434f7bdff1/app/repositories/messages.py#L56).
- История после успешной записи бывает устаревшей. После прогрева страницы limit=7 новое сообщение получило подтверждение, а следующее чтение вернуло ноль сообщений. Очистка кэша предусмотрена лишь для лимитов 10, 20 и 50; нужно обновлять все варианты страниц — [app/repositories/messages.py:65](https://gitea.privcloud.tech/kleprer/mtusi2026lab3/src/commit/fa7f5f2dd87304a3cc13ba294b473c434f7bdff1/app/repositories/messages.py#L65).
- Неверно обрабатывается ключ повторного запроса. Тот же ключ в другом чате даёт 409, пустой ключ принимается с 201, а ключ длиной 129 символов вызывает 500. Нужно учитывать чат при сравнении ключей и проверять их формат до записи — [app/main.py:267](https://gitea.privcloud.tech/kleprer/mtusi2026lab3/src/commit/fa7f5f2dd87304a3cc13ba294b473c434f7bdff1/app/main.py#L267).
- Остались ошибки входа и доступа. Корректные учётные данные с UTF-8 паролем получают 401; непустое тело запроса на вход принимается с 201. Чужой курсор истории получает 200 вместо ошибки, неизвестный участник — 404 вместо 400. Нужно привести проверку входа, курсора и участника к контракту — [app/main.py:169](https://gitea.privcloud.tech/kleprer/mtusi2026lab3/src/commit/fa7f5f2dd87304a3cc13ba294b473c434f7bdff1/app/main.py#L169), [app/main.py:324](https://gitea.privcloud.tech/kleprer/mtusi2026lab3/src/commit/fa7f5f2dd87304a3cc13ba294b473c434f7bdff1/app/main.py#L324), [app/main.py:216](https://gitea.privcloud.tech/kleprer/mtusi2026lab3/src/commit/fa7f5f2dd87304a3cc13ba294b473c434f7bdff1/app/main.py#L216). Допустимый U+0000 при сохранении сообщения по-прежнему вызывает 500.
- Балансировщик не подхватывает заменённые реплики. После последовательной замены двух API-контейнеров запросы попадали только на одну из трёх работающих реплик. Нужно обновлять адреса серверов в балансировщике — [nginx/nginx.conf:8](https://gitea.privcloud.tech/kleprer/mtusi2026lab3/src/commit/fa7f5f2dd87304a3cc13ba294b473c434f7bdff1/nginx/nginx.conf#L8). При заморозке PostgreSQL или Redis запросы также ждут без ограниченного ответа; нужны согласованные таймауты.
- Для стенда не заданы лимиты CPU и RAM — [compose.yaml:38](https://gitea.privcloud.tech/kleprer/mtusi2026lab3/src/commit/fa7f5f2dd87304a3cc13ba294b473c434f7bdff1/compose.yaml#L38). Исследованию трека 1 недостаёт серии с ростом ресурсов, графиков и проверенного улучшения — [REPORT.md:63](https://gitea.privcloud.tech/kleprer/mtusi2026lab3/src/commit/fa7f5f2dd87304a3cc13ba294b473c434f7bdff1/REPORT.md#L63). Короткий независимый повтор показал, что переход от двух реплик к четырём при том же бюджете ухудшил результат.
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.
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
Автор / группа: Максимова Снежана Игоревна / БПИ2302
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: Трек 1 (Цена масштабирования)
Что реализовано и что перенесено
Реализовано:
--scale api=2).X-Instance-Idв middleware приложения.idempotency_keysв PostgreSQL + обработкаIntegrityErrorдля защиты от гонок).scripts/restart.cmd,scripts/stop-one.cmd).scripts/track1_bench.py).Перенесено из предыдущей работы (lab2):
Команды запуска из чистого clone
Дополнительные проверки (после старта контейнеров и ожидания статуса healthy):
Результаты проверок и ссылка на REPORT.md
docker compose up— успешно (запущены Nginx, PostgreSQL, Redis и 2 реплики API).curl http://localhost:8080/health/ready—{"status":"ok"}.tests/smoke.py— успешно (проверены сессии и идемпотентность).tests/resilience.py --mode persistence— успешно (данные и токены переживают перезапуск).tests/resilience.py --mode failover— успешно (восстановление записи заняло 3.4 сек, успело пройти 48 записей во время падения реплики).scripts/track1_bench.py— при 1 реплике RPS 115, при 2 репликах RPS 121, при 4 репликах RPS падает до 100 (найден saturation point БД).Ограничения / известные ошибки
.cmd(для Windows), так как окружение тестировалось на Windows. Для Linux/macOS потребуются эквивалентные.shскрипты (они есть в виде примеров).httpxс хоста наблюдались случайные 503 ошибки (Docker-proxy), поэтому скрипт нагрузочного тестированияtrack1_bench.pyпереписан на стандартныйurllib.Источники и использование ИИ
FastAPI, SQLAlchemy 2.0.29 (async), asyncpg, Alembic, redis-py, Nginx, Pydantic 2. ИИ использовался для черновика конфигураций и скриптов, финальный код проверен вручную и прогнан на локальном стенде.
View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.