Стенд лабораторной 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.