Files
mtusi2026lab3/infra
ilya.tyunin 2950b77967 lab3: evidence, отчёт и документация (C5)
- REPORT.md: запуск из чистого clone, архитектура и решения, таблица доказательств
  по каждому заявленному критерию, методика экспериментов, гипотезы H1–H5,
  результаты серии A (1/2/4 реплики), диагностики горячего чата и пути чтения,
  серии роста ресурсов, A/B улучшения и таблица отказов, ограничения и следующие шаги.
- evidence/: индекс (README.md), level3 (smoke, persistence, failover по каждой
  реплике с переходами статусов LB) и level4 (spread, идемпотентность, failover
  каждой реплики под нагрузкой, rolling update, отказы зависимостей, лимиты и
  порты) плюс raw-данные трека 1: сводки k6, сжатые потоки сэмплера, манифесты
  условий измерения, таблицы и графики.
- app/README.md и infra/README.md: LB и реплики, семантика Idempotency-Key,
  /internal/lb-check, переменные окружения, дрейн по SIGTERM, харнесс.
- .env.example приведён к реальной конфигурации (убраны SESSION_STORE/CACHE_URL_FILE,
  добавлены DATABASE_URL/REDIS_URL/лимиты стенда/BUILD_ID и т.д.);
  .lab3-quiesce.json добавлен в .gitignore.
2026-10-15 23:14:20 +03:00
..

Инфраструктура студента

Здесь размещены конфигурации сервисов; топология — в корневом compose.yaml. compose.example.yaml — только worksheet ролей и намеренно не запускается. contracts/infrastructure.json задаёт минимальные роли, не готовые образы/пароли.

Роли

Роль Service Образ Проверка готовности Volume Порт Credentials
Балансировщик haproxy haproxy:3.2-alpine TCP-порт 8080 + собственная проверка backend — 8080 публично, 127.0.0.1:8404 статистика —
API ×N api ${API_IMAGE} (сборка из Dockerfile) GET /health/ready (Compose healthcheck) — портов нет env_file: [.env]
Миграции migrate тот же образ service_completed_successfully — — env_file: [.env]
PostgreSQL postgres postgres:16.4-alpine pg_isready postgres-data 127.0.0.1:5432 (операторские проверки) POSTGRES_* из .env
Redis redis redis:7.4.2-alpine redis-cli ping redis-data 127.0.0.1:6379 (операторские проверки) без пароля, только внутренняя сеть
Генератор нагрузки loadgen grafana/k6:0.54.0 — ./scripts/load (ro) — profile: load

Секреты не попадают в образы: .env читается только env_file и исключён из build-контекста (.dockerignore). Пароль БД и токен метрик в отслеживаемых файлах не встречаются (evidence/level4/limits-and-ports.txt).

HAProxy (haproxy.cfg)

  • Проба backend — GET /internal/lb-check, а не /health/ready. Недоступность общей БД или Redis нельзя вылечить выводом реплик из ротации, а вывод всех реплик подменил бы ограниченный ответ API (503 unavailable с X-Request-Id) HTML-страницей ошибки балансировщика. /health/ready остаётся операторским сигналом и используется healthcheck'ом контейнера.
  • Период проверки 500 ms, fall 2, rise 2 → максимальное время обнаружения отказа ≈ 1 s. Окно дреина API (DRAIN_DELAY_MS=3000) длиннее обнаружения, поэтому узел успевает выйти из ротации до того, как перестанет принимать запросы; клиент не видит ошибок переключения (evidence/level4/failover-sweep.md).
  • Список backend не перечислен статически: server-template api 1-8 api:8080 resolvers docker init-addr none берёт адреса из DNS Docker (127.0.0.11) и обновляет их при масштабировании. init-addr none позволяет стартовать без адресов, не падая на пустом ответе. Резолвинг ограничен: <500ms hold valid. Атрибуция «слот ↔ реплика» в отчётах берётся из колонки addr статистики.
  • Таймауты: connect 500 ms, client 35 s, server 30 s, queue 2 s; retries 3 с retry-on conn-failure и option redispatch: при отказе соединения запрос повторяется на другой реплике (для POST это безопасно только потому, что отправка сообщения идемпотентна по Idempotency-Key).
  • Статистика (listen stats) публикуется только на loopback: это интерфейс балансировщика, а не API.

PostgreSQL (compose.yaml)

command поднимает сервер с shared_preload_libraries=pg_stat_statements (нужно для трека 1: агрегаты по SQL), max_connections=120 (запас на N × DATABASE_POOL_MAX плюс операторские подключения), shared_buffers=128MB, effective_cache_size=384MB — согласовано с лимитом контейнера 512 MiB. Миграции выполняет отдельный сервис migrate; реплики стартуют только после его успешного завершения (service_completed_successfully), поэтому гонки миграций между репликами нет.

Redis (compose.yaml)

--appendonly yes --appendfsync everysec — сессии и кэш переживают рестарт контейнера (проверка сохранности с неизменным токеном); --maxmemory 96mb --maxmemory-policy volatile-lru ограничивает память: вытесняются только ключи с TTL. Учебное упрощение: и сессии, и кэш страниц имеют TTL, поэтому при исчерпании памяти возможна потеря наименее используемой сессии; в стенде объём ключей на порядки меньше лимита (evidence/track1/summary-runs.md).

Bootstrap

cp .env.example .env          # заполните POSTGRES_PASSWORD, METRICS_TOKEN и DATABASE_URL
make stand-up                 # build + up -d --wait: migrate -> api x API_REPLICAS -> haproxy
make wait-ready               # ожидание GET /health/ready
make test                     # публичный smoke lab3

Скрипты оператора: scripts/restart.sh (перезапуск стенда с сохранением томов), scripts/stop-one.sh (остановка ровно одной реплики по X-Instance-Id), scripts/start-replica.sh (восстановление реплики), scripts/quiesce.sh (остановка/возврат посторонних контейнеров хоста на время серии), scripts/app-e2e.sh (host-side black-box набор приложения).