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 | Сайт: редактор, вход, API | DEMO_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 и проверить готовность
Демо-вход: 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; - тестовый Запуск выполняет шаги процесса до завершения;
- Трассировка Запуска фиксирует результаты выполнения шагов;
Связанное
- Быстрый старт: первый процесс после запуска
- Развёртывание: переменные окружения demo, on-prem
- Архитектура → Порты
- Плагины → Demo Compose