ЛР 3 - БВТ2302 - Саргсян - на 4 #126

Closed
sargsona wants to merge 3 commits from sargsona/mtusi2026lab3:solution/bvt2302-sargsyan into main
First-time contributor

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

Автор / группа: Саргсян Сона, БВТ2302
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен

Что реализовано и что перенесено:

  • Перенесено из lab2: приложение (FastAPI, PostgreSQL, Argon2id, сессии, Valkey-кэш), миграция 001, Dockerfile, собственные тесты.
  • Уровень 3: Compose-стенд с HAProxy и ≥2 репликами API (число задаётся API_REPLICAS), общие PostgreSQL и сессии, X-Instance-Id, обязательный Idempotency-Key с общей идемпотентностью в PostgreSQL (атомарно, в одной транзакции), отдельный сервис миграций, scripts/stop-one.sh, scripts/restart.sh.
  • Уровень 4: readiness и drain при SIGTERM (5 с), активные проверки LB раз в 1 с (максимум 4 с до исключения), лимиты CPU/RAM, нет published-портов и container_name у API, нагрузка с поочерёдным отказом каждой реплики, параллельная идемпотентность, rolling update под нагрузкой.
  • Исправления базы из lab2: миграции вынесены из старта API в отдельный сервис; test_sigterm.py приведён к новой логике завершения (readiness 503, затем закрытие порта).

Команды запуска из чистого clone: см. раздел «Запуск из чистого clone» в REPORT.md. Кратко:

mkdir -p secrets && PW=$(openssl rand -hex 24)
printf '%s' "$PW" > secrets/postgres_password
printf 'postgresql://messenger:%s@postgres:5432/messenger' "$PW" > secrets/database_url
chmod 644 secrets/* && cp .env.example .env && chmod +x scripts/*.sh
docker compose --env-file .env up -d --build
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh

Результаты проверок и ссылка на REPORT.md: REPORT.md, исходные данные в evidence/.

  • make test: PASS (evidence/smoke.txt, evidence/smoke-level4.txt).
  • Persistence: PASS, с подтверждением перезапуска контейнеров (evidence/persistence*.txt, evidence/restart-before.txt, evidence/restart-after.txt).
  • Failover для обеих реплик: 0 ошибок, восстановление записи 1,6-2,2 с при лимите 10 с.
  • Нагрузка (8 потоков): 856 RPS с двумя репликами; при остановке одной реплики 0 ошибок, максимальная пауза 0,17–0,22 с.
  • Параллельная идемпотентность: 5 раундов по 30 запросов с одним ключом, в истории ровно 5 сообщений.
  • Rolling update v1→v2 под нагрузкой: 95 152 запроса, 0 ошибок.
  • SIGTERM: оба сценария PASS, код выхода 0.

Ограничения / известные ошибки:

  • Один Docker-host; PostgreSQL, Valkey и HAProxy в единственном экземпляре (SPOF). Заявляется только устойчивость к отказу одной API-реплики.
  • Нагрузочный генератор closed-loop, на той же машине, что и стенд; по одному запуску на сценарий; параметры железа не фиксировались.
  • Просроченные ключи идемпотентности не очищаются.
  • Уровень 5 не выполнялся.

Источники и использование ИИ: Claude Code. Библиотеки: FastAPI, Pydantic, Uvicorn, asyncpg, argon2-cffi, redis-py. Код lab2 из моей собственной ветки.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 Автор / группа: Саргсян Сона, БВТ2302 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен Что реализовано и что перенесено: - Перенесено из lab2: приложение (FastAPI, PostgreSQL, Argon2id, сессии, Valkey-кэш), миграция 001, Dockerfile, собственные тесты. - Уровень 3: Compose-стенд с HAProxy и ≥2 репликами API (число задаётся `API_REPLICAS`), общие PostgreSQL и сессии, `X-Instance-Id`, обязательный `Idempotency-Key` с общей идемпотентностью в PostgreSQL (атомарно, в одной транзакции), отдельный сервис миграций, `scripts/stop-one.sh`, `scripts/restart.sh`. - Уровень 4: readiness и drain при SIGTERM (5 с), активные проверки LB раз в 1 с (максимум 4 с до исключения), лимиты CPU/RAM, нет published-портов и `container_name` у API, нагрузка с поочерёдным отказом каждой реплики, параллельная идемпотентность, rolling update под нагрузкой. - Исправления базы из lab2: миграции вынесены из старта API в отдельный сервис; `test_sigterm.py` приведён к новой логике завершения (readiness 503, затем закрытие порта). Команды запуска из чистого clone: см. раздел «Запуск из чистого clone» в `REPORT.md`. Кратко: ```sh mkdir -p secrets && PW=$(openssl rand -hex 24) printf '%s' "$PW" > secrets/postgres_password printf 'postgresql://messenger:%s@postgres:5432/messenger' "$PW" > secrets/database_url chmod 644 secrets/* && cp .env.example .env && chmod +x scripts/*.sh docker compose --env-file .env up -d --build make test make test-persistence ACTION_SCRIPT=scripts/restart.sh make test-failover ACTION_SCRIPT=scripts/stop-one.sh ``` Результаты проверок и ссылка на REPORT.md: `REPORT.md`, исходные данные в `evidence/`. - `make test`: PASS (`evidence/smoke.txt`, `evidence/smoke-level4.txt`). - Persistence: PASS, с подтверждением перезапуска контейнеров (`evidence/persistence*.txt`, `evidence/restart-before.txt`, `evidence/restart-after.txt`). - Failover для обеих реплик: 0 ошибок, восстановление записи 1,6-2,2 с при лимите 10 с. - Нагрузка (8 потоков): 856 RPS с двумя репликами; при остановке одной реплики 0 ошибок, максимальная пауза 0,17–0,22 с. - Параллельная идемпотентность: 5 раундов по 30 запросов с одним ключом, в истории ровно 5 сообщений. - Rolling update v1→v2 под нагрузкой: 95 152 запроса, 0 ошибок. - SIGTERM: оба сценария PASS, код выхода 0. Ограничения / известные ошибки: - Один Docker-host; PostgreSQL, Valkey и HAProxy в единственном экземпляре (SPOF). Заявляется только устойчивость к отказу одной API-реплики. - Нагрузочный генератор closed-loop, на той же машине, что и стенд; по одному запуску на сценарий; параметры железа не фиксировались. - Просроченные ключи идемпотентности не очищаются. - Уровень 5 не выполнялся. Источники и использование ИИ: Claude Code. Библиотеки: FastAPI, Pydantic, Uvicorn, asyncpg, argon2-cffi, redis-py. Код lab2 из моей собственной ветки. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
sargsona added 3 commits 2026-11-10 04:34:51 +03:00
Owner

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

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