Files
mtusi2026lab3/REPORT.md
T
2026-11-12 21:23:41 +03:00

7.3 KiB
Raw Blame History

Отчёт — лабораторная 3

  • Автор, группа: Гусак Дмитрий, БПИ2303
  • Целевая оценка: 4; трек 5 не заявлен
  • Commit/PR: заполню после публикации форка
  • Использованные источники: документация Docker Compose, HAProxy и Spring Boot; помощь ИИ использовалась для разбора задания, проектирования и проверки реализации.

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

Требуется Docker Desktop с Compose и Java/Python только для локальных проверок. Из чистого clone:

cp .env.example .env
openssl rand -base64 32 | tr '+/' '-_' | tr -d '='
# вставить полученную строку в CURSOR_SECRET в .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --scale api=2
curl -i http://localhost:${APP_PORT:-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

Для локального стенда в моём .env выбран APP_PORT=8082, поэтому проверки выполнялись с BASE_URL=http://localhost:8082. Секрет в отчёт не помещается. Обычная остановка: docker compose --env-file .env down; удаление учебных данных вместе с volumes: docker compose --env-file .env down -v.

Архитектура и решения

Клиент обращается к HAProxy, который балансирует запросы между api-1 и api-2. API-реплики не публикуют порты наружу. Обе используют общий PostgreSQL для пользователей, чатов, сообщений и таблицы message_idempotency, а Redis — для общих сессий. PostgreSQL является источником истины для бизнес-данных; запись сообщения и её ключ идемпотентности создаются транзакционно. Flyway запускается отдельным сервисом migrate до запуска API.

Из lab2 перенесены REST API, PostgreSQL, Redis, миграции, Basic-аутентификация и таймауты SQL. Для lab3 добавлены HAProxy, масштабирование, X-Instance-Id, обязательный Idempotency-Key, миграция V2 и общий CURSOR_SECRET. В Compose заданы CPU/RAM-лимиты, healthcheck и graceful shutdown. В .env.example перечислены все параметры, используемые Compose.

Доказательства критериев

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke make test BASE_URL=http://localhost:8082 PASS: API-сценарий lab3 вывод команды
Структура и контракт make check PASS вывод команды
Сохранность make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://localhost:8082 PASS: данные и сессия сохранены вывод команды
Failover make test-failover ACTION_SCRIPT=scripts/stop-one.sh BASE_URL=http://localhost:8082 PASS: 2 реплики до отказа, записи продолжились, восстановление около 2.45 с вывод команды
Уровень 4 make test-grade4 BASE_URL=http://localhost:8082 PASS: 2 реплики, общая идемпотентность и 409 для конфликта вывод команды
Rolling update make test-rolling BASE_URL=http://localhost:8082 PASS: поочерёдная замена под нагрузкой evidence/rolling-load.json

TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.

Эксперименты и отказы

Для failover тест создаёт пользователей/чат, запускает запись и чтение во время остановки одной реплики. Два последовательных прогона после восстановления проверили обе реплики: наблюдались 2 экземпляра до отказа, 95–107 успешных записей, по 1 кратковременной ошибке на момент обнаружения отказа, первое восстановление заняло 2.369–2.476 с. Балансировка проверена повторными запросами: через LB наблюдались оба разных X-Instance-Id.

Rolling-сценарий запускает локальную нагрузку с 4 параллельными клиентами в течение 20 секунд и поочерёдно перезапускает API. Сырые метрики сохранены в evidence/rolling-load.json; это локальная проверка корректности, а не capacity benchmark.

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
Остановка каждой API-реплики по очереди LB должен исключить остановленную реплику и продолжить обслуживание Оба последовательных прогона прошли; по 1 краткой ошибке при обнаружении 2.369–2.476 с до первого восстановления, данные не потеряны
Перезапуск всего Compose Сессии и бизнес-данные сохраняются PASS подтверждено test-persistence
Rolling restart Запросы продолжаются во время замены PASS evidence/rolling-load.json

Ограничения и следующие шаги

Стенд выдерживает отказ одной API-реплики, перезапуск API и rolling replacement; общие Redis/PostgreSQL сохраняют сессии и данные. HAProxy и база остаются одиночными компонентами на одном Docker-хосте, TLS и отказоустойчивость самого хоста не заявляются. Идемпотентность хранится дольше минимальных 24 часов (автоматическая очистка не нужна для данного учебного сценария). Трек 5 не выполнялся.