11 KiB
Отчёт — лабораторная 3
- Автор, группа: Ромашко Владимир, БВТ2301
- Целевая оценка; выбранный трек: 5, трек 1 "Цена масштабирования"
- Commit/PR: уровень 4 —
1d85938, трек 1 —3417e22; исправление readiness — после публикации - Источники: контракт задания, документация Docker Compose / nginx / PostgreSQL. Библиотеки —
requirements.txt; графики — matplotlib. Использован Codex
Запуск из чистого clone
Нужны Docker Desktop/Engine с Compose v2 (проверено: Engine 28.5.1, Compose 2.40.0) и Python 3.10+ на хосте. В контейнерах: Python 3.12.8, PostgreSQL 17.4, Redis 7.4.2, nginx 1.28.0.
Copy-Item .env.example .env
# Задать POSTGRES_PASSWORD в .env (не коммитить)
docker compose config --quiet
docker compose up -d --build --wait --wait-timeout 120
python -X utf8 scripts/verify_lab3.py
python -X utf8 scripts/verify_readiness.py
docker compose exec -T api python -m unittest discover -s student-tests -v
Миграции — отдельный сервис до API; --wait ждёт готовности. Адрес: http://localhost:8080. Во время verify_lab3.py не трогать контейнеры вручную. На Linux: cp, python3, chmod +x scripts/restart.sh scripts/stop-one.sh.
Остановка: docker compose down. Удаление учебных данных: docker compose down -v.
Повтор исследования (отдельный проект/БД track1, перезапись evidence/track1/):
docker build -t mtusi2026lab3-api:track1-baseline .
python scripts/scaling_suite.py saturation
python scripts/scaling_suite.py scaling
python scripts/scaling_suite.py improvement
python -m pip install matplotlib==3.10.7
python scripts/plot_scaling.py
docker compose -p mtusi2026lab3-track1 -f compose.yaml -f infra/scaling.compose.yaml down
Для удаления данных исследования добавить -v к последней команде.
Архитектура и решения
Клиент → nginx → 2 API → общие PostgreSQL и Redis. Из lab2: auth, сообщения, миграции, Redis-сессии и кэш. В lab3: балансировка без sticky, X-Instance-Id, идемпотентность, healthchecks, сценарии отказов. В треке 1 код приложения не менялся.
PostgreSQL — источник истины. Сообщение, версия истории и ключ идемпотентности — одна транзакция с блокировкой строки чата. Повтор ключа → то же сообщение; другое тело → 409. Сессии/кэш общие; Redis — AOF. Миграция 003; смешанное обновление lab2→lab3 не поддерживается.
Healthcheck API: 2 с / timeout 2 с / 2 неудачи / start 5 с. Скрипт infra/readiness.sh при nginx получает все IPv4-адреса API и проверяет /health/ready (timeout 1 с на реплику, пауза между циклами 2 с). В upstream включаются только готовые API; при изменении списка выполняется reload. Для двух API обнаружение занимает до ~5 с с учётом DNS и проверок; текущие запросы завершаются при graceful reload. Когда готовых API нет, nginx возвращает 502. Docker-статус сам по себе маршрутизацией не управляет. Nginx: connect 1 с, read 6 с; пассивное исключение остаётся дополнительной защитой. SIGTERM: до 5 с, Compose ждёт 10 с. Таймауты БД: connect/pool/lock 2 с, statement 3 с; Redis 1 с.
Лимиты: API 1 CPU/512 MiB каждая, PostgreSQL 1/512, nginx 0,5/128, Redis 0,5/256. Наружу только nginx; container_name нет. В .env — БД, TTL, лимиты запросов; APP_PORT — порт nginx. Хосты PostgreSQL/Redis задаёт Compose.
Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|---|---|---|---|
| Стенд ≥2 API, общий PostgreSQL/Redis, один вход | docker compose up ... --wait |
2 healthy API, наружу только nginx | containers, compose.yaml |
| Общая сессия, разные X-Instance-Id | smoke через nginx | один пользователь на двух API | smoke |
| Идемпотентность через разные API | конкурентные повторы в verify_lab3.py |
24 запроса / 8 одновременно → 1 сообщение; конфликт тела → 409 | idempotency |
| Контракт, smoke, persistence | verify_lab3.py: check, smoke, restart |
PASS; перезапущены API, nginx, PostgreSQL, Redis | check, persistence, restart, idempotency-restart |
| Отказ любой API, восстановление ≤10 с | поочерёдный stop | обе проверки PASS, 117/118 записей без ошибок | failover-1, failover-2 |
| Health/DNS/timeouts/SIGTERM | stop и замена под нагрузкой | недоступные API исключены | nginx, failover-1, failover-2 |
| Живая, но неготовая API | python -X utf8 scripts/verify_readiness.py |
При неверном REDIS_URL: live=200, ready=503; 24 регистрации идут здоровой API. После восстановления используются обе; без готовых API — 502 | readiness |
| Лимиты CPU/RAM, порты | inspect после запуска | лимиты есть, API без портов наружу | containers |
| Rolling update, отдельные миграции | verify_lab3.py rolling; unittest |
обе API заменены без потерь; 15 тестов OK | rolling, unit-tests |
| Трек 1: scaling / saturation / improvement | scaling_suite.py ×3 |
30 прогонов; см. ниже | summary.csv, track1/ |
Эксперименты и отказы
Проверка отказов после исправления: 24.10.2026. Docker Desktop Linux x86_64, VM 8 CPU / 7,76 GiB RAM. Отказы: 2 клиента, POST+GET+пауза 20 мс, прогрев 3 с, нагрузка ≥20 с, 1 прогон на воздействие.
| Воздействие | Успешных HTTP/с | Ошибки | p50 / p95 / p99, мс | Восстановление / потеря данных |
|---|---|---|---|---|
Stop API ac72a6939d0d |
53,79 | 0 | 22,01 / 64,40 / 78,39 | чтение 2,393 с, запись 2,369 с; потерь нет |
Stop API 2891905bd75d |
53,76 | 0 | 22,09 / 60,96 / 72,63 | чтение 2,505 с, запись 2,522 с; потерь нет |
| Поочерёдная замена API | 50,63 | 0 | 23,70 / 66,04 / 84,77 | запросов не теряли; потерь данных нет |
Время восстановления включает Docker CLI. Замена: 29,611 с; макс. пауза между успешными R/W: 0,195 / 0,182 с. Сырые сводки: grade4-summary.json.
Трек 1. Измерения ниже относятся к коммиту 3417e22 до исправления readiness; код приложения не изменён. Гипотеза: доп. API помогают до насыщения общей БД; при фиксированном бюджете дробление CPU может ухудшить результат. Профиль: 1 пользователь/чат, 100 стартовых сообщений, POST 64 символа + уникальный ключ. Сравнение: 8 клиентов без пауз, прогрев 3 с + 15 с, 3 повтора с чередованием порядка; БД очищается перед прогоном.
Фиксированный бюджет API: 2 CPU / 1024 MiB на 1/2/4 реплики. Растущий: по 1 CPU / 512 MiB на реплику. Остальные сервисы — как в стенде. Генератор отдельно: 2 CPU / 512 MiB. В 18 прогонах сравнения ошибок и потерь нет.
| Серия | Медиана сообщ./с (1 / 2 / 4 API) | Медиана p95, мс (1 / 2 / 4 API) |
|---|---|---|
| Фиксированный бюджет | 65,62 / 83,97 / 75,25 | 228,1 / 218,5 / 304,7 |
| Растущий бюджет | 54,61 / 93,18 / 112,69 | 295,0 / 208,0 / 206,6 |
scaling.png. Полные p50/p95/p99, ошибки, CPU/RAM, ожидания БД: summary.csv; рядом JSON метрик и *-resources.json.
Насыщение: 4 API, 1/4/8/16/32/64 клиентов. Предел ~120 сообщ./с при 4–8 клиентах; при 64 — 90 сообщ./с и 43 ошибки. При 8 клиентах 88,3% активных соединений ждут lock; API ~2,34/4 CPU, БД 0,44/1, nginx 0,10/0,5. Узкое место — блокировка строки чата: db-timeouts.txt, saturation.png.
Улучшение: 2×(1 CPU/512 MiB) вместо 4×(0,5 CPU/256 MiB) при том же бюджете. 3 парных прогона по 45 с (+3 с прогрева): медиана p95 441,7 → 290,3 мс (−34,3%), RPS 48,18 → 69,46 (+44,2%), без ошибок. improvement.png. В основном Compose уже 2 API; код не менялся.
Ограничения и следующие шаги
Выдерживается отказ одной API. nginx, PostgreSQL, Redis и узел — SPOF. Ключи идемпотентности не чистятся. Исследование короткое, один активный чат, общая Docker VM. Подтверждён выигрыш распределения ресурсов в этом профиле. Много независимых чатов — не проверено.