infra

Docker Compose инфраструктура для локального запуска и production deploy проекта NPPWEB.

Что поднимается

• postgres
• redis
• rabbitmq
• minio
• minio-init
• backend-api
• processing-worker
• scraper-service
• xray-proxy (если настроен локальный proxy-конфиг)
• frontend

Все сервисы работают в сети platform-net и обращаются друг к другу по service name.

Локальный запуск

Быстрый вариант через общий стек:

cp .env.example .env
docker compose --env-file .env -f docker-compose.yml -f docker-compose.apps.yml up -d --build

Альтернатива:

make up

Если для государственных площадок нужен proxy-маршрут, создайте локальный файл:

cp xray-local/config.example.json xray-local/config.json

и заполните его приватными параметрами. Этот файл не коммитится.

Для deploy-контура логика такая же: на сервере должен существовать файл xray-local/config.json. Чтобы compose поднял xray-proxy автоматически, добавьте в deploy .env значение COMPOSE_PROFILES=proxy и задайте HTTP_PROXY/HTTPS_PROXY=http://xray-proxy:8080.

Если в deploy .env указаны HTTP_PROXY/HTTPS_PROXY, но не задан COMPOSE_PROFILES=proxy, сервис xray-proxy не будет создан, и scraper-service начнёт массово получать fetch failed/connect timeout на внешних государственных площадках.

Куда открыть браузер

• frontend: http://localhost:8080
• GraphQL backend: http://localhost:3000/graphql
• backend health: http://localhost:3000/api/health
• RabbitMQ management: http://localhost:15672
• MinIO console: http://localhost:9001

Локальные учётные данные

После старта backend-api автоматически прогоняет миграции и seed.

• admin@admin.ru / 12345678
• analyst@admin.ru / 12345678
• user@admin.ru / 12345678

Проверка состояния

docker compose --env-file .env -f docker-compose.yml -f docker-compose.apps.yml ps
docker compose --env-file .env -f docker-compose.yml -f docker-compose.apps.yml logs backend-api processing-worker scraper-service frontend

Ожидаемо:

• postgres, rabbitmq, minio, backend-api, frontend имеют статус healthy
• minio-init завершился со статусом Exited (0)
• processing-worker и scraper-service находятся в Up

Проверки вручную:

curl http://localhost:3000/api/health
curl http://localhost:3000/api/health/ready
curl -I http://localhost:8080

Полезные команды

Поднять весь стек:

docker compose --env-file .env -f docker-compose.yml -f docker-compose.apps.yml up -d --build

Пересобрать только frontend:

docker compose --env-file .env -f docker-compose.yml -f docker-compose.apps.yml up -d --build frontend

Остановить стек и удалить volumes:

docker compose --env-file .env -f docker-compose.yml -f docker-compose.apps.yml down -v --remove-orphans

Смотреть логи:

docker compose --env-file .env -f docker-compose.yml -f docker-compose.apps.yml logs -f

Что обеспечивает устойчивый старт

• postgres, rabbitmq, minio, backend-api имеют healthcheck'и
• minio-init создаёт bucket до старта scraper-service
• backend-api ждёт Postgres и запускает migrations/seed перед стартом
• processing-worker ждёт rabbitmq и backend-api
• scraper-service ждёт rabbitmq, minio и minio-init
• scraper-service может идти наружу через xray-proxy, если в .env заданы HTTP_PROXY/HTTPS_PROXY

GitHub Actions

В репозитории оставлен только CI workflow. Автоматический deploy и связанные с ним GitHub Actions удалены.