ЛР3 - Максимова Мария - БВТ2303 - на 4 #24

Closed
Mariia_Maksimova wants to merge 7 commits from Mariia_Maksimova/mtusi2026lab3:solution/maksimova_bvt2303 into main
First-time contributor

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

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

Что реализовано и что перенесено:
Из lab2 перенесены app/, миграции 001–002, scripts/migrate.py, scripts/init-secrets.sh, PostgreSQL как источник истины и Valkey как общий кэш сессий. Новое в lab3:

  • HAProxy 3.0 — единственная публичная точка входа :8080; сервис api в 2 репликах (deploy.replicas), без ports и container_name.
  • Обнаружение реплик через DNS Docker (server-template + resolvers), балансировка round-robin без sticky session.
  • Активная проверка /health/ready раз в 1 s (fall 2, rise 2) + пассивная (observe layer4); повтор на другую реплику при ошибке соединения; L7-повтор только для GET и POST сообщения с Idempotency-Key.
  • Заголовок X-Instance-Id в каждом ответе API.
  • Общая идемпотентность POST /chats/{id}/messages (миграция 003_idempotency_keys.sql): ключ и сообщение пишутся в одной транзакции PostgreSQL, повтор → то же сообщение, другое тело → 409.
  • Graceful shutdown: при SIGTERM drain 3 s (readiness 503), затем закрытие порта и ожидание запросов ≤ 8 s; stop_grace_period: 15s. Dockerfile переведён на exec-форму CMD (SIGTERM доходит до процесса).
  • Миграции выполняет отдельный сервис migrate один раз до старта API (pg_advisory_lock).
  • CPU/RAM-лимиты у всех сервисов, сеть backend — internal, секреты через Docker secrets.
  • Скрипты: stop-one.sh, kill-one.sh, start-api.sh, restart.sh, rolling-update.sh.

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

sh scripts/init-secrets.sh
cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait
make check
make test
docker compose --profile tools run --rm tester make test-failover ACTION_SCRIPT=scripts/stop-one.sh
docker compose --profile tools run --rm tester sh scripts/start-api.sh
docker compose --profile tools run --rm tester make test-persistence ACTION_SCRIPT=scripts/restart.sh
## Лабораторная 3 Автор / группа: Максимова Мария, БВТ2303 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен Что реализовано и что перенесено: Из lab2 перенесены `app/`, миграции 001–002, `scripts/migrate.py`, `scripts/init-secrets.sh`, PostgreSQL как источник истины и Valkey как общий кэш сессий. Новое в lab3: - HAProxy 3.0 — единственная публичная точка входа `:8080`; сервис `api` в 2 репликах (`deploy.replicas`), без `ports` и `container_name`. - Обнаружение реплик через DNS Docker (`server-template` + `resolvers`), балансировка round-robin без sticky session. - Активная проверка `/health/ready` раз в 1 s (`fall 2`, `rise 2`) + пассивная (`observe layer4`); повтор на другую реплику при ошибке соединения; L7-повтор только для GET и POST сообщения с `Idempotency-Key`. - Заголовок `X-Instance-Id` в каждом ответе API. - Общая идемпотентность `POST /chats/{id}/messages` (миграция `003_idempotency_keys.sql`): ключ и сообщение пишутся в одной транзакции PostgreSQL, повтор → то же сообщение, другое тело → 409. - Graceful shutdown: при SIGTERM drain 3 s (readiness 503), затем закрытие порта и ожидание запросов ≤ 8 s; `stop_grace_period: 15s`. Dockerfile переведён на exec-форму CMD (SIGTERM доходит до процесса). - Миграции выполняет отдельный сервис `migrate` один раз до старта API (`pg_advisory_lock`). - CPU/RAM-лимиты у всех сервисов, сеть `backend` — `internal`, секреты через Docker secrets. - Скрипты: `stop-one.sh`, `kill-one.sh`, `start-api.sh`, `restart.sh`, `rolling-update.sh`. Команды запуска из чистого clone: ```sh sh scripts/init-secrets.sh cp .env.example .env docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build --wait make check make test docker compose --profile tools run --rm tester make test-failover ACTION_SCRIPT=scripts/stop-one.sh docker compose --profile tools run --rm tester sh scripts/start-api.sh docker compose --profile tools run --rm tester make test-persistence ACTION_SCRIPT=scripts/restart.sh
Mariia_Maksimova added 3 commits 2026-10-20 15:13:01 +03:00
Mariia_Maksimova changed title from Solution/maksimova bvt2303 to ЛР3 - Максимова Мария - БВТ2303 2026-10-20 15:13:35 +03:00
Mariia_Maksimova changed title from ЛР3 - Максимова Мария - БВТ2303 to ЛР3 - Максимова Мария - БВТ2303 - на4 2026-10-20 15:13:55 +03:00
Mariia_Maksimova changed title from ЛР3 - Максимова Мария - БВТ2303 - на4 to ЛР3 - Максимова Мария - БВТ2303 - на 4 2026-10-20 15:14:05 +03:00
Mariia_Maksimova added 1 commit 2026-10-20 16:12:01 +03:00
Owner

Существенные замечания:

  1. Вход игнорирует переданное тело запроса.
    Минимальный пример: POST /api/v1/auth/sessions с действительным Basic, Content-Type: application/json и телом {bad. Ожидается 400 invalid_request, фактически — 201, создаётся сессия. Аналогично принимается {}. Обработчик читает только Authorization: app/main.py:215. Требования к malformed JSON и входу заданы в contracts/README.md.
  2. Не соблюдается максимум 100 участников чата.
    Передать в POST /api/v1/chats 101 уникальный существующий UUID, включая вызывающего. Ожидается 400, фактически — 201 с созданием чата вне схемы контракта. Граница 100 проходит. В app/models.py:64 отсутствует max_length=100; нормативный предел — contracts/openapi.json:2360.
Существенные замечания: 1. Вход игнорирует переданное тело запроса. Минимальный пример: POST /api/v1/auth/sessions с действительным Basic, Content-Type: application/json и телом {bad. Ожидается 400 invalid_request, фактически — 201, создаётся сессия. Аналогично принимается {}. Обработчик читает только Authorization: [app/main.py:215](https://gitea.privcloud.tech/Mariia_Maksimova/mtusi2026lab3/src/commit/41bdfcfea28ca7919e9d0c2b745991e4d05f5ffe/app/main.py#L215). Требования к malformed JSON и входу заданы в contracts/README.md. 2. Не соблюдается максимум 100 участников чата. Передать в POST /api/v1/chats 101 уникальный существующий UUID, включая вызывающего. Ожидается 400, фактически — 201 с созданием чата вне схемы контракта. Граница 100 проходит. В [app/models.py:64](https://gitea.privcloud.tech/Mariia_Maksimova/mtusi2026lab3/src/commit/41bdfcfea28ca7919e9d0c2b745991e4d05f5ffe/app/models.py#L64) отсутствует max_length=100; нормативный предел — [contracts/openapi.json:2360](https://gitea.privcloud.tech/Mariia_Maksimova/mtusi2026lab3/src/commit/41bdfcfea28ca7919e9d0c2b745991e4d05f5ffe/contracts/openapi.json#L2360).
Mariia_Maksimova added 1 commit 2026-10-20 21:35:15 +03:00
Mariia_Maksimova added 2 commits 2026-10-23 22:24:17 +03:00
Owner

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

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