ЛР 3 — БВТ2302 — Рестеу — на 4 #76

Closed
Mandarin wants to merge 1 commits from Mandarin/mtusi2026lab3:main into main
First-time contributor

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

Автор / группа: Рестеу Д. А., БВТ2302
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен

Что реализовано и что перенесено:
Перенесен API из lab2 (PostgreSQL + Redis). Реализовано горизонтальное масштабирование: две реплики API (api1, api2) за балансировщиком Nginx. Снаружи опубликован только порт Nginx. В каждом ответе API возвращает заголовок X-Instance-Id.
Добавлена строгая идемпотентность: миграция 03_idempotency.sql создает таблицу message_requests. Отправка сообщения требует Idempotency-Key, уникальный первичный ключ в БД предотвращает дубли при параллельных запросах.
Миграции вынесены в отдельный сервис migrate. В Nginx настроены таймауты и пассивное исключение недоступных реплик. Заданы CPU/RAM-лимиты для контейнеров.

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

Copy-Item .env.example .env
# (при необходимости отредактировать пароль в .env)

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

python tests/smoke.py --base-url http://localhost:8080
python scripts/test_parallel.py

Тестирование отказов (PowerShell):

python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd
docker compose up -d --wait api1 api2
python tests/resilience.py --mode persistence --action-script scripts/restart.cmd

Результаты проверок и ссылка на REPORT.md:
Пройдены: проверка структуры (make check), публичный smoke (make test), параллельный тест идемпотентности (make test-parallel).
Результаты нагрузочного тестирования и детальные логи сценариев отказов (failover) сохраняются в папке evidence/ после локального запуска. Подробное описание архитектуры и ограничений — в REPORT.md.

Ограничения / известные ошибки:
Стенд выдерживает отказ одной API-реплики. Nginx, Redis, PostgreSQL и сам Docker-хост остаются едиными точками отказа (SPOF). Nginx использует пассивные проверки (через max_fails и таймауты запросов), а не активный опрос /health/ready.

Источники и использование ИИ:
Python, FastAPI, PostgreSQL, Redis, Nginx. При подготовке кода, SQL-миграций и скриптов автоматизации использовался ассистент (Claude).

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 Автор / группа: Рестеу Д. А., БВТ2302 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен Что реализовано и что перенесено: Перенесен API из lab2 (PostgreSQL + Redis). Реализовано горизонтальное масштабирование: две реплики API (`api1`, `api2`) за балансировщиком Nginx. Снаружи опубликован только порт Nginx. В каждом ответе API возвращает заголовок `X-Instance-Id`. Добавлена строгая идемпотентность: миграция `03_idempotency.sql` создает таблицу `message_requests`. Отправка сообщения требует `Idempotency-Key`, уникальный первичный ключ в БД предотвращает дубли при параллельных запросах. Миграции вынесены в отдельный сервис `migrate`. В Nginx настроены таймауты и пассивное исключение недоступных реплик. Заданы CPU/RAM-лимиты для контейнеров. Команды запуска из чистого clone: ```powershell Copy-Item .env.example .env # (при необходимости отредактировать пароль в .env) docker compose --env-file .env up -d --build --wait docker compose --env-file .env ps python tests/smoke.py --base-url http://localhost:8080 python scripts/test_parallel.py ``` Тестирование отказов (PowerShell): ```powershell python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd docker compose up -d --wait api1 api2 python tests/resilience.py --mode persistence --action-script scripts/restart.cmd ``` Результаты проверок и ссылка на REPORT.md: Пройдены: проверка структуры (`make check`), публичный smoke (`make test`), параллельный тест идемпотентности (`make test-parallel`). Результаты нагрузочного тестирования и детальные логи сценариев отказов (failover) сохраняются в папке `evidence/` после локального запуска. Подробное описание архитектуры и ограничений — в `REPORT.md`. Ограничения / известные ошибки: Стенд выдерживает отказ одной API-реплики. Nginx, Redis, PostgreSQL и сам Docker-хост остаются едиными точками отказа (SPOF). Nginx использует пассивные проверки (через `max_fails` и таймауты запросов), а не активный опрос `/health/ready`. Источники и использование ИИ: Python, FastAPI, PostgreSQL, Redis, Nginx. При подготовке кода, SQL-миграций и скриптов автоматизации использовался ассистент (Claude). - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Mandarin added 1 commit 2026-10-30 16:50:26 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-31 15:59:44 +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#76