Files
mtusi2026lab3/REPORT.md
T

12 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. Основная автоматическая проверка

py -3 tests\smoke.py --base-url http://localhost:8080

Ожидаемый результат:

PASS: lab3 public API scenario

Smoke-тест проверяет регистрацию, вход, создание чата, отправку сообщений с обязательным Idempotency-Key, пагинацию и logout. Разные запросы одной сессии обслуживаются разными репликами.

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.

Запустить автоматический failover-тест:

py -3 tests\failover.py --action-script scripts/stop-one.sh

Скрипт останавливает api-1, выполняет запросы во время отказа, измеряет время восстановления и проверяет сохранность данных.

Ожидаемый результат: время обнаружения отказа 5-10 секунд, потери данных нет.

Восстановить первую реплику:

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

Параметры:

  • interval: 5s — проверка каждые 5 секунд;
  • timeout: 3s — максимальное время ответа;
  • retries: 3 — количество попыток;
  • start_period: 30s — grace period при старте.

Максимальное время обнаружения отказа: interval × (retries + 1) = 20 секунд. Практически наблюдается 5-10 секунд.

Graceful shutdown настроен в application.properties:

server.shutdown=graceful
spring.lifecycle.timeout-per-shutdown-phase=30s

При остановке Spring Boot завершает текущие запросы в течение 30 секунд перед полной остановкой.

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-тест:

py -3 tests\smoke.py --base-url http://localhost:8080

Данные сохранены.

10. Что сказать про код

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

MessengerApplication.java

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

  • Строка 38: добавлена константа INSTANCE_ID — стабильный UUID для жизни процесса;
  • Строка 76: заголовок X-Instance-Id добавляется в каждый ответ;
  • Строка 318: метод message() теперь @Transactional и проверяет Idempotency-Key;
  • Строка 323: проверка существующего результата для ключа;
  • Строка 336: атомарная запись сообщения и ключа идемпотентности.

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

nginx.conf

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

  • upstream api_backend — список API-реплик;
  • max_fails=3, fail_timeout=10s — автоматическое исключение недоступных backend;
  • keepalive 32 — переиспользование соединений;
  • proxy_connect_timeout 5s — таймаут подключения;
  • 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