Cookbook

Развернуть Conveyor

Пошаговый рецепт запуска Docker demo: команды, порты, тома и проверка.

Практический рецепт: поднять demo-контур Conveyor из готового образа на Docker Hub.

Задача: получить работающий UI и ядро. Результат: можно войти в редактор и запускать процессы.

Когда применять

  • первая установка для оценки внутри команды;
  • локальная проверка перед подключением плагинов или pilot.

Перед началом

  • Docker 24+;
  • 2 GB RAM;
  • свободные порты на хосте: 8080 (сайт), 4016–4017, 4020–4021. Подробнее в таблице портов. Для знакомства с UI достаточно 8080.

Шаг 1. Скачать образ

docker pull kosolapus/conveyor-demo:latest

Шаг 2. Запустить контейнер

docker run --rm --name flowforge-demo \
  -p 8080:8080 -p 4020:4020 -p 4021:4021 -p 4016:4016 -p 4017:4017 \
  kosolapus/conveyor-demo:latest

Первый старт ~1–2 мин.

С сохранением данных

Postgres и Vault (секреты переживают рестарт):

docker volume create flowforge-demo-vault
docker run --rm --name flowforge-demo \
  -p 8080:8080 -p 4020:4020 -p 4021:4021 -p 4016:4016 -p 4017:4017 \
  -v flowforge-demo-pg:/var/lib/postgresql/data \
  -v flowforge-demo-vault:/data/vault \
  kosolapus/conveyor-demo:latest

Полный набор томов (файлы и workspace):

docker run --rm --name flowforge-demo \
  -p 8080:8080 -p 4020:4020 -p 4021:4021 -p 4016:4016 -p 4017:4017 \
  -v flowforge-demo-pg:/var/lib/postgresql/data \
  -v flowforge-demo-files:/data/files \
  -v flowforge-demo-workspace:/data/run-workspace \
  -v flowforge-demo-vault:/data/vault \
  kosolapus/conveyor-demo:latest

Без тома /data/vault при каждом старте создаётся новый transit-ключ. Ранее сохранённые в UI секреты расшифровать будет нельзя.

Проброшенные порты

ПортЗачем нуженПеременная
8080Сайт: редактор, вход, APIDEMO_WEB_PORT
4016Подключение внешних плагинов к ядруDEMO_PM_TCP_PORT
4017Проверка, что ядро поднялось (/health)DEMO_PM_HEALTH_PORT
4021Ответы плагинов о выполнении шаговDEMO_CP_TCP_PORT
4020Служебный HTTP движка (метрики, отладка)DEMO_CP_HTTP_PORT

Для знакомства с продуктом хватит 8080. Переопределение проброса портов: переменные DEMO_*_PORT (Compose, см. Плагины → Demo Compose).

Шаг 3. Открыть UI и проверить готовность

UI: http://localhost:8080

Демо-вход: admin-test@flowforge.local / Test123456!

curl -fsS http://127.0.0.1:8080/health
curl -fsS http://127.0.0.1:4017/health

Частые проблемы

  • порт 8080 занят: смените mapping, например -p 18080:8080 (и задайте PUBLIC_SITE_URL / откройте UI на том же порту);
  • нехватка RAM: увеличьте лимит Docker Desktop;
  • no matching manifest for linux/amd64: убедитесь, что тянете актуальный multi-arch тег kosolapus/conveyor-demo:latest с Hub.

Проверка результата

  • UI открывается, ядро отвечает на /health;
  • тестовый Запуск выполняет шаги процесса до завершения;
  • Трассировка Запуска фиксирует результаты выполнения шагов;

Связанное