Lab 3: HAProxy + 2 replicas, idempotency, graceful shutdown, track 1 #157

Closed
sendormeco wants to merge 1 commits from sendormeco/mtusi2026lab3:lab3 into main
First-time contributor

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

Автор / группа: Лебедев Дмитрий Алексеевич, БВТ2302
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: трек 1 «Цена масштабирования»

Что реализовано и что перенесено: весь функционал lab2 сохранён (API, сессии в PostgreSQL + кэш Redis с outbox, все тесты lab2 проходят). Добавлено: HAProxy 3.0 как единственная точка входа (server-template + DNS Docker, проверки /health/ready, retry-on conn-failure + redispatch, panic mode, maxconn + очередь с JSON-ошибками), 2 stateless-реплики API без портов наружу, X-Instance-Id, Idempotency-Key для POST /messages, graceful shutdown по SIGTERM (readiness 503 → дообслуживание → выход), one-shot сервис миграций с проверкой совместимости схемы, rolling update с expand-only миграциями.
Команды запуска из чистого clone: ./scripts/init-secrets.sh, docker compose --env-file .env --profile ttl up -d --build --wait, make test BASE_URL=http://127.0.0.1:8080, make test-failover ACTION_SCRIPT=scripts/stop-one.sh BASE_URL=http://127.0.0.1:8080, ./scripts/start-replicas.sh, make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://127.0.0.1:8080; всё сразу — ./scripts/collect-evidence.sh (Windows: scripts\collect-evidence.ps1).
Результаты проверок и ссылка на REPORT.md: smoke PASS; failover ×2 PASS (0 неудачных записей из 138–139); persistence PASS (перезапущены LB, обе реплики, PostgreSQL, Redis); поочерёдный отказ каждой реплики под нагрузкой: SIGTERM — 0 ошибок, SIGKILL — 5–8 ответов 502 за ≤ 0.1 с; повторы с тем же ключом — 0 дублей; нагрузка 236.8 RPS без ошибок, p99 47 мс. Трек 1: 15 конфигураций, ключевые ×3 — при том же суммарном CPU 1 × 1.0 CPU держит 240 rps при SLO против 200 у 2 × 0.5 и 160 у 4 × 0.25 (накладные расходы на реплику и троттлинг CFS). Подробности — REPORT.md, сырой вывод — evidence/.
Ограничения / известные ошибки: отказ хоста, единственного LB или PostgreSQL не выдерживается (SPOF стенда); rolling update на Windows — только из Git Bash/WSL; evidence собраны на локальных образах-заменителях (Docker Hub был недоступен) — описано в REPORT.md.
Источники и использование ИИ: документация Docker Compose, HAProxy 3.0, PostgreSQL, Linux CFS; решение подготовлено с помощью ИИ-ассистента Claude (Anthropic).

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 Автор / группа: Лебедев Дмитрий Алексеевич, БВТ2302 Целевая оценка (3/4/5): 5 Трек 5, если заявлен: трек 1 «Цена масштабирования» Что реализовано и что перенесено: весь функционал lab2 сохранён (API, сессии в PostgreSQL + кэш Redis с outbox, все тесты lab2 проходят). Добавлено: HAProxy 3.0 как единственная точка входа (server-template + DNS Docker, проверки `/health/ready`, `retry-on conn-failure` + redispatch, panic mode, `maxconn` + очередь с JSON-ошибками), 2 stateless-реплики API без портов наружу, `X-Instance-Id`, `Idempotency-Key` для `POST /messages`, graceful shutdown по SIGTERM (readiness 503 → дообслуживание → выход), one-shot сервис миграций с проверкой совместимости схемы, rolling update с expand-only миграциями. Команды запуска из чистого clone: `./scripts/init-secrets.sh`, `docker compose --env-file .env --profile ttl up -d --build --wait`, `make test BASE_URL=http://127.0.0.1:8080`, `make test-failover ACTION_SCRIPT=scripts/stop-one.sh BASE_URL=http://127.0.0.1:8080`, `./scripts/start-replicas.sh`, `make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://127.0.0.1:8080`; всё сразу — `./scripts/collect-evidence.sh` (Windows: `scripts\collect-evidence.ps1`). Результаты проверок и ссылка на REPORT.md: smoke PASS; failover ×2 PASS (0 неудачных записей из 138–139); persistence PASS (перезапущены LB, обе реплики, PostgreSQL, Redis); поочерёдный отказ каждой реплики под нагрузкой: SIGTERM — 0 ошибок, SIGKILL — 5–8 ответов 502 за ≤ 0.1 с; повторы с тем же ключом — 0 дублей; нагрузка 236.8 RPS без ошибок, p99 47 мс. Трек 1: 15 конфигураций, ключевые ×3 — при том же суммарном CPU 1 × 1.0 CPU держит 240 rps при SLO против 200 у 2 × 0.5 и 160 у 4 × 0.25 (накладные расходы на реплику и троттлинг CFS). Подробности — [REPORT.md](REPORT.md), сырой вывод — `evidence/`. Ограничения / известные ошибки: отказ хоста, единственного LB или PostgreSQL не выдерживается (SPOF стенда); rolling update на Windows — только из Git Bash/WSL; evidence собраны на локальных образах-заменителях (Docker Hub был недоступен) — описано в REPORT.md. Источники и использование ИИ: документация Docker Compose, HAProxy 3.0, PostgreSQL, Linux CFS; решение подготовлено с помощью ИИ-ассистента Claude (Anthropic). - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
sendormeco added 1 commit 2026-11-16 21:52:25 +03:00
Owner

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

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