Files
mtusi2026lab3/infra
2026-11-07 10:41:21 +03:00
..
2026-11-07 10:41:21 +03:00
2026-11-07 10:41:21 +03:00

Стенд лабораторной 3

Основная топология — compose.yaml, проект mtusi2026lab3. Единственный опубликованный порт — 127.0.0.1:18080 у HAProxy. API, PostgreSQL и Redis доступны только внутри сети проекта. Это один Docker-host; отказ его, единственной БД или LB не защищён.

make up создаёт отдельные синтетические credentials и ключи через scripts/bootstrap.sh, собирает приложение, запускает миграции и ожидает готовности. Существующая .env не используется; локальные настройки находятся в игнорируемой .env.lab3. Повторный bootstrap сохраняет ранее созданные файлы. Версии и digest образов закреплены в Compose и Dockerfile.

Роль Service Ресурсы по умолчанию Готовность Хранение
API × 2 api 1 CPU, 512 MiB каждый /health/ready, PostgreSQL ping ≤200 мс локальных данных корректности нет
Миграции migrate 0.5 CPU, 128 MiB завершение с кодом 0 перед API встроенные Tern-миграции
LB lb 0.5 CPU, 128 MiB HTTP через публичный listener infra/haproxy.cfg
PostgreSQL 17.11 postgres 2 CPU, 1 GiB pg_isready postgres_data: пользователи, сессии, чаты, сообщения, ключи
Redis 8.2.11 redis 0.25 CPU, 128 MiB authenticated PING redis_data, AOF; только необязательный кэш

HAProxy 3.2.26 обнаруживает до четырёх адресов service api через Docker DNS 127.0.0.11, обновляет записи каждую секунду и проверяет HTTP readiness каждую секунду, fall=2, rise=1, timeout=500 мс. Расчётный бюджет обнаружения отказа — до 3 секунд; задержки планирования и перегрузка могут его увеличить. Фактическое восстановление фиксируется отдельно в evidence. Sticky sessions и прозрачные повторы POST не используются.

Согласование таймаутов: приложение/SQL — 2 с, LB connect — 500 мс, LB client/server и API read/write — 5 с, graceful shutdown — 8 с, Docker stop grace — 10 с. SIGTERM снимает readiness, закрывает listener и ждёт активные запросы; по истечении shutdown timeout соединения принудительно закрываются.

/internal/metrics, статистика LB на 8404 и административный TCP socket на loopback:9999 не публикуются. Метрики собираются через docker exec. Административный socket нужен скрипту поочерёдной замены: drain → ожидание активных запросов → SIGTERM → создание замены → readiness → ready. Docker socket внутрь сервисов не монтируется.

Миграции выполняет только одноразовый service; API игнорирует прежний startup-флаг миграций. Миграция 006 добавляет таблицу и не меняет прежние таблицы, поэтому совместима со старой версией. Одновременное обслуживание запросов старой lab2-версией, не поддерживающей идемпотентность, контракт lab3 не обеспечивает: переход lab2→lab3 требует первоначального развёртывания нового стенда. Последующие замены lab3 проверяются под нагрузкой.

Credentials PostgreSQL/Redis передаются окружением только соответствующим сервисам. У migrate нет ключевого volume и пароля Redis; он использует только PostgreSQL. Ключи подписи синтетических сессий общие для API, монтируются read-only и не входят в build context. Внешний HTTP предназначен для локального учебного стенда. Команды эксплуатации и реальные результаты приведены в REPORT.md.