ЛР 3 - БПИ2304 - Лесковский- на 3 #162

Closed
Leskovskiy wants to merge 2 commits from Leskovskiy/mtusi2026lab3-Leskovskiy:lab3-final into main
First-time contributor

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

Автор / группа: Лесковский Сергей БПИ2304
Целевая оценка (3/4/5): 3
Трек 5, если заявлен: Не заявлен

Что реализовано и что перенесено:
Перенесена lab2 (пользователи, сессии Basic→Bearer, чаты, сообщения, PostgreSQL, миграции, Argon2id). В lab3 добавлено: X-Instance-Id и X-Request-Id на всех ответах API; обязательный Idempotency-Key для POST /api/v1/chats/{chat_id}/messages с таблицей idempotency_keys и одной транзакцией (INSERT ... ON CONFLICT DO NOTHING + SELECT ... FOR UPDATE); отдельный одноразовый сервис migrate; две API-реплики api-1, api-2 за nginx-LB (max_fails=1 fail_timeout=2s, proxy_next_upstream); порты API наружу не публикуются. Сессии и идемпотентность хранятся в общей PostgreSQL.

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

  1. Создать secrets/pg_password.txt и secrets/database_url.txt; cp .env.example .env.
  2. docker compose --env-file .env up -d --build
  3. Дождаться: curl -fsS http://localhost:8080/health/ready
  4. python tests/smoke.py --base-url http://localhost:8080
  5. python tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://localhost:8080
  6. python tests/resilience.py --mode failover --action-script scripts/stop-one.sh --base-url http://localhost:8080

Результаты проверок и ссылка на REPORT.md:
Публичный smoke — PASS; persistence — PASS; failover (две реплики, 2 прогона) — PASS: observed_instances_before: 2, successful_writes: 97/95, failed_attempts: 0, first_recovery_seconds: 1.734/1.5. Через LB наблюдаются оба X-Instance-Id (api-1, api-2). Доказательства — в evidence/ (smoke.txt, instance-ids.txt, headers.txt, persistence.txt, failover-1.txt, failover-2.txt); подробности — в REPORT.md.

Ограничения / известные ошибки:
Один Docker-host, PostgreSQL без реплики, nginx-LB без HA; асинхронная чистка idempotency_keys по IDEMPOTENCY_TTL_SECONDS не реализована (контракт ≥24 ч не нарушается, таблица растёт).

Источники и использование ИИ:
FastAPI 0.115, uvicorn 0.30, psycopg 3.2, argon2-cffi, pydantic 2.9, nginx 1.27, PostgreSQL 16.4, Docker Compose v2. ИИ использовался для консультаций по идемпотентности, настройке nginx upstream и разбору ошибок локального запуска.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 Автор / группа: Лесковский Сергей БПИ2304 Целевая оценка (3/4/5): 3 Трек 5, если заявлен: Не заявлен Что реализовано и что перенесено: Перенесена lab2 (пользователи, сессии Basic→Bearer, чаты, сообщения, PostgreSQL, миграции, Argon2id). В lab3 добавлено: X-Instance-Id и X-Request-Id на всех ответах API; обязательный Idempotency-Key для POST /api/v1/chats/{chat_id}/messages с таблицей idempotency_keys и одной транзакцией (INSERT ... ON CONFLICT DO NOTHING + SELECT ... FOR UPDATE); отдельный одноразовый сервис migrate; две API-реплики api-1, api-2 за nginx-LB (max_fails=1 fail_timeout=2s, proxy_next_upstream); порты API наружу не публикуются. Сессии и идемпотентность хранятся в общей PostgreSQL. Команды запуска из чистого clone: 1. Создать secrets/pg_password.txt и secrets/database_url.txt; cp .env.example .env. 2. docker compose --env-file .env up -d --build 3. Дождаться: curl -fsS http://localhost:8080/health/ready 4. python tests/smoke.py --base-url http://localhost:8080 5. python tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://localhost:8080 6. python tests/resilience.py --mode failover --action-script scripts/stop-one.sh --base-url http://localhost:8080 Результаты проверок и ссылка на REPORT.md: Публичный smoke — PASS; persistence — PASS; failover (две реплики, 2 прогона) — PASS: observed_instances_before: 2, successful_writes: 97/95, failed_attempts: 0, first_recovery_seconds: 1.734/1.5. Через LB наблюдаются оба X-Instance-Id (api-1, api-2). Доказательства — в evidence/ (smoke.txt, instance-ids.txt, headers.txt, persistence.txt, failover-1.txt, failover-2.txt); подробности — в REPORT.md. Ограничения / известные ошибки: Один Docker-host, PostgreSQL без реплики, nginx-LB без HA; асинхронная чистка idempotency_keys по IDEMPOTENCY_TTL_SECONDS не реализована (контракт ≥24 ч не нарушается, таблица растёт). Источники и использование ИИ: FastAPI 0.115, uvicorn 0.30, psycopg 3.2, argon2-cffi, pydantic 2.9, nginx 1.27, PostgreSQL 16.4, Docker Compose v2. ИИ использовался для консультаций по идемпотентности, настройке nginx upstream и разбору ошибок локального запуска. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Leskovskiy added 2 commits 2026-11-16 23:34:07 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-17 00:56:17 +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#162