ЛР 3 — БПИ2304 — Ремез — на 5 #74

Closed
OlegRood wants to merge 4 commits from OlegRood/mtusi2026lab3:solution/BPI2304-remez into main
First-time contributor

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

API мессенджера работает двумя взаимозаменяемыми репликами за HAProxy. Общие PostgreSQL и Redis сохраняют сообщения и сессии; повтор отправки с тем же ключом не создаёт дубль при конкуренции, timeout, рестарте и отказе реплики.

Автор / группа: Ремез Олег Романович, БПИ2304.
Целевая оценка: 5.
Трек 5: 1 — «Цена масштабирования».

Реализация

Из lab2 перенесены Go API, PostgreSQL, Redis-сессии, Goose/sqlc, миграции и собственные тесты. Добавлены HAProxy с readiness/Docker DNS, X-Instance-Id, транзакционная идемпотентность (user_id, chat_id, key), однократный мигратор и явные restart/failover/rolling hooks. API не публикуют порты, контейнеры имеют CPU/RAM-лимиты. При финальной проверке устранён OOM четырёх конкурентных регистраций: лимит каждой API увеличен с 256 до 512 MiB; KDF не ослаблялся. Исправлены воспроизводимость sqlc-генерации и TCP healthcheck PostgreSQL.

Трек 1: сравнение 1/2/4 API при фиксированных суммарных CPU/RAM и пуле, серия роста ресурсов, сырые измерения и графики. Причинный опыт с БД 0,5→2 vCPU при неизменных API дал консервативный прирост завершённых POST/с в 4,24 раза с возвратом/повтором. Это отдельный ограниченный бюджет БД, не ускорение основного стенда, где уже было 2 CPU. Group commit уменьшил WAL fsync на сообщение на 59,4%; прирост RPS от него не заявляется.

Запуск из чистого clone

REPORT.md: bootstrap .env/secrets, версии, запуск и доказательства. После bootstrap:

docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait --wait-timeout 120
# Дождаться успешного /health/ready через LB по инструкции REPORT.md.
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
docker compose --env-file .env up -d --no-build --no-recreate --scale api=2 api

Результаты

  • Полный lab3: все проверки PASS, включая 11 сценариев идемпотентности, отказ каждой API, readiness/SIGTERM, однократные миграции и rolling под нагрузкой. Rolling: 0 HTTP-ошибок, обе реплики заменены, минимум одна ready.
  • Публичные тесты преподавателя: smoke, persistence и failover обеих реплик — PASS. Краткая ошибка одного аварийного отключения сохранена; восстановление через 2,438 с укладывается в требование 10 с.
  • Чистый clone: все 20 этапов PASS; 43 Go race-теста, 0 FAIL/0 SKIP; build/vet, auth, бизнес-границы/курсоры, SQL-план, persistence, отказы PostgreSQL/Redis и TTL.
  • Контролируемый auth-опыт: 256 MiB — OOM и рестарт; 512 MiB — весь набор PASS, 0 OOM/рестартов. Исследовательские данные, настройки durability, лимиты и cleanup проверены.

Итоговые результаты и сохранённые неудачные попытки.

Ограничения и источники

Проверен отказ API-процесса на одном host. Единственные LB/PostgreSQL/Redis остаются SPOF. Исторические ошибки не удалены; локальные замеры не являются универсальным пределом RPS. Диагностический synchronous_commit=off не входит в рабочую конфигурацию. Удалённый CI оценивается отдельно после публикации.

Источники: задание, OpenAPI и семантика исходного репозитория, официальная документация PostgreSQL/Docker/HAProxy/Go. При проектировании, согласованных правках, тестировании, исследованиях и оформлении использовался OpenAI Codex; ссылки и методика приведены в REPORT.md.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию решения.
## Лабораторная 3 API мессенджера работает двумя взаимозаменяемыми репликами за HAProxy. Общие PostgreSQL и Redis сохраняют сообщения и сессии; повтор отправки с тем же ключом не создаёт дубль при конкуренции, timeout, рестарте и отказе реплики. Автор / группа: Ремез Олег Романович, БПИ2304. Целевая оценка: **5**. Трек 5: **1 — «Цена масштабирования»**. ### Реализация Из lab2 перенесены Go API, PostgreSQL, Redis-сессии, Goose/sqlc, миграции и собственные тесты. Добавлены HAProxy с readiness/Docker DNS, X-Instance-Id, транзакционная идемпотентность `(user_id, chat_id, key)`, однократный мигратор и явные restart/failover/rolling hooks. API не публикуют порты, контейнеры имеют CPU/RAM-лимиты. При финальной проверке устранён OOM четырёх конкурентных регистраций: лимит каждой API увеличен с 256 до 512 MiB; KDF не ослаблялся. Исправлены воспроизводимость sqlc-генерации и TCP healthcheck PostgreSQL. Трек 1: сравнение 1/2/4 API при фиксированных суммарных CPU/RAM и пуле, серия роста ресурсов, сырые измерения и графики. Причинный опыт с БД 0,5→2 vCPU при неизменных API дал консервативный прирост завершённых POST/с в 4,24 раза с возвратом/повтором. Это отдельный ограниченный бюджет БД, не ускорение основного стенда, где уже было 2 CPU. Group commit уменьшил WAL fsync на сообщение на 59,4%; прирост RPS от него не заявляется. ### Запуск из чистого clone [REPORT.md: bootstrap .env/secrets, версии, запуск и доказательства](https://gitea.privcloud.tech/OlegRood/mtusi2026lab3/src/branch/solution/BPI2304-remez/REPORT.md). После bootstrap: ```sh docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build --wait --wait-timeout 120 # Дождаться успешного /health/ready через LB по инструкции REPORT.md. make check make test make test-persistence ACTION_SCRIPT=scripts/restart.sh make test-failover ACTION_SCRIPT=scripts/stop-one.sh docker compose --env-file .env up -d --no-build --no-recreate --scale api=2 api ``` ### Результаты - Полный lab3: все проверки PASS, включая 11 сценариев идемпотентности, отказ каждой API, readiness/SIGTERM, однократные миграции и rolling под нагрузкой. Rolling: 0 HTTP-ошибок, обе реплики заменены, минимум одна ready. - Публичные тесты преподавателя: smoke, persistence и failover обеих реплик — PASS. Краткая ошибка одного аварийного отключения сохранена; восстановление через 2,438 с укладывается в требование 10 с. - Чистый clone: все 20 этапов PASS; 43 Go race-теста, 0 FAIL/0 SKIP; build/vet, auth, бизнес-границы/курсоры, SQL-план, persistence, отказы PostgreSQL/Redis и TTL. - Контролируемый auth-опыт: 256 MiB — OOM и рестарт; 512 MiB — весь набор PASS, 0 OOM/рестартов. Исследовательские данные, настройки durability, лимиты и cleanup проверены. [Итоговые результаты и сохранённые неудачные попытки](https://gitea.privcloud.tech/OlegRood/mtusi2026lab3/src/branch/solution/BPI2304-remez/evidence/submission-final-2026-10-30). ### Ограничения и источники Проверен отказ API-процесса на одном host. Единственные LB/PostgreSQL/Redis остаются SPOF. Исторические ошибки не удалены; локальные замеры не являются универсальным пределом RPS. Диагностический synchronous_commit=off не входит в рабочую конфигурацию. Удалённый CI оценивается отдельно после публикации. Источники: задание, OpenAPI и семантика исходного репозитория, официальная документация PostgreSQL/Docker/HAProxy/Go. При проектировании, согласованных правках, тестировании, исследованиях и оформлении использовался OpenAI Codex; ссылки и методика приведены в REPORT.md. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию решения.
OlegRood added 3 commits 2026-10-30 13:44:13 +03:00
OlegRood added 1 commit 2026-10-30 17:29:32 +03:00
Owner

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

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