52 lines
5.0 KiB
Markdown
52 lines
5.0 KiB
Markdown
## Лабораторная 3
|
||
|
||
Автор / группа: Тимофей Александров, БВТ2301
|
||
Целевая оценка (3/4/5): 5
|
||
Трек 5: трек 1 «Цена масштабирования»
|
||
|
||
Что реализовано и что перенесено:
|
||
- Перенесено из lab2: PostgreSQL источник истины, Valkey кэш сессий, Argon2id пароли, Bearer-сессии, транзакционное создание чата, keyset-пагинация, circuit breaker на Valkey.
|
||
- Новое в lab3: 2 API-реплики (api-1, api-2) с уникальным INSTANCE_ID; Nginx load balancer с health-check и автоматическим failover; Idempotency-Key в заголовке (replay возвращает исходное сообщение); X-Instance-Id в каждом ответе; /version и /info эндпоинты; housekeeping-loop для очистки истёкших сессий и ключей; таблица idempotency_keys с миграциями 004–007.
|
||
- Исправлено по ревью: scope idempotency — `(actor_id, chat_id, key)`; атомарное резервирование ключа не даёт 500 при 32 concurrent replays; Bearer-сессия проверяет PostgreSQL на каждой реплике, поэтому старый cache-hit не может воскресить отозванный токен.
|
||
- Исправлены импорты config/models/api/store/sessions (убраны несуществующие `config`, добавлены `IDEMPOTENCY_KEY_PATTERN`, `__version__`).
|
||
- Добавлены скрипты stop-one.sh/cmd (failover) и restart.sh/cmd (persistence).
|
||
|
||
Команды запуска из чистого clone:
|
||
```sh
|
||
sh scripts/bootstrap-secrets.sh
|
||
docker compose --env-file .env config --quiet
|
||
docker compose --env-file .env up -d --build --wait --wait-timeout 180
|
||
python3 scripts/check_contract.py
|
||
python3 scripts/validate_openapi.py
|
||
python3 tests/smoke.py --base-url http://127.0.0.1:8081
|
||
python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://127.0.0.1:8081
|
||
python3 tests/resilience.py --mode failover --action-script scripts/stop-one.sh --base-url http://127.0.0.1:8081
|
||
cd student-tests && BASE_URL=http://127.0.0.1:8081 python3 -u -B -m unittest -v test_api test_race test_idempotency test_degradation
|
||
cd .. && python3 scripts/research-scale.py --base-url http://127.0.0.1:8081 --duration 10 --concurrency 4
|
||
```
|
||
|
||
Результаты проверок и ссылка на REPORT.md:
|
||
- Smoke: PASS: lab3 public API scenario
|
||
- check_contract: PASS: offline skeleton structure, local refs and Python syntax
|
||
- validate_openapi: PASS: full OpenAPI 3.1 and JSON Schema validation
|
||
- Student tests: 28/28 OK; idempotency 2/2 OK (32 concurrent replays); degradation 2/2 OK (durable cross-replica logout)
|
||
- Failover: PASS — 79 успешных записей из 83, восстановление за 2.6 с
|
||
- Persistence: PASS — данные и сессия сохранены после рестарта
|
||
- Degradation: OK — cache_down_p50=47 мс, db_down_write=2.05 с, recovery=1.97 с
|
||
- Трек 5: fixed total RPS 1/2/4 = 36.9 / 49.4 / 36.2; growing resources = 42.4 / 45.2 / 57.0. Raw JSON: `evidence/scale-*.json`.
|
||
- Подробности: REPORT.md
|
||
|
||
Ограничения / известные ошибки:
|
||
- На Windows .sh-скрипты не запускаются напрямую (WinError 193); созданы эквиваленты .cmd.
|
||
- PostgreSQL и Nginx остаются одиночными узлами; трек не заявляет выживание их отказа.
|
||
- Нагрузочный тест закрытого цикла содержит coordinated omission.
|
||
|
||
Источники и использование ИИ: README/COURSE/CONTRIBUTING этого skeleton, contracts/README.md, tests/README.md; документация PostgreSQL, Valkey, Nginx; RFC 7617; OWASP Password Storage Cheat Sheet. ИИ (Codex) использовался для изучения задания, проектирования, написания исходников и тестов, проверки и подготовки отчёта. Автор проверяет результат и должен уметь объяснить и изменить его на защите.
|
||
|
||
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
|
||
- [x] Контракт и публичные тесты не ослаблены.
|
||
- [x] make check и make test выполнены; приложен реальный вывод.
|
||
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
|
||
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
|
||
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
|