- 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.
Инфраструктура студента
Здесь размещены конфигурации сервисов; топология — в корневом 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позволяет стартовать без адресов, не падая на пустом ответе. Резолвинг ограничен:<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 набор приложения).