​
Введение

Триггеры доступны только для приложений Workflow.
Триггер плагина автоматически запускает ваш рабочий процесс, когда во внешней системе происходит определённое событие. Всё, что нужно сделать, — подписаться на эти события через триггер-плагин и добавить соответствующий триггер плагина в рабочий процесс. Например, предположим, что вы установили триггер-плагин GitHub. Он предоставляет список событий GitHub, на которые можно подписаться, включая Pull Request, Push и Issue. Если вы подпишетесь на событие Pull Request и добавите триггер плагина Pull Request в рабочий процесс, он будет автоматически запускаться каждый раз, когда кто-либо открывает pull request в указанном репозитории.

​
Добавление и настройка триггера плагина

  1. На холсте рабочего процесса щёлкните правой кнопкой мыши и выберите Добавить узел > Старт, затем выберите один из доступных триггеров плагинов или найдите другие в Интеллос Маркетплейс.
  2. Выберите существующую подписку или создайте новую.
    Узнать, сколько рабочих процессов используют конкретную подписку, можно на панели сведений о плагине в разделе Плагины.
  3. Настройте все остальные необходимые параметры.
Выходные переменные триггера плагина определяются его триггер-плагином и не могут быть изменены.

​
Создание новой подписки

Триггер-плагин поддерживает создание до 10 подписок на одно рабочее пространство.
Каждая подписка построена на вебхуке. Когда вы создаёте подписку, вы по сути настраиваете вебхук, который прослушивает события из внешней системы.
Вебхук позволяет одной системе автоматически отправлять данные в реальном времени в другую. Когда происходит определённое событие, исходная система упаковывает сведения о событии в HTTP-запрос и отправляет его на указанный URL, предоставленный системой-получателем.
Интеллос поддерживает два следующих способа создания подписок (вебхуков), но доступные в каждом плагине варианты зависят от того, как этот плагин был спроектирован.
  • Автоматическое создание: вы выбираете события, на которые хотите подписаться, и Интеллос автоматически создаёт соответствующий вебхук во внешней системе. Для этого требуется предварительная авторизация через OAuth или API-ключи, чтобы Интеллос мог выполнить настройку вебхука за вас.
  • Ручное создание: вы создаёте вебхук самостоятельно, используя callback-URL вебхука, предоставленный Интеллос. Авторизация не требуется.
Способы создания подписок
При создании подписки рекомендуется выбирать все доступные события.Триггер плагина работает только тогда, когда соответствующее ему событие включено в связанную подписку. Выбор всех доступных событий гарантирует, что любой триггер плагина, который вы добавите в рабочий процесс позже, сможет использовать ту же подписку — без необходимости обновлять её или создавать новые.
Некоторые триггер-плагины поставляются с OAuth-клиентом по умолчанию, поэтому вы можете авторизовать Интеллос одним нажатием. Для остальных используется вариант с пользовательским OAuth-клиентом, то есть вам нужно самостоятельно создать OAuth-приложение во внешней системе.
  1. Выберите Создать через OAuth > По умолчанию > Сохранить и авторизовать.
    Сохранить означает, что выбранный вариант устанавливается как метод OAuth по умолчанию для будущих подписок.Чтобы сменить метод позже, нажмите значок Настройки OAuth-клиента.
    Значок настроек OAuth-клиента
  2. На открывшейся странице авторизации внешней системы нажмите Далее, чтобы предоставить Интеллос доступ.
  3. Укажите имя подписки, выберите события, на которые хотите подписаться, и настройте все остальные необходимые параметры.
    Мы рекомендуем выбрать все доступные события, но вы всегда можете изменить свой выбор позже на панели сведений о плагине в разделе Плагины.
  4. Нажмите Создать.
Отображаемый URL для обратного вызова используется Интеллос внутренне для создания вебхука во внешней системе за вас, поэтому никаких действий с этим URL предпринимать не нужно.Для самостоятельно размещённых развёртываний вы можете изменить базовый префикс URL через переменную среды TRIGGER_URL. Убедитесь, что он указывает на публичный домен или IP-адрес, доступный для внешних систем.

​
Тестирование триггера плагина

Чтобы протестировать неопубликованный триггер плагина, сначала нажмите Запустить этот шаг или выполните тестовый запуск всего рабочего процесса. Это переводит триггер в состояние прослушивания, чтобы он мог отслеживать внешние события. В противном случае триггер не зафиксирует события, на которые он подписан, даже если они произойдут.