Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
12 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. Основная автоматическая проверка
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. Что сказать про код
Показать файл:
Изменения относительно lab2:
- Строка 38: добавлена константа
INSTANCE_ID— стабильный UUID для жизни процесса; - Строка 76: заголовок
X-Instance-Idдобавляется в каждый ответ; - Строка 318: метод
message()теперь@Transactionalи проверяетIdempotency-Key; - Строка 323: проверка существующего результата для ключа;
- Строка 336: атомарная запись сообщения и ключа идемпотентности.
Показать конфигурацию Nginx:
Коротко объяснить:
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