Files
mtusi2026lab5/infra
Самохвалов Андрей Ремович b23ecc111f feat: Accept durable queued uploads and publish outbox jobs (U2)
Carry forward the lab4 API and storage baseline, stage verified originals in
MinIO, and atomically commit attachment, job, and outbox records before 202.
Publish identifier-only jobs with broker confirms and reclaimable outbox leases.
Clean abandoned and completed staging objects after database checks.
2026-10-02 14:35:35 +03:00
..

Инфраструктура студента

Здесь разместите конфигурации выбранных сервисов; основную топологию — в корневом compose.yaml/stack.yaml. compose.example.yaml — только worksheet ролей и намеренно не запускается. contracts/infrastructure.json задаёт минимальные роли, не готовые образы/пароли.

В REPORT.md сопоставьте роль → service name → версия/digest → health/readiness → volume → сеть/порт → способ передачи credentials. Приведите bootstrap (schema, bucket, broker topology, а с lab6 provisioning) и безопасное повторение этих команд.

Приложение строится из исходников. Не используйте заранее существующий образ преподавательского сервера вместо своей реализации. Restart hook перезапускает все соответствующие stores с volumes; failover hook останавливает только заданную API-реплику.

Локальный RabbitMQ

python3 scripts/setup-local-secrets.py
python3 scripts/init_local_broker.py
cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build

Скрипты создают игнорируемые Git файлы в secrets/, не печатая пароли. broker-init повторяемо объявляет attachments.process как durable quorum queue; publisher и worker используют тот же BROKER_QUEUE и файл BROKER_URL_FILE. Порт RabbitMQ наружу не публикуется. Volume broker_data переживает docker compose restart broker; down -v намеренно удаляет учебные данные.

compose.yaml содержит все роли; compose.broker.yaml оставлен для отдельной проверки брокера. Один узел RabbitMQ с quorum queue обеспечивает сохранность при рестарте с volume, но не отказоустойчивость при потере узла или диска.

staging-cleanup раз в минуту сверяет объекты staging/ с PostgreSQL. Он удаляет только staging уже готовой текущей версии после записи исходного варианта либо непривязанные объекты старше часа, если нет действующей аренды загрузки. queued и processing сохраняются. Просроченные записи аренды также удаляются после часа ожидания. Настройки: STAGING_GRACE_SECONDS и STAGING_CLEANUP_INTERVAL_SECONDS. Сервис получает отдельные maintenance credentials с правом просмотра bucket; секреты остаются в игнорируемом secrets/.

При недоступности Docker DNS локальный игнорируемый compose.local.yaml может задавать build.extra_hosts для Python package host. Это настройка конкретного стенда; основной Compose остаётся переносимым.