ЛР 3 — БВТ2303 — Пластинин — на 5 #1

Closed
dizi wants to merge 7 commits from dizi/mtusi2026lab3:solution/bvt2303-plastinin into main
First-time contributor

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

Автор / группа: Пластинин Денис / БВТ2303
Целевая оценка: 5
Трек 5: трек 1 — цена масштабирования

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

  • сохранён минимум лабораторной 2: PostgreSQL, versioned migrations, Argon2id и общие сессии в Valkey;
  • Nginx round-robin перед двумя и более stateless API-репликами с Docker DNS discovery;
  • X-Instance-Id, graceful shutdown, readiness и остановка выбранной реплики;
  • общая PostgreSQL-идемпотентность сообщений с конкурентной black-box проверкой через разные реплики;
  • отдельный запуск миграций командой messenger migrate;
  • rolling update 2→3→2 под нагрузкой;
  • Prometheus, Grafana и exporters для API, Nginx, PostgreSQL и Valkey;
  • CI и ручной deployment workflow с проверкой точного SHA.

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

cp lab3.env.example .env
docker compose up -d --build --scale api=2 --wait --wait-timeout 120
make test
docker compose --profile tests run --rm --build tests
go run ./cmd/dependencycheck -base-url=http://localhost:8080
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh

Исследование трека 1:

DURATION=6s WARMUP=2s REPEATS=3 CONCURRENCIES='8 32 64' scripts/run-scale-experiment.sh

Результаты проверок

  • CI полного решения: success, 4m21s;
  • конкурентный black-box: 16 одновременных запросов через Nginx, минимум два X-Instance-Id, один message ID и одна запись истории;
  • failover двух API-реплик: восстановление за 1.35–1.44 секунды;
  • rolling update: 134894 успешных запроса, 0 ошибок, 2248.16 RPS, p95 13.12 ms;
  • трек 1: 60 точек для 1/2/4 реплик, фиксированный и растущий бюджеты, три повтора, 0 HTTP-ошибок;
  • методика, результаты и ограничения приведены в REPORT.md, исходные данные и график — в evidence/.

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

Все компоненты размещены на одном Docker-хосте. Nginx, PostgreSQL и Valkey остаются SPOF; проверяется отказ процесса API, а не узла. Нагрузочный клиент closed-loop, поэтому результаты применимы для сравнения конфигураций этого стенда.

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

Использованы официальные материалы Nginx, Docker Compose, PostgreSQL, Valkey, RFC 9106 и документация Go-пакетов; ссылки перечислены в REPORT.md. OpenAI Codex использовался для подготовки кода, конфигурации и текста, результаты проверены CI и воспроизводимыми экспериментами.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 **Автор / группа:** Пластинин Денис / БВТ2303 **Целевая оценка:** 5 **Трек 5:** трек 1 — цена масштабирования ### Что реализовано и что перенесено - сохранён минимум лабораторной 2: PostgreSQL, versioned migrations, Argon2id и общие сессии в Valkey; - Nginx round-robin перед двумя и более stateless API-репликами с Docker DNS discovery; - `X-Instance-Id`, graceful shutdown, readiness и остановка выбранной реплики; - общая PostgreSQL-идемпотентность сообщений с конкурентной black-box проверкой через разные реплики; - отдельный запуск миграций командой `messenger migrate`; - rolling update 2→3→2 под нагрузкой; - Prometheus, Grafana и exporters для API, Nginx, PostgreSQL и Valkey; - CI и ручной deployment workflow с проверкой точного SHA. ### Команды запуска из чистого clone ```sh cp lab3.env.example .env docker compose up -d --build --scale api=2 --wait --wait-timeout 120 make test docker compose --profile tests run --rm --build tests go run ./cmd/dependencycheck -base-url=http://localhost:8080 make test-persistence ACTION_SCRIPT=scripts/restart.sh make test-failover ACTION_SCRIPT=scripts/stop-one.sh ``` Исследование трека 1: ```sh DURATION=6s WARMUP=2s REPEATS=3 CONCURRENCIES='8 32 64' scripts/run-scale-experiment.sh ``` ### Результаты проверок - [CI полного решения](https://gitea.privcloud.tech/dizi/mtusi2026lab3/actions/runs/45): success, 4m21s; - конкурентный black-box: 16 одновременных запросов через Nginx, минимум два `X-Instance-Id`, один message ID и одна запись истории; - failover двух API-реплик: восстановление за 1.35–1.44 секунды; - rolling update: 134894 успешных запроса, 0 ошибок, 2248.16 RPS, p95 13.12 ms; - трек 1: 60 точек для 1/2/4 реплик, фиксированный и растущий бюджеты, три повтора, 0 HTTP-ошибок; - методика, результаты и ограничения приведены в `REPORT.md`, исходные данные и график — в `evidence/`. ### Ограничения / известные ошибки Все компоненты размещены на одном Docker-хосте. Nginx, PostgreSQL и Valkey остаются SPOF; проверяется отказ процесса API, а не узла. Нагрузочный клиент closed-loop, поэтому результаты применимы для сравнения конфигураций этого стенда. ### Источники и использование ИИ Использованы официальные материалы Nginx, Docker Compose, PostgreSQL, Valkey, RFC 9106 и документация Go-пакетов; ссылки перечислены в `REPORT.md`. OpenAI Codex использовался для подготовки кода, конфигурации и текста, результаты проверены CI и воспроизводимыми экспериментами. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] `make check` и `make test` выполнены; приложен реальный вывод. - [x] Сценарии отказов своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
dizi added 7 commits 2026-10-02 17:44:22 +03:00
Owner

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

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