Лаб 3 Гусак - БПИ2303 - на 4 #141

Closed
GusakDA wants to merge 1 commits from GusakDA/mtusi2026lab3:solution/bpi2303-gusak into main
First-time contributor

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

Автор / группа: Гусак Дмитрий / БПИ2303
Целевая оценка: 4
Трек 5: не заявлен

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

Перенесена функциональность лабораторной 2: Java Spring Boot API, PostgreSQL, Redis, регистрация пользователей, аутентификация, чаты, сообщения и миграции Flyway.

Для лабораторной 3 добавлены:

  • две API-реплики через Docker Compose;
  • HAProxy как единая точка входа и балансировщик;
  • общий Redis для сессий;
  • общая PostgreSQL для данных и идемпотентности;
  • заголовок X-Instance-Id;
  • обязательный Idempotency-Key для отправки сообщений;
  • защита от дублей при конкурентных запросах;
  • миграция V2 с таблицей message_idempotency;
  • healthcheck и readiness;
  • graceful shutdown;
  • таймауты запросов к базе;
  • CPU/RAM-лимиты;
  • отсутствие прямых опубликованных портов у API;
  • скрипты restart, failover и rolling update;
  • собственные тесты уровня 4.
    Команды запуска из чистого clone:

cp .env.example .env

Сгенерировать секрет:

openssl rand -base64 32 | tr '+/' '-_' | tr -d '='

Полученное значение вставить в файл .env в параметр CURSOR_SECRET.

Далее выполнить:

docker compose --env-file .env config --quiet

docker compose --env-file .env up -d --build --scale api=2

curl -i http://localhost:8080/health/ready

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-rolling

После failover-теста восстановить две реплики:

docker compose --env-file .env up -d --scale api=2

Остановка стенда:

docker compose --env-file .env down

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

./gradlew clean build — BUILD SUCCESSFUL

make check — PASS

make validate PYTHON=.venv/bin/python — PASS

make test — PASS

make test-grade4 — PASS

make test-persistence ACTION_SCRIPT=scripts/restart.sh — PASS

make test-failover ACTION_SCRIPT=scripts/stop-one.sh — PASS

make test-rolling — PASS

В failover-тесте проверены обе API-реплики. После остановки одной реплики запросы продолжали выполняться через вторую. Данные и существующая сессия сохранились.

Подробное описание архитектуры, запуска и результатов находится в REPORT.md.

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

  • HAProxy, PostgreSQL и Redis запущены в одном Docker Compose на одном хосте.
  • Отказоустойчивость самого Docker-хоста не реализована.
  • PostgreSQL и HAProxy являются одиночными компонентами.
  • TLS в учебном стенде не настроен.
  • Трек 5 с исследованием производительности и несколькими узлами не выполнялся.
  • Очистка старых записей идемпотентности автоматически не реализована; записи хранятся дольше требуемых 24 часов.
    Источники и использование ИИ:

Использовалась официальная документация Docker Compose, HAProxy, Spring Boot, PostgreSQL и Redis. ИИ использовался для разбора задания, проектирования архитектуры, объяснения кода, подготовки тестов и проверки реализации. Итоговый код, конфигурация и результаты тестирования проверены локально.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; реальный вывод приведён выше.
  • Сценарии отказов и безопасности уровня 4 воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит токенов.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
##Лабораторная 3 Автор / группа: Гусак Дмитрий / БПИ2303 Целевая оценка: 4 Трек 5: не заявлен Что реализовано и что перенесено: Перенесена функциональность лабораторной 2: Java Spring Boot API, PostgreSQL, Redis, регистрация пользователей, аутентификация, чаты, сообщения и миграции Flyway. Для лабораторной 3 добавлены: - две API-реплики через Docker Compose; - HAProxy как единая точка входа и балансировщик; - общий Redis для сессий; - общая PostgreSQL для данных и идемпотентности; - заголовок X-Instance-Id; - обязательный Idempotency-Key для отправки сообщений; - защита от дублей при конкурентных запросах; - миграция V2 с таблицей message_idempotency; - healthcheck и readiness; - graceful shutdown; - таймауты запросов к базе; - CPU/RAM-лимиты; - отсутствие прямых опубликованных портов у API; - скрипты restart, failover и rolling update; - собственные тесты уровня 4. Команды запуска из чистого clone: cp .env.example .env Сгенерировать секрет: openssl rand -base64 32 | tr '+/' '-_' | tr -d '=' Полученное значение вставить в файл .env в параметр CURSOR_SECRET. Далее выполнить: docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build --scale api=2 curl -i http://localhost:8080/health/ready 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-rolling После failover-теста восстановить две реплики: docker compose --env-file .env up -d --scale api=2 Остановка стенда: docker compose --env-file .env down Результаты проверок и ссылка на REPORT.md: ./gradlew clean build — BUILD SUCCESSFUL make check — PASS make validate PYTHON=.venv/bin/python — PASS make test — PASS make test-grade4 — PASS make test-persistence ACTION_SCRIPT=scripts/restart.sh — PASS make test-failover ACTION_SCRIPT=scripts/stop-one.sh — PASS make test-rolling — PASS В failover-тесте проверены обе API-реплики. После остановки одной реплики запросы продолжали выполняться через вторую. Данные и существующая сессия сохранились. Подробное описание архитектуры, запуска и результатов находится в REPORT.md. Ограничения / известные ошибки: - HAProxy, PostgreSQL и Redis запущены в одном Docker Compose на одном хосте. - Отказоустойчивость самого Docker-хоста не реализована. - PostgreSQL и HAProxy являются одиночными компонентами. - TLS в учебном стенде не настроен. - Трек 5 с исследованием производительности и несколькими узлами не выполнялся. - Очистка старых записей идемпотентности автоматически не реализована; записи хранятся дольше требуемых 24 часов. Источники и использование ИИ: Использовалась официальная документация Docker Compose, HAProxy, Spring Boot, PostgreSQL и Redis. ИИ использовался для разбора задания, проектирования архитектуры, объяснения кода, подготовки тестов и проверки реализации. Итоговый код, конфигурация и результаты тестирования проверены локально. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; реальный вывод приведён выше. - [x] Сценарии отказов и безопасности уровня 4 воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит токенов. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
GusakDA added 1 commit 2026-11-12 21:25:54 +03:00
GusakDA changed title from lab3 gusak to Лаб 3 Гусак - на 4 2026-11-12 23:08:47 +03:00
GusakDA changed title from Лаб 3 Гусак - на 4 to Лаб 3 Гусак - БПИ2303 - на 4 2026-11-12 23:09:14 +03:00
Owner

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

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