Подключение и интеграции
Как подключить плагин в контуре и какие интеграции типичны. Формы плагинов при необходимости вставляются в документ воркспейса.
На какие вопросы отвечает раздел: Как подключить и изолировать плагин? Как поднять demo с готовыми интеграциями? Какие порты занимают плагины?
Подключение и каталог плагинов
- регистрация плагина в каталоге;
- конфигурация подключения;
- изоляция плагина сетью по политике безопасности.
Типовые интеграции
- шаблоны под очереди, базы данных, внешние API;
- подключение MCP-клиента (IDE, агент) к endpoint платформы
/mcp(см. MCP: платформа как сервер).
Demo Compose с плагинами
Образ kosolapus/conveyor-demo содержит только ядро. Готовый набор интеграций (Jira, Telegram, LLM, CalDAV) поднимается отдельными контейнерами через Compose из репозитория plugins.
Нужно: Docker Compose v2, Node.js ≥ 22, checkout plugins.
- В
.envрядом с compose:
DEMO_IMAGE_REF=kosolapus/conveyor-demo:latest
- В корне checkout plugins — SDK только из npm (
package.json):
{
"overrides": {
"@kosolapus/plugin-ts-sdk": "0.0.9"
}
}
Актуальная версия: npm view @kosolapus/plugin-ts-sdk version. Затем npm ci в корне plugins.
- Сборка и запуск:
docker compose up --build -d # demo + Jira + Telegram + LLM + CalDAV
docker compose up -d demo # только ядро
Шаблон переменных — compose.env.example рядом с compose.yml в том же репозитории. Токены PLUGIN_CONTROL_PLANE_KEY и PLUGIN_MANAGER_INGRESS_TOKEN должны совпадать у demo и плагинов.
Локальная разработка без demo-образа (раздельные микросервисы ядра и плагины в Docker): см. README backend-репозитория и раздел Разработка плагинов.
| Переменная | Назначение | По умолчанию |
|---|---|---|
DEMO_PLUGIN_HEALTH_INTERVAL_MS | Периодический TCP-опрос pull-endpoint плагинов; 0 — выключено | 1200000 (20 мин) |
Порты плагинов
Порты demo-ядра (8080, 4016–4017, 4020–4021): Cookbook → Развернуть.
| Плагин | Порт | Переменная |
|---|---|---|
| Telegram | 9400 | DEMO_TELEGRAM_EXECUTOR_PORT |
| Jira | 9401 | DEMO_JIRA_EXECUTOR_PORT |
| LLM (исполнитель) | 9404 | DEMO_LLM_EXECUTOR_PORT |
| LLM (UI-бандлы) | 9408 | DEMO_LLM_HEALTH_PORT |
| CalDAV | 9413 | DEMO_CALDAV_EXECUTOR_PORT |
Полный каталог портов по умолчанию (PLUGIN_TCP_PORT):
Telegram 9400, Jira 9401, Redmine 9402, Consensus 9403, LLM 9404, Wildberries 9405, Ozon 9406, Harness 9407, Email 9410, Office 9411, CalDAV 9413.
LLM и внешние API
- Ollama на хосте (по умолчанию):
host.docker.internal:11434, переменнаяDEMO_OLLAMA_BASE_URL. - Ollama Cloud или OpenAI-compatible API:
DEMO_OLLAMA_BASE_URL/DEMO_OPENAI_BASE_URLи ключ в секретах UI.
Дальше
- Безопасность: политики изоляции плагинов.
- Cookbook: управление плагинами