Files

Инфраструктура — лабораторная 3

Стенд: Docker Compose, Nginx, две API-реплики, PostgreSQL и Redis. Все зависимости описаны в compose.yaml; команды запуска и результаты — в REPORT.md.

Файл Назначение
nginx.conf единая точка входа, таймауты, DNS, пассивное исключение недоступных backend
upstreams.conf исходный список api-a и api-b, без привязки пользователя к реплике
healthwatch.sh параллельные проверки /health/ready, обновление рабочего upstream и reload Nginx

Контроллер readiness работает внутри контейнера Nginx. Он не получает Docker socket и секреты. Проверки двух API выполняются параллельно: пауза между циклами — 1 s, timeout каждой проверки — 1 s. При изменении готовности рабочая конфигурация /etc/nginx/upstreams.conf обновляется и проверяется через nginx -t, затем выполняется reload. Исходные файлы репозитория смонтированы только для чтения.

docker healthcheck показывает состояние контейнера, а healthwatch.sh отдельно связывает readiness API с маршрутизацией. При плановом обновлении scripts/manage.py устанавливает управляющую запись drain:<generation> в /tmp/control-api-a или /tmp/control-api-b; контроллер исключает эту реплику независимо от её readiness. После записи serve:<generation> реплика возвращается только при успешной проверке.

Плановая замена ждёт исключения backend и 6.5 s завершения старых worker Nginx (worker_shutdown_timeout=6s). Затем пересоздаётся одна API, проверяется Docker health и readiness контроллера, после чего можно заменять следующую. Если новая версия не готова, скрипт останавливается, сохраняя вторую реплику. Исправить образ и вернуть обе готовые реплики: python3 scripts/manage.py restore. Эта команда также снимает режим drain и ждёт возврата backend в Nginx. Контроллер подтверждает конкретное поколение управляющей записи только после применения конфигурации; рабочий файл заменяется атомарно. Перед остановкой выбранной реплики rolling-скрипт отдельно подтверждает включение другой реплики в LB.

Внутренние порты API, PostgreSQL и Redis наружу не публикуются. Наружу доступен только 127.0.0.1:${PUBLIC_PORT}:8080 у Nginx. container_name не используется. Два отдельных API-service выбраны для явной поочерёдной замены; изменение их числа требует согласованного изменения upstream и контроллера.