forked from mtusi2026/mtusi2026lab3
23 lines
3.8 KiB
Markdown
23 lines
3.8 KiB
Markdown
## Лабораторная 3
|
||
|
||
Автор / группа: Синюк Максим Павлович БПИ2301
|
||
Целевая оценка (3/4/5): 5
|
||
Трек 5, если заявлен: TODO
|
||
|
||
Что реализовано и что перенесено: перенесены пользовательские тесты, валидация(перенастроена на пароль), роуты(перенастроены на защиту по токену сессии), модели ORM и работа с БД PostgreSQL, Redis кэширование
|
||
Команды запуска из чистого clone: cd mtusi2026lab3 | docker compose -d --build | docker compose logs api --tail 50
|
||
Результаты проверок и ссылка на REPORT.md: TODO
|
||
Ограничения / известные ошибки: описано в 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
|
||
|
||
|
||
- [+] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
|
||
- [+] Контракт и публичные тесты не ослаблены.
|
||
- [+] make check и make test выполнены; приложен реальный вывод.
|
||
- [+] Сценарии отказов/безопасности своего уровня воспроизведены.
|
||
- [+] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
|
||
- [+] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
|