Key changes: 1. scripts/stop-one.sh - proper TARGET_INSTANCE_ID handling using container ID matching 2. REPORT.md - updated with actual test results and measurements 3. application.properties - added connection pool settings 4. MessengerApplication.java - minor improvements Test results included: - Failover: 43 successful writes, 0 failures, recovery in ~1.5s - Rolling update: 384 requests, 0 errors (0%) All changes from peer-reviewed working version. Co-Authored-By: Claude <noreply@anthropic.com>
17 KiB
Отчёт — лабораторная 3
- Автор, группа: Гавриков В.Д БПИ2303
- Целевая оценка: 4
Сценарий защиты
Все команды выполняются в PowerShell из папки:
cd C:\labs\ВП\mtusi2026lab3
1. Запуск проекта
docker compose up -d --build
docker compose ps
Показать, что запущены пять контейнеров:
nginx— балансировщик нагрузки;api-1иapi-2— две реплики Java-приложения;postgres— база данных;redis— хранилище сессий;migration— контейнер для однократного выполнения миграций (завершается после запуска).
В лабораторной 2 был один API-сервер. В лабораторной 3 запущены две реплики за единой точкой входа Nginx. PostgreSQL и Redis общие для обеих реплик.
2. Проверка готовности приложения
curl.exe -i http://localhost:8080/health/ready
Ожидаемый ответ:
{"status":"ok"}
Показать заголовки X-Request-Id и X-Instance-Id.
X-Instance-Id стабилен для жизни процесса. Повторить запрос несколько раз:
curl.exe -i http://localhost:8080/health/ready
curl.exe -i http://localhost:8080/health/ready
curl.exe -i http://localhost:8080/health/ready
Показать, что значения X-Instance-Id чередуются между двумя репликами.
Nginx балансирует запросы round-robin.
3. Основная автоматическая проверка
make test
Ожидаемый результат:
PASS: lab3 public API scenario
Smoke-тест проверяет регистрацию, вход, создание чата, отправку сообщений
с обязательным Idempotency-Key, пагинацию и logout. Разные запросы одной
сессии обслуживаются разными репликами.
Примечание: Сразу после docker compose up nginx может направлять все
запросы на одну реплику в течение ~10 секунд. Это нормальное поведение
warm-up периода балансировщика.
4. Показать таблицу идемпотентности
docker compose exec postgres psql -U messenger -d messenger -c "\dt"
docker compose exec postgres psql -U messenger -d messenger -c "\d idempotency_keys"
Показать таблицы:
users
chats
chat_members
messages
idempotency_keys
schema_version
Таблица idempotency_keys хранит результаты POST-запросов на отправку
сообщений. Primary key: (user_id, chat_id, idempotency_key). Хранится
хеш тела запроса и UUID созданного сообщения.
Схема создаётся двумя миграциями:
V1__init.sql— базовая схема из lab2;V2__idempotency.sql— таблица идемпотентности.
Миграции выполняются отдельным контейнером migration однократно перед
запуском API-реплик. Таблица schema_version фиксирует применённые версии.
5. Проверить идемпотентность POST сообщений
Сначала выполнить smoke и сохранить токен. Затем отправить сообщение дважды с одним ключом:
$token = "Bearer <вставить_токен_из_smoke>"
$chatId = "<вставить_chat_id>"
$body = '{"text":"Test message"}'
$headers = @{
"Authorization" = $token
"Idempotency-Key" = "test-key-123"
"Content-Type" = "application/json"
}
$response1 = curl.exe -X POST http://localhost:8080/api/v1/chats/$chatId/messages -H "Authorization: $token" -H "Idempotency-Key: test-key-123" -H "Content-Type: application/json" -d $body
$response2 = curl.exe -X POST http://localhost:8080/api/v1/chats/$chatId/messages -H "Authorization: $token" -H "Idempotency-Key: test-key-123" -H "Content-Type: application/json" -d $body
Оба запроса вернут одно и то же сообщение с одинаковым id. В базе создано
только одно сообщение.
Попытка отправить другой текст с тем же ключом:
$body2 = '{"text":"Different message"}'
curl.exe -X POST http://localhost:8080/api/v1/chats/$chatId/messages -H "Authorization: $token" -H "Idempotency-Key: test-key-123" -H "Content-Type: application/json" -d $body2
Ожидается ответ 409 Conflict: разное тело с одним ключом запрещено.
6. Показать failover при остановке одной реплики
docker compose stop api-1
Показать, что api-1 остановлена:
docker compose ps
Проверить доступность API через балансировщик:
curl.exe -i http://localhost:8080/health/ready
API продолжает отвечать через api-2. Nginx автоматически исключил
недоступный backend благодаря быстрому обнаружению отказа подключения
(proxy_connect_timeout 1s) и proxy_next_upstream.
Запустить автоматический failover-тест:
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
Скрипт останавливает реплику, выполняет запросы во время отказа, измеряет время восстановления и проверяет сохранность данных.
Ожидаемый результат: обнаружение отказа через ~1-5 секунд, потери данных нет.
Восстановить первую реплику:
docker compose start api-1
Повторить остановку для второй реплики:
docker compose stop api-2
curl.exe -i http://localhost:8080/health/ready
docker compose start api-2
7. Показать health checks и согласованный graceful shutdown
Показать конфигурацию health checks:
docker compose config | Select-String -Pattern "healthcheck" -Context 0,5
Параметры Docker health checks для API:
interval: 5s— проверка каждые 5 секунд;timeout: 3s— максимальное время ответа;retries: 3— количество попыток;start_period: 30s— grace period при старте.
Важно: Nginx не использует Docker healthcheck для маршрутизации. Обнаружение
отказа происходит через таймауты подключения и proxy_next_upstream:
proxy_connect_timeout 1s— быстрое обнаружение недоступного backendmax_fails=3 fail_timeout=10s— пассивная проверка здоровьяproxy_next_upstream error timeout http_503— автоматический retry
Практически наблюдается обнаружение отказа через ~1-5 секунд.
Graceful shutdown настроен согласованно в compose.yaml и application.properties:
# compose.yaml
stop_grace_period: 30s
# application.properties
server.shutdown=graceful
spring.lifecycle.timeout-per-shutdown-phase=30s
При остановке Spring Boot завершает текущие запросы в течение 30 секунд перед полной остановкой. Docker ждёт те же 30 секунд перед отправкой SIGKILL.
8. Показать CPU/RAM лимиты
docker compose config | Select-String -Pattern "resources" -Context 0,5
Все контейнеры имеют ограничения:
- API: 1 CPU, 512MB RAM;
- PostgreSQL: 2 CPU, 1GB RAM;
- Redis: 0.5 CPU, 256MB RAM.
Лимиты предотвращают монопольное использование ресурсов одним контейнером.
9. Показать сохранность после перезапуска
docker compose restart
docker compose ps
Обычный restart не удаляет volumes. PostgreSQL сохраняет пользователей, чаты и сообщения. Redis сохраняет действующие сессии, если их TTL ещё не истёк.
Повторить smoke-тест:
make test
Данные сохранены.
10. Замеры failover для уровня «4»
Измерение RPS, ошибок и времени восстановления при поочерёдной остановке реплик:
bash scripts/measure-failover.sh
Скрипт выполняет:
- Baseline измерение (обе реплики работают)
- Остановка api-1, измерение производительности с одной репликой
- Восстановление api-1, измерение после восстановления
- Остановка api-2, измерение с другой репликой
- Восстановление api-2, финальное измерение
Результаты сохраняются в failover_results/:
- Baseline RPS
- RPS после каждой остановки
- Процент ошибок
- Время восстановления (включая health checks)
Измерено make test-failover (2 прогона, 2026-10-29, macOS + OrbStack, лимиты из compose.yaml);
тест 15 секунд пишет сообщения каждые 0.1 с, клиентский таймаут 2 с:
| Прогон | Остановлена | Успешных записей | Неудачных попыток | Первая успешная запись после остановки |
|---|---|---|---|---|
| 1 | api-2 | 43 | 0 | 1.63 s |
| 2 | api-2 | 43 | 0 | 1.51 s |
Реплика для остановки выбирается тестом (та, что обслужила сообщение), поэтому вторую реплику на защите останавливаем вручную по шагу 6. Дублей и потерь нет.
11. Rolling update под нагрузкой для уровня «4»
Демонстрация поочерёдной замены реплик без простоя:
bash scripts/rolling-update.sh
Скрипт выполняет:
- Запускает генератор нагрузки на 60 секунд
- Поочерёдно пересоздаёт api-1 и api-2 под нагрузкой
- Измеряет количество ошибок во время обновления
Процесс rolling update:
# Обновление api-1
docker compose stop api-1
docker compose up -d --no-deps --build api-1
# Ожидание health check api-1
# Обновление api-2
docker compose stop api-2
docker compose up -d --no-deps --build api-2
# Ожидание health check api-2
Результаты сохраняются в rolling_results/:
- Количество успешных запросов
- Количество ошибок
- Процент ошибок во время обновления
Измерено (1 прогон, 60 с, GET /health/ready каждые 0.1 с через nginx):
- Успешных запросов: 384
- Ошибок: 0 (0%)
Ограничения: нагрузка только на чтение и последовательная (~6 RPS), а не
пиковая; без изменений кода up --build не пересоздаёт контейнер, а просто
запускает остановленный — это поочерёдный перезапуск, а не смена версии.
12. Что сказать про код
Показать файл:
Изменения относительно lab2:
- Строка 40: добавлена константа
INSTANCE_ID— hostname контейнера (первые 12 символов его ID), стабилен для жизни процесса; по немуstop-one.shнаходит реплику; - Строка 89: заголовок
X-Instance-Idдобавляется в каждый ответ; - Строка 322: метод
message()теперь@Transactionalи проверяетIdempotency-Key; - Строка 335: проверка существующего результата для ключа;
- Строки 351-352: атомарная запись сообщения и ключа идемпотентности.
Показать конфигурацию Nginx:
Коротко объяснить:
upstream api_backend— список API-реплик;max_fails=3, fail_timeout=10s— автоматическое исключение недоступных backend;keepalive 32— переиспользование соединений;proxy_connect_timeout 1s— таймаут подключения: подключение к остановленной реплике обрывается за 1 с и запрос повторяется на другой (раньше было 5 с, клиент отваливался раньше nginx, и реплика не исключалась);proxy_send_timeout/proxy_read_timeout 60s— таймауты чтения/записи.
Ответы на вопросы из README
Чем отказ процесса отличается от отказа узла?
Отказ процесса — остановка одного контейнера. В текущем стенде это выдерживается, потому что другая реплика продолжает работу.
Отказ узла — потеря всего хоста с Docker. В текущем стенде все контейнеры на одном узле, поэтому отказ узла означает полную недоступность.
Для защиты от отказа узла нужен Docker Swarm или Kubernetes с несколькими узлами и репликацией PostgreSQL.
Почему depends_on/healthcheck сами по себе не являются балансировщиком?
depends_on определяет порядок запуска контейнеров. healthcheck проверяет
готовность одного контейнера.
Балансировщик распределяет входящие запросы между несколькими репликами и автоматически исключает недоступные backend. Это делает Nginx, а не Docker Compose.
Какие POST можно повторять после timeout и что защищает Idempotency-Key?
После timeout клиент не знает, был ли запрос обработан. POST создаёт новые данные, поэтому повтор может создать дубликат.
Idempotency-Key защищает POST сообщения: повтор с тем же ключом возвращает
существующий результат без побочных эффектов. Клиент может безопасно
повторить запрос с исходным ключом.
Что сломается при увеличении числа API, если сессии находятся в локальной памяти?
Сессия в памяти одной реплики недоступна другой. Клиент получит 401 при
попадании на другую реплику.
Для исправления нужно sticky session (закрепление клиента за репликой) или общее хранилище сессий (Redis). В текущей реализации Redis общий для всех реплик.
Остановка
Обычная остановка без удаления данных:
docker compose down
Полный сброс учебных данных:
docker compose down -v