Подключение и интеграции

Как подключить процесс плагина к plugin-manager и control plane в вашем контуре. Формы плагинов при необходимости вставляются в документ воркспейса.

На какие вопросы отвечает раздел: Как зарегистрировать исполнитель в каталоге? Как поднять demo с sidecar-плагинами? Как изолировать плагин сетью?

Подключение и каталог

Plugin-manager принимает TCP-публикацию манифеста. После успешной регистрации плагин появляется в каталоге редактора. Изоляция задаётся политикой сети и ingress-токенами контура (см. Безопасность).

Репозиторий примеров и compose

Примеры, compose, env и per-package README: flowforge-orchestrator/plugins.

Актуальный состав reference-пакетов, порты sidecar, команды запуска и чеклист проверки поддерживаются в README и файлах compose.demo.yml, compose.env.example этого репозитория. На /docs они не дублируются.

Demo Compose с sidecar-плагинами

Образ kosolapus/conveyor-demo на Docker Hub содержит только ядро (UI, API, plugin-manager, runtime). Sidecar-процессы плагинов собираются и запускаются из checkout репозитория plugins в одной Docker-сети с demo.

Образ публикуется как multi-arch (linux/amd64, linux/arm64). docker pull kosolapus/conveyor-demo:latest подбирает платформу хоста.

Нужно: Docker Compose v2, Node.js ≥ 22, checkout репозитория plugins.

Общий порядок:

1. Клонировать repo и перейти в его корень.
2. Скопировать или передать переменные из compose.env.example (в том числе DEMO_IMAGE_REF=kosolapus/conveyor-demo:latest).
3. Выполнить команду сборки и запуска из README repo (файл compose.demo.yml).
4. Убедиться, что PLUGIN_CONTROL_PLANE_KEY и PLUGIN_MANAGER_INGRESS_TOKEN совпадают у контейнера demo и sidecar-сервисов.

Только ядро без sidecar: в README repo описан запуск сервиса demo без остальных сервисов compose.

SDK для сборки плагинов берётся только из npm. Версию pin и матрицу совместимости с ядром см. справочник config и npm view @kosolapus/plugin-ts-sdk version. Перед npm ci в корне checkout repo выполните сверку версии SDK.

Порты ядра demo на хосте (8080, 4016–4017, 4020–4021): Cookbook → Развернуть. Порты executor sidecar и переменные DEMO_*_EXECUTOR_PORT см. в README repo.

Разработка собственного пакета: Разработка плагина (SDK).

External stack

Если plugin-manager и runtime-control-plane уже работают в общей user-defined Docker-сети, sidecar-плагины поднимаются через docker-compose.yml в checkout repo (без demo-образа). В compose repo раскомментируйте блок networks с external: true и укажите имя сети вашего стека. RPC-хосты, порты control plane и токены возьмите из prod-like секции compose.env.example. У каждого сервиса плагина PLUGIN_PULL_ADVERTISED_HOST должен совпадать с DNS-именем сервиса в compose.

Подробные шаги и env: README репозитория plugins.

Типовые сценарии интеграции

• исходящие вызовы внешних API из исполнителя плагина;
• подключение MCP-клиента (IDE, агент) к endpoint платформы /mcp (см. MCP: платформа как сервер).

Дальше

• Безопасность: политики изоляции плагинов.
• Cookbook: управление плагинами
• Разработка плагина (SDK)