Инструкция по установке ПО

Перед началом установки убедитесь, что рабочее окружение подготовлено и у вас есть комплект файлов развертывания системы.

Предварительные требования

• Установлены Docker и Docker Compose
• Подготовлен каталог проекта с compose-файлами и шаблоном переменных окружения
• Не заняты внешние порты 3000, 8001, 9000, 9001; при использовании Adminer также 8080
• Предоставлены учетные данные для доступа к Container Registry

Шаг 1. Подготовка рабочего каталога

Перейдите в каталог проекта, в котором размещены файлы развертывания:

cd blast4d-compose-develop

Убедитесь, что структура директорий соответствует ожидаемой:

blast4d-compose-develop/
├── services/                 # Backend микросервисы (FastAPI)
├── frontend/                 # Интерфейс (Next.js)
├── shared/                   # Общие модули
├── database/                 # SQL-схемы
├── keycloak/                 # Аутентификация
├── nginx/                    # Конфигурация реверс-прокси
├── scripts/                  # Скрипты развертывания
├── docker-compose.yml
├── docker-compose.prod.yml
├── .env.local                # Шаблон переменных окружения
└── ЗАПУСК_СИСТЕМЫ.md         # Главная инструкция

Шаг 2. Настройка переменных окружения

Создайте рабочий файл окружения на основе шаблона:

cp .env.local .env

При необходимости откройте .env и заполните значения, выданные для вашего контура: адреса сервисов, учетные данные и параметры доступа.

Шаг 3. Подключение к Container Registry

Авторизуйтесь в Container Registry с выданными учетными данными:

docker login <адрес-container-registry>

После этого загрузите контейнерные образы системы:

docker compose -f docker-compose.yml -f docker-compose.prod.yml pull

Шаг 4. Проверка сетевой схемы

Учтите различие между внутренними и внешними портами:

• Внутренние порты сервисов внутри Docker-сети xblast4d-network: 8201, 8202, 8203, 8204, 8205, 8206, 8207, 8209, 8210, 8212
• Порты PostgreSQL, Redis и MinIO используются сервисами системы и не требуют отдельного открытия для пользователей
• Внешние порты на хосте используются для доступа к веб-интерфейсу и служебным компонентам системы

к сведению

Базовый compose-файл описывает состав сервисов и внутреннюю сеть. Рабочий запуск системы выполняется с использованием эксплуатационной конфигурации поставки.

Компоненты системы

Система «Взрыв4D» включает следующие компоненты, разворачиваемые в Docker Compose:

Компонент	Описание
Frontend	Веб-интерфейс на Next.js
API Gateway	Маршрутизация API-запросов
Вычислительные сервисы	Backend-микросервисы моделирования
PostgreSQL	Реляционная база данных
MinIO	Объектное хранилище файлов
Keycloak	Сервер аутентификации
Nginx	Реверс-прокси
Redis	Кэширование и очереди задач

Зависимости

Все прикладные зависимости уже включены в контейнерные образы из Container Registry. Ручная установка Python, Node.js или прикладных библиотек на хостовую систему не требуется.