Cookbook
Управление плагинами
Рецепт жизненного цикла плагина в редакторе: подключение в контуре, включение, секреты, обновление и отключение.
Рецепт по жизненному циклу плагинов: регистрация исполнителя в контуре, включение в редакторе, настройка секретов и безопасное отключение. Плагины привязаны к учётной записи. UI-форму плагина можно вставить в markdown-документ воркспейса.
Задача: управлять набором подключённых плагинов. Результат: включённые интеграции, согласованные секреты, узлы доступны в библиотеке.
Когда применять
- нужна новая интеграция в процессе;
- требуется обновить или временно выключить существующий плагин.
Перед началом
- плагин зарегистрирован в контуре (см. Подключение плагинов);
- права на раздел «Плагины» и при необходимости на «Хранилище»;
- понимание модели плагинов (см. Плагины и интеграции).
Подключить и включить
- Убедитесь, что исполнитель плагина запущен в вашем контуре и его манифест принят plugin-manager (порты и Compose для demo: Demo Compose).
- В редакторе откройте вкладку «Плагины» в левой колонке.
- Найдите плагин в списке и включите переключатель. Статус «онлайн» означает, что исполнитель отвечает на опрос.
- На вкладке «Хранилище» создайте секреты, которые требует интеграция (токены, URL, ключи API).
- На вкладке «Палитра» появятся узлы плагина. Перетащите их на канвас процесса.
Настроить секреты в узлах
- в полях узла выберите секрет из «Хранилища» вместо явного значения;
- после смены секрета сохраните процесс (граф сохраняется автоматически) и выполните тестовый Запуск.
Сетевая изоляция plugin executor (allowlist CIDR, ingress-токены) задаётся при развёртывании контура, а не в редакторе. Подробнее: Безопасность.
Обновить плагин
- Обновите образ или бинарник исполнителя на стенде по инструкции разработчика плагина.
- Проверьте совместимость версии SDK с ядром (см. Разработка плагинов).
- Убедитесь, что плагин снова «онлайн» на вкладке «Плагины».
- Выполните тестовый Запуск процессов, где используются узлы этого плагина.
Отключить плагин
- Проверьте, какие процессы используют узлы плагина (при глобальном отключении администратором они переводятся в «Черновик»).
- Выключите переключатель на вкладке «Плагины» для своей учётной записи.
- Администратор может «Выключить для всех» или «Удалить плагин» через меню «⋯» у строки плагина.
Проверка результата
- узлы плагина видны в «Палитре» и выполняются в тестовом Запуске;
- секреты подставляются без ошибок в Трассировке Запуска;
- после отключения узлы недоступны для новых Запусков.