7.3 KiB
Отчёт — лабораторная 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 не выполнялся.