Files
mtusi2026lab3/infra
2026-11-04 16:11:13 +03:00
..
2026-11-04 16:11:13 +03:00
2026-11-04 16:11:13 +03:00

Выбранная инфраструктура: Compose + Nginx

Корневая топология находится в compose.yaml; конфигурация балансировщика — в nginx.conf. compose.example.yaml и contracts/infrastructure.json остаются учебными материалами, а не deployment.

Роль Compose service Образ/сборка Состояние и readiness
API api (2 replicas by default; scale to 1/2/4) Собирается из Dockerfile /health/ready, каждые 3 s, 15 s stop grace
Load balancer nginx nginx:1.27.5-alpine /health/ready; DNS refresh 5 s; passive fail exclusion
Database postgres postgres:16.8-alpine pg_isready; named volume postgres_data
Session store redis redis:7.4.2-alpine PING; AOF everysec; named volume redis_data
Migration runner migrate Собирается из Dockerfile Однократный Compose job до запуска API replicas

PostgreSQL, Redis и API находятся в изолированной internal network. Только Nginx публикует порт ${APP_PORT:-8080} на host. Не задавайте container_name: Compose масштабирует api как один service. Nginx OSS применяет passive checks: одна ошибка соединения/таймаут либо 502/503/504 исключает backend на 2 s; backend DNS перечитывается через Docker DNS каждые 5 s. Healthchecks API проверяют синхронные зависимости.

Запуск с нуля и измерения описаны в корневом REPORT.md. Локальные пароль PostgreSQL и URL подключения создаются scripts/init-local-secrets.ps1 и передаются только нужным контейнерам как Compose secrets. Redis не публикуется наружу и доступен только в backend network. Все образы закреплены тегами; миграции применяются единственным migrate service, до масштабируемых API.

scripts/restart.sh / .bat перезапускает API и хранилища без удаления volumes. scripts/stop-one.sh / .bat сопоставляет TARGET_INSTANCE_ID с контейнерным hostname и останавливает только одну API-реплику; восстановление выполняется оператором отдельно.