ЛР 3 — БВТ2302 — Заморский — на 5 #168

Open
0pavel1 wants to merge 1 commits from 0pavel1/mtusi2026lab3:solution/bvt2302-zamorskiy into main
First-time contributor

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

Автор / группа: Заморский Павел, БВТ2302
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: Трек 1 (Цена масштабирования: серии при фиксированном и растущем бюджете 1/2/4 реплик, поиск saturation point БД и подтверждённая оптимизация)

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

  • Перенесена кодовая база ЛР2 (cmd/server, internal/auth, internal/model, internal/store, internal/handler, migrations/001_init.sql, Dockerfile, infra/redis.conf).
  • Добавлен балансировщик HAProxy 3.0 (infra/haproxy.cfg) как единая точка входа (8080->80), balance roundrobin без sticky sessions, активный healthcheck GET /health/ready (inter 1s, fastinter 500ms, fall 2, rise 1) и динамическое DNS-обнаружение (resolvers docker_dns, server-template api 1-8).
  • Реализован X-Instance-Id (InstanceIDMiddleware) на каждом ответе API и согласованный graceful drain на SIGTERM (/health/ready сразу отдаёт 503 на 1.5с перед srv.Shutdown).
  • Добавлена транзакционная идемпотентность POST /api/v1/chats/{chat_id}/messages по Idempotency-Key (migrations/002_idempotency.sql, PRIMARY KEY (user_id, chat_id, idempotency_key), канонический хеш тела, 409 при другом теле, безопасный rollback при конкурентном повторе на разных репликах).
  • Миграции вынесены в одноразовый init-сервис migrate (-migrate-only с pg_advisory_xact_lock); порты реплик api наружу не публикуются, для всех контейнеров заданы CPU/RAM-лимиты, отсутствуют container_name.

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

cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
make test-grade4
make test-track1

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

  • make check, make test, make test-persistence и make test-failover (observed_instances_before=2, successful_writes=142, failed_attempts=0, first_recovery_seconds=2.929) проходят с PASS.
  • make test-grade4 (sequential_failover обеих реплик: 1354/1354, 0 ошибок; rolling_update: 1476/1476, 0 ошибок) и make test-track1 (+37.59% RPS, p50 снизился с 77.49 до 13.23 ms) подтверждены в REPORT.md и evidence/.

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

  • Стенд работает на одном Docker-хосте (PostgreSQL 18, Redis 7.4 и HAProxy остаются единичными SPOF на уровне узла).

Источники и использование ИИ:

  • Документация Docker Compose, HAProxy 3.0 (resolvers, http-check), PostgreSQL 18 (Transactions, advisory locks), jackc/pgx/v5, redis/go-redis/v9, RFC 7617. Помощь ИИ при генерации тестовых/нагрузочных скриптов и оформлении отчёта.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.

  • Контракт и публичные тесты не ослаблены.

  • make check и make test выполнены; приложен реальный вывод.

  • Сценарии отказов/безопасности своего уровня воспроизведены.

  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.

  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.

## Лабораторная 3 Автор / группа: Заморский Павел, БВТ2302 Целевая оценка (3/4/5): 5 Трек 5, если заявлен: Трек 1 (Цена масштабирования: серии при фиксированном и растущем бюджете 1/2/4 реплик, поиск saturation point БД и подтверждённая оптимизация) Что реализовано и что перенесено: - Перенесена кодовая база ЛР2 (`cmd/server`, `internal/auth`, `internal/model`, `internal/store`, `internal/handler`, `migrations/001_init.sql`, `Dockerfile`, `infra/redis.conf`). - Добавлен балансировщик HAProxy 3.0 (`infra/haproxy.cfg`) как единая точка входа (`8080->80`), `balance roundrobin` без sticky sessions, активный healthcheck `GET /health/ready` (`inter 1s`, `fastinter 500ms`, `fall 2`, `rise 1`) и динамическое DNS-обнаружение (`resolvers docker_dns`, `server-template api 1-8`). - Реализован `X-Instance-Id` (`InstanceIDMiddleware`) на каждом ответе API и согласованный graceful drain на `SIGTERM` (`/health/ready` сразу отдаёт `503` на 1.5с перед `srv.Shutdown`). - Добавлена транзакционная идемпотентность `POST /api/v1/chats/{chat_id}/messages` по `Idempotency-Key` (`migrations/002_idempotency.sql`, `PRIMARY KEY (user_id, chat_id, idempotency_key)`, канонический хеш тела, `409` при другом теле, безопасный rollback при конкурентном повторе на разных репликах). - Миграции вынесены в одноразовый init-сервис `migrate` (`-migrate-only` с `pg_advisory_xact_lock`); порты реплик `api` наружу не публикуются, для всех контейнеров заданы CPU/RAM-лимиты, отсутствуют `container_name`. Команды запуска из чистого clone: ```sh cp .env.example .env docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build make check make test make test-persistence ACTION_SCRIPT=scripts/restart.sh make test-failover ACTION_SCRIPT=scripts/stop-one.sh make test-grade4 make test-track1 ``` Результаты проверок и ссылка на REPORT.md: - `make check`, `make test`, `make test-persistence` и `make test-failover` (`observed_instances_before=2`, `successful_writes=142`, `failed_attempts=0`, `first_recovery_seconds=2.929`) проходят с `PASS`. - `make test-grade4` (`sequential_failover` обеих реплик: `1354/1354`, `0` ошибок; `rolling_update`: `1476/1476`, `0` ошибок) и `make test-track1` (`+37.59% RPS`, `p50` снизился с `77.49` до `13.23 ms`) подтверждены в [REPORT.md](REPORT.md) и `evidence/`. Ограничения / известные ошибки: - Стенд работает на одном Docker-хосте (PostgreSQL 18, Redis 7.4 и HAProxy остаются единичными SPOF на уровне узла). Источники и использование ИИ: - Документация Docker Compose, HAProxy 3.0 (`resolvers`, `http-check`), PostgreSQL 18 (Transactions, advisory locks), `jackc/pgx/v5`, `redis/go-redis/v9`, RFC 7617. Помощь ИИ при генерации тестовых/нагрузочных скриптов и оформлении отчёта. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
0pavel1 added 1 commit 2026-11-19 19:28:42 +03:00
0pavel1 changed title from feat(lab3): HAProxy LB, stateless API replicas, X-Instance-Id, Idempotency-Key, Grade 5 Track 1 to ЛР 3 — БВТ2302 — Заморский — на 5 2026-11-19 19:29:25 +03:00
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u https://gitea.privcloud.tech/0pavel1/mtusi2026lab3 solution/bvt2302-zamorskiy:0pavel1-solution/bvt2302-zamorskiy
git checkout 0pavel1-solution/bvt2302-zamorskiy
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab3#168