7.0 KiB
Инфраструктура студента
Здесь размещены конфигурации сервисов; топология — в корневом 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 идёт по отдельному соединению (пул из одного клиента), а не из общего пула бизнес-запросов: занятый пул — это перегрузка, а не потеря зависимости. Весь ответ ограничен общим дедлайном APIHEALTH_TIMEOUT_MS=400(AbortSignal.timeoutдляPINGRedis) и укладывается в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позволяет стартовать без адресов, не падая на пустом ответе. Резолвинг ограничен:<500mshold 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 набор приложения).