Files
mtusi2026lab3/REPORT.md
T
HellsTomatoandClaude 7e9a081dc8 Apply working version from updated folder
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>
2026-10-29 22:30:24 +03:00

17 KiB
Raw Blame History

Отчёт — лабораторная 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 — быстрое обнаружение недоступного backend
  • max_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

Скрипт выполняет:

  1. Baseline измерение (обе реплики работают)
  2. Остановка api-1, измерение производительности с одной репликой
  3. Восстановление api-1, измерение после восстановления
  4. Остановка api-2, измерение с другой репликой
  5. Восстановление 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

Скрипт выполняет:

  1. Запускает генератор нагрузки на 60 секунд
  2. Поочерёдно пересоздаёт api-1 и api-2 под нагрузкой
  3. Измеряет количество ошибок во время обновления

Процесс 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. Что сказать про код

Показать файл:

MessengerApplication.java

Изменения относительно lab2:

  • Строка 40: добавлена константа INSTANCE_ID — hostname контейнера (первые 12 символов его ID), стабилен для жизни процесса; по нему stop-one.sh находит реплику;
  • Строка 89: заголовок X-Instance-Id добавляется в каждый ответ;
  • Строка 322: метод message() теперь @Transactional и проверяет Idempotency-Key;
  • Строка 335: проверка существующего результата для ключа;
  • Строки 351-352: атомарная запись сообщения и ключа идемпотентности.

Показать конфигурацию Nginx:

nginx.conf

Коротко объяснить:

  • 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