Files
mtusi2026lab3/.github/pull_request_template.md
T

24 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## Лабораторная 3
Автор / группа: Синюк Максим Павлович БПИ2301
Целевая оценка (3/4/5): 5
Трек 1, если заявлен: "Цена масштабирования"
Что реализовано и что перенесено: перенесены пользовательские тесты, валидация(перенастроена на пароль), роуты(перенастроены на защиту по токену сессии), модели ORM и работа с БД PostgreSQL, Redis кэширование
Команды запуска из чистого clone: cd mtusi2026lab3 | docker compose -d --build | docker compose logs api --tail 50
Результаты проверок и ссылка на REPORT.md: https://gitea.privcloud.tech/Atelier77/mtusi2026lab3/src/branch/solution/БПИ2301-Синюк/REPORT.md
Ограничения / известные ошибки: описано в REPORT.md
Источники и использование ИИ: руками, составление прогонов конкурентности
Graceful Degradation: SIGTERM перестаёт принимать новые запросы, выполняет уже полученные в течение 30 секунд и останавливает процесс, встроенная функция сервера Uvicorn. Для проверки отказоустойчивости был использован скрипт `scripts/failover_test.sh`, который выполняет нагрузочное тестирование (`tests/load.py`) с помощью файла `scripts/test_idempotency_failover.py` и последовательно останавливает/восстанавливает(проверка на отказоустойчивость) реплики API. Результат описан в README.md и метрики представлены в `results/failover_metrics.json`. Идемпотентность при параллельных запросах с одинаковым idempotency-key проводилась с concurrency 4, duration 60s и при 2 репликах api с ограничениями cpus 0.5 и memory 512M. Cache Stampede при холодном запуске решается через Redis Lock на idempotency-key для конкретного запроса благодаря асинхронности запросов. Параллельные запросы с одним idempotent-key создают одну запись, response кэшируется и отдаётся без обращения к БД. Health/readiness и timeouts настроены в `docker-compose.yml` и `nginx.conf`, время обнаружения отказа инстанса ~20 сек. Миграции вынесены в отдельный сервис `migrate` в `docker-compose.yml`. Сервис `api` имеет зависимость `depends_on: migrate (condition: service_completed_successfully)`. В виду этого миграции выполняются только один раз перед запуском реплик api. Реплики API только проверяют подключение к БД и инициализируют Redis.
В эксперименте проверена обработка насыщения пула соединений, при которой клиент поулчает статус ошибки 503 вместо выдачи общего 500 для retry запросов в скрипте `python scripts/check_503_retry_after.py --n 64`. Первые запросы занимают вес пул, а оставшиеся получают response 503 с extra_headers `Retry-After`. Все запросы корректны обработаны, ключ и тело запросов не менялись. Конкуренция: 64; wall time: 0.50s; реплик наблюдалось: 2 ['api-24fde5d9', 'api-df7eae98'] результат в `results/check_overloaded_handler_503.log`. Конфигурации с идентичным CPU API (2×1.0) и зафиксированным PostgreSQL (1.0): D_pool_starved: DB_POOL_SIZE=2, DB_MAX_OVERFLOW=0, DB_POOL_TIMEOUT=5. D_pool_normal: DB_POOL_SIZE=10, DB_MAX_OVERFLOW=20, DB_POOL_TIMEOUT=30. суммарный пул растёт как replicas × (pool_size + max_overflow). При 4 репликах × 30 = 120 потенциальных соединений против ёмкости одноядерной БД добавление реплик усиливает contention, а не пропускную способность. Рост реплик перестаёт увеличивать RPS. Диаграммы получены через `scripts/plot_scaling.py` и хранятся в `results/scaling/*.png`. Конкуренция в эксперименте проводилась с параметрами [8, 16, 32, 64]
- [+] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [+] Контракт и публичные тесты не ослаблены.
- [+] make check и make test выполнены; приложен реальный вывод.
- [+] Сценарии отказов/безопасности своего уровня воспроизведены.
- [+] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [+] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.