7.6 KiB
Лабораторная 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 содержит инструкцию именно моего решения.