ЛР 3 — БВТ2304 — Кошелев — на 4 #26

Closed
Iicon18 wants to merge 3 commits from Iicon18/mtusi2026lab3:solution/bvt2304-koshelev into main
First-time contributor

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

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

Что реализовано и что перенесено: из lab2 перенесены FastAPI-приложение, PostgreSQL (источник истины, сессии), Valkey (общий кэш сессий), Argon2id, сервис миграций. В lab3 добавлено:

  • HAProxy 3.2 — единственная публичная точка входа. Адреса реплик берутся из Docker DNS (server-template), /health/ready проверяется каждую 1 с (fall 2 / rise 2), неудачное соединение повторяется на другой реплике (redispatch). Sticky sessions не используются;
  • api с deploy.replicas: 2, без опубликованных портов и container_name. У всех контейнеров лимиты CPU/RAM, БД и кэш вынесены во внутреннюю сеть data;
  • X-Instance-Id (случайный идентификатор процесса) в каждом ответе;
  • обязательный Idempotency-Key: таблица idempotency_keys, ключ и сообщение записываются одной транзакцией (INSERT … ON CONFLICT). Одновременные повторы через разные реплики создают одно сообщение, другое тело с тем же ключом даёт 409;
  • миграции выполняются один раз, отдельным сервисом migrate, до старта реплик;
  • скрипты stop-one.sh, restore.sh, restart.sh, rolling-update.sh; собственные тесты student-tests/idempotency_test.py и student-tests/chaos_load.py.

Команды запуска из чистого clone:
make secrets && cp .env.example .env
docker compose --env-file .env up -d --build --wait
make test
make test-failover ACTION_SCRIPT=scripts/stop-one.sh && make restore
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-student && make chaos
Полный сценарий защиты описан в DEMO.md и проверен на свежем clone в отдельном compose-проекте.

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

  • make check, make test — PASS;
  • make test-failover — PASS, обе реплики остановлены по очереди, 0 неудачных попыток, запись восстанавливается за 1.6–3.7 с;
  • make test-persistence — PASS, перезапущены api, lb, postgres и valkey, прежний токен работает;
  • идемпотентность: 5 раундов по 32 одновременных запроса (16/16 по репликам) — каждый раз ровно одно сообщение;
  • остановка каждой реплики под нагрузкой (8 потоков): ~600 RPS, 0 ошибок, p99 ≈ 60 мс, восстановление ≈ 2.5 с, без потерь и дублей;
  • rolling update под нагрузкой: 0 ошибок из ~41 000 запросов.

Ограничения / известные ошибки: стенд выдерживает отказ одного процесса API. HAProxy, PostgreSQL и Docker-host остаются единственными точками отказа. Пока реплика выводится из ротации, отдельные запросы ждут до ~1 с (timeout connect + повтор), но ошибок нет. Ключи идемпотентности старше 24 ч удаляются только при повторном использовании того же ключа, фоновой очистки нет. Совместимость миграций с работающей версией сохраняется, пока они только добавляют объекты.

Источники и использование ИИ: FastAPI, uvicorn, asyncpg, redis-py, argon2-cffi; документация HAProxy, Docker Compose и PostgreSQL. При доработке, тестах и отчёте использовался ИИ-ассистент Claude (Anthropic); решения проверены автором, и он может их объяснить.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 Автор / группа: Кошелев, БВТ2304 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен Что реализовано и что перенесено: из lab2 перенесены FastAPI-приложение, PostgreSQL (источник истины, сессии), Valkey (общий кэш сессий), Argon2id, сервис миграций. В lab3 добавлено: - HAProxy 3.2 — единственная публичная точка входа. Адреса реплик берутся из Docker DNS (`server-template`), `/health/ready` проверяется каждую 1 с (fall 2 / rise 2), неудачное соединение повторяется на другой реплике (`redispatch`). Sticky sessions не используются; - `api` с `deploy.replicas: 2`, без опубликованных портов и `container_name`. У всех контейнеров лимиты CPU/RAM, БД и кэш вынесены во внутреннюю сеть `data`; - `X-Instance-Id` (случайный идентификатор процесса) в каждом ответе; - обязательный `Idempotency-Key`: таблица `idempotency_keys`, ключ и сообщение записываются одной транзакцией (`INSERT … ON CONFLICT`). Одновременные повторы через разные реплики создают одно сообщение, другое тело с тем же ключом даёт 409; - миграции выполняются один раз, отдельным сервисом `migrate`, до старта реплик; - скрипты `stop-one.sh`, `restore.sh`, `restart.sh`, `rolling-update.sh`; собственные тесты `student-tests/idempotency_test.py` и `student-tests/chaos_load.py`. Команды запуска из чистого clone: make secrets && cp .env.example .env docker compose --env-file .env up -d --build --wait make test make test-failover ACTION_SCRIPT=scripts/stop-one.sh && make restore make test-persistence ACTION_SCRIPT=scripts/restart.sh make test-student && make chaos Полный сценарий защиты описан в DEMO.md и проверен на свежем clone в отдельном compose-проекте. Результаты проверок и ссылка на REPORT.md: подробности в REPORT.md, реальный вывод команд в evidence/. - `make check`, `make test` — PASS; - `make test-failover` — PASS, обе реплики остановлены по очереди, 0 неудачных попыток, запись восстанавливается за 1.6–3.7 с; - `make test-persistence` — PASS, перезапущены api, lb, postgres и valkey, прежний токен работает; - идемпотентность: 5 раундов по 32 одновременных запроса (16/16 по репликам) — каждый раз ровно одно сообщение; - остановка каждой реплики под нагрузкой (8 потоков): ~600 RPS, 0 ошибок, p99 ≈ 60 мс, восстановление ≈ 2.5 с, без потерь и дублей; - rolling update под нагрузкой: 0 ошибок из ~41 000 запросов. Ограничения / известные ошибки: стенд выдерживает отказ одного процесса API. HAProxy, PostgreSQL и Docker-host остаются единственными точками отказа. Пока реплика выводится из ротации, отдельные запросы ждут до ~1 с (`timeout connect` + повтор), но ошибок нет. Ключи идемпотентности старше 24 ч удаляются только при повторном использовании того же ключа, фоновой очистки нет. Совместимость миграций с работающей версией сохраняется, пока они только добавляют объекты. Источники и использование ИИ: FastAPI, uvicorn, asyncpg, redis-py, argon2-cffi; документация HAProxy, Docker Compose и PostgreSQL. При доработке, тестах и отчёте использовался ИИ-ассистент Claude (Anthropic); решения проверены автором, и он может их объяснить. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Iicon18 added 3 commits 2026-10-21 12:57:35 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-31 00:09:01 +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#26