Выбранная инфраструктура: 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-реплику; восстановление выполняется
оператором отдельно.