5.5 KiB
Лабораторная 3
Автор / группа: Илья Тюнин; группа — БВТ2303 Целевая оценка (3/4/5): 5 Трек: 1 «Цена масштабирования»
Что реализовано и что перенесено: Стенд целиком в compose.yaml: HAProxy 3.2 (server-template + Docker DNS, проба /internal/lb-check, roundrobin), API × N без публикации портов, общие PostgreSQL 16.4 и Redis 7.4 (сессии + AOF), миграции отдельным сервисом migrate, лимиты CPU/RAM у всех сервисов, container_name не задан нигде. Из lab2 перенесены без изменений: регистрация с Argon2id, Basic→Bearer-сессии в общем Redis, чаты с атомарным созданием, keyset-пагинация (created_at, id), версионированный кэш истории, /health/live, /health/ready, /internal/metrics, X-Request-Id. Добавлено в lab3: X-Instance-Id = hostname реплики (в успешных ответах и в ошибках), проба LB, не зависящая от БД/Redis, общая идемпотентность POST /chats/{id}/messages (обязательный Idempotency-Key, сквозь реплики, атомарная заявка и тело ответа одним оператором, TTL и фоновый GC), дрейн по SIGTERM до закрытия пулов, транзиентные коды PostgreSQL → 503 unavailable. Инструменты: scripts/lab3/lab3.py (стенд, прогоны, отказы, rolling update, анализ, графики), профили k6 в scripts/load/, хуки scripts/stop-one.sh, scripts/start-replica.sh, scripts/restart.sh, scripts/quiesce.sh. Трек 1: серия A (1/2/4 реплики при фиксированном бюджете), VU-своп, серия роста ресурсов на 900 req/s с проверкой фактических квот через docker inspect, блок «почему» на 1500 req/s, A/B до/после оптимизации пути записи и контрольная серия на бюджете по умолчанию; доказательства, сводки и графики — в evidence/track1/.
Команды запуска из чистого clone:
git clone -b lab3 <origin> lab3 && cd lab3
cp .env.example .env # свои POSTGRES_PASSWORD, DATABASE_URL, METRICS_TOKEN
make stand-up # docker compose up -d --build --wait
make wait-ready && make test && make test-e2e
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh && scripts/start-replica.sh
make test-dependencies
# трек 1 (полный список команд — REPORT.md, раздел «Воспроизводимость прогонов трека»):
python3 scripts/lab3/lab3.py track1 --reps 2
python3 scripts/lab3/lab3.py track1-extras --part all --reps 2 --rate 1500 --max-vus 900 --loadgen-memory 1024m --ab-reps 3
python3 scripts/lab3/lab3.py analyze
Результаты проверок и ссылка на REPORT.md: make check — PASS, make test — PASS через LB, make test-e2e — 14 passed / 3 skipped, test-persistence и test-failover — PASS, test-dependencies — PASS; доказательства уровня 3/4 — evidence/level3/, evidence/level4/, трека 1 — evidence/track1/ (raw + сводки + графики). Полные таблицы, гипотезы, статус гипотез и ограничения — в REPORT.md.
Ограничения / известные ошибки: один docker-хост; PostgreSQL, Redis и HAProxy не реплицированы (трек 2 не заявлен), бэкапа тома PostgreSQL нет; путь чтения измерялся с MAX_VUS=200, поэтому его потолок — нижняя оценка; абсолютные значения трека сравнимы только внутри серии/блока (разные сборки и растущий датасет); серии трека, где меняются лимиты (рост ресурсов, VU-своп, блок 1500), сняты по одному прогону на точку с проверкой квот через docker inspect.
Источники: контракт contracts/openapi.json и contracts/README.md, публичные проверки tests/, документация HAProxy 3.2, Docker Compose, k6 0.54, NestJS/Fastify, pg и redis. Все числа в отчёте получены прогонами на описанном стенде и лежат в evidence/.
- Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- Контракт и публичные тесты не ослаблены.
- make check и make test выполнены; приложен реальный вывод.
- Сценарии отказов/безопасности своего уровня воспроизведены.
- Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- README задания сохранён, REPORT.md содержит инструкцию именно моего решения.