Ctrl+K
Ctrl+K
Ctrl+K

Пример настройки GitFlic webhook

Пример настройки GitFlic webhook#

Added in version 1.1-upd1.

В Automation Controller есть возможность запускать задания по запросу от внешних систем, в том числе по событиям, обнаруживаемым с помощью специальных программных модулей, называемых webhook.

Важно

Для обработки запросов от webhook Automation Controller должен быть доступен по HTTPS с доверенным сертификатом.

Получение токена#

Для получения токена выполните следующие действия:

  1. Создайте токен OAuth в настройках GitFlic.

  2. Скопируйте созданный токен, поскольку он понадобится позже для настройки контроллера.

Настройка контроллера#

Для настройки контроллера выполните следующие действия:

  1. В графическом интерфейсе Automation Controller перейдите в раздел Полномочия.

  2. Нажмите кнопку Добавить (Add).

  3. Заполните форму Создать новые учетные данные (Create New Credential):

    • Название (Name) – название полномочия, например, Доступ к GitFlic.

    • Описание (Description) – дополнительная информация о полномочии, например, Полномочие создано для настройки webhook GitFlic.

    • Организация (Organization) – организация, которой принадлежит полномочие, например, Jupiter.

      Если поле не заполнено, полномочие принадлежит всем организациям контроллера.

    • Тип полномочия (Credential Type) – тип полномочия.

      Выберите Личный токен доступа к GitFlic (GitFlic Personal Access Token).

    • Токен (Token) – введите токен, созданный ранее в GitFlic.

  4. Откройте в режиме редактирования шаблон задания, который необходимо связать с webhook, и измените значения следующих настроек:

    1. В секции Опции (Options) включите флаг Включить webhook (Enable Webhook).

    2. В секции Подробности о webhook (Webhook details) настройте следующие параметры:

      • Сервис webhook (Webhook Service): GitFlic.

      • Полномочия webhook (Webhook Credential): Доступ к GitFlic.

    3. Сохраните настройки.

  5. После сохранения шаблона контроллер сгенерирует параметры доступа для шаблона в следующем виде:

    • Webhook URL: <webhook URL>;

    • Ключ webhook (Webhook key): <hash code>.

  6. Скопируйте сгенерированные параметры, они понадобятся для настройки webhook в GitFlic.

Настройка GitFlic#

Для настройки GitFlic выполните следующие действия:

  1. В настройках проекта в GitFlic выберите вкладку Вебхуки.

  2. Нажмите кнопку Создать.

  3. В полях URL для отправки данных и Секрет введите значения, полученные ранее. Прочие поля оставьте пустыми.

  4. Выберите события, при наступлении которых по указанному URL будут передаваться данные, например, Новый запрос на слияние.

Проверка работоспособности#

Для проверки корректности настройки webhook выполните следующие действия:

  1. Создайте запрос на слияние в GitFlic.

  2. Убедитесь, что в Automation Controller стартовало задание.

  3. После выполнения задания откройте его и выберите вкладку Подробности (Details).

  4. Убедитесь, что переменная awx_webhook_status_api имеет значение null.

  5. Убедитесь, что в файле /var/log/tower/tower.log нет ошибок.

Содержание