Files
mtusi2026lab3/.github/pull_request_template.md
T

7.6 KiB
Raw Blame History

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

Автор / группа: Антипин Егор Иванович, БПИ2301

Целевая оценка (3/4/5): 5

Трек 5, если заявлен: трек 2 — «Отказ узла»

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

  • Из лабораторной №2 перенесены Spring Boot API, PostgreSQL-схема пользователей, сессий, чатов и сообщений, Bearer-аутентификация, Redis cache-aside и Flyway-миграции.
  • Основной стенд описан в compose.yaml: Nginx является единственной публичной точкой входа, за ним работают две stateless API-реплики с общей PostgreSQL и общим Redis.
  • Сессии и все данные, влияющие на корректность, хранятся в PostgreSQL; sticky session не используется. Реплики наблюдаются по X-Instance-Id.
  • Миграции вынесены в отдельный one-shot service migrate; в API-репликах Flyway отключён.
  • Настроены least_conn, динамическое обновление Docker DNS, readiness guard, таймауты, graceful shutdown и пассивное исключение backend по 503.
  • Реализована общая идемпотентность отправки сообщения через message_idempotency, SHA-256 тела и транзакционную PostgreSQL advisory-блокировку.
  • Добавлены action scripts остановки/восстановления выбранной API-реплики, последовательный failover обеих реплик и rolling replacement под нагрузкой.
  • Для трека 5 добавлен отдельный трёхузловой Swarm-стенд: один manager, два workers, локальный registry, перенос API task при жёсткой потере worker и проверка сохранности подтверждённых сообщений.
  • Дополнительные проверки находятся в student_tests; исходные публичные тесты остаются в tests, Spring-тесты — в src/test/java.

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

cp .env.example .env
# задать локальный DATABASE_PASSWORD в .env
docker compose --env-file .env config --quiet
docker compose --env-file .env build api
docker compose --env-file .env up -d postgres redis
docker compose --env-file .env run --rm migrate
docker compose --env-file .env up -d --scale api=2 api nginx
curl --fail http://localhost:8080/health/ready

Проверки основного стенда:

make check
make test
make test-idempotency
make test-readiness-gate
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover-each ACTION_SCRIPT=scripts/stop-one.sh RESTORE_SCRIPT=scripts/restore-api.sh
chmod +x scripts/rolling-update.sh
make test-rolling ACTION_SCRIPT=scripts/rolling-update.sh

Трёхузловой Swarm-эксперимент на Windows:

make swarm-up
make test-node-failover PYTHON=python
make swarm-down

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

  • make check — PASS; основной make test через Nginx — PASS: lab3 public API scenario.
  • Конкурентная идемпотентность — 32 одновременных запроса через две реплики создали одно сообщение.
  • Readiness gate — после временного переименования V3-таблицы обе API стали unhealthy, readiness и /users/me через LB вернули JSON 503; после восстановления вернулись healthy/200.
  • Последовательная остановка обеих Compose-реплик — 0 ошибок, 10,839/10,014 successful RPS, первая успешная операция через 1,306/2,672 s.
  • Rolling replacement — четыре instance ID, 12 147 успешных записей, 177 ошибок, 67,439 successful RPS, error ratio 1,4362%.
  • Потеря Swarm worker — API task перенесена с worker2 на worker1; 165 чтений, 166 записей, 0 ошибок, первая успешная операция через 1,796 s; подтверждённые данные сохранены.
  • Полные команды, методика, raw JSON и объяснение архитектуры приведены в REPORT.md и каталоге evidence/.

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

  • PostgreSQL не реплицирован и остаётся SPOF; отказ его узла не проверялся и не заявляется (database_node_failed=false).
  • Nginx, единственный Swarm manager, Redis, локальные volumes, underlay и физический Docker host также остаются SPOF.
  • Nginx OSS использует пассивное исключение, поэтому API readiness guard возвращает 503 на бизнес-запрос неготовой реплики; Nginx повторяет его на другом peer, а при отсутствии готовых API возвращается 503.
  • Во время rolling replacement зафиксировано 1,4362% кратковременных ошибок; они намеренно не скрыты клиентским retry.
  • Swarm-опыт выполнен на DinD-узлах одного Windows/Docker Desktop host и не моделирует потерю разных физических серверов.

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

  • Использованы исходный skeleton лабораторной, её OpenAPI-контракт и стандартные open-source зависимости проекта: Spring Boot, PostgreSQL, Redis, Flyway, Nginx, Docker Compose и Docker Swarm.

  • ИИ применялся для обсуждения архитектуры Compose/Nginx, readiness и graceful shutdown, проектирования общей идемпотентности, подготовки дополнительных тестов и Swarm-сценария, анализа измерений и оформления документации.

  • Прикладной код готового стороннего сервера не заимствовался. Утверждения о поведении проверены запускаемыми сценариями и сохранёнными raw-результатами в evidence/.

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

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

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

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

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

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