Files

7.0 KiB
Raw Permalink Blame History

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

Здесь размещены конфигурации сервисов; топология — в корневом 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 /health/ready, та же ручка, что у healthcheck контейнера: реплика, потерявшая обязательную зависимость (свой путь к общей БД или Redis), исключается из ротации, а трафик уходит на здоровые. Проверка PostgreSQL идёт по отдельному соединению (пул из одного клиента), а не из общего пула бизнес-запросов: занятый пул — это перегрузка, а не потеря зависимости. Весь ответ ограничен общим дедлайном API HEALTH_TIMEOUT_MS=400 (AbortSignal.timeout для PING Redis) и укладывается в timeout check 500ms. Когда недоступна общая для всех зависимость, неготовыми становятся все реплики, и клиент получает 503 от самого балансировщика — честный признак отсутствия готовых узлов; /health/live при этом остаётся 200.
  • Период проверки 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 набор приложения).