diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index ff1c6f7e..29a0daa4 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -6,9 +6,9 @@ Что реализовано и что перенесено: перенесены пользовательские тесты, валидация(перенастроена на пароль), роуты(перенастроены на защиту по токену сессии), модели ORM и работа с БД PostgreSQL, Redis кэширование Команды запуска из чистого clone: cd mtusi2026lab3 | docker compose -d --build | docker compose logs api --tail 50 -Результаты проверок и ссылка на REPORT.md: TODO +Результаты проверок и ссылка на 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. diff --git a/REPORT.md b/REPORT.md index aa4181be..47a1fec2 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,8 +1,8 @@ # Отчёт — лабораторная 3 - Автор, группа: Синюк Максим Павлович БПИ2301 -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации +- Целевая оценка; выбранный трек 5, если нужен: 5, трек 1 "Цена масштабирования" +- Commit/PR: https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/166 - Использованные источники, библиотеки и помощь ИИ: перенос базы lab2, python, fastapi, uvicorn, pydantic, pytest, sqlalchemy, argon2-cffi, redis ## Запуск из чистого clone