Jira

Интеграция Шерлока с Jira позволяет:

• Создавать задачи в Jira из Шерлока
• Получать информацию из Jira о задачах (статус, исполнитель)
• Синхронизировать комментарии между Шерлоком и Jira

внимание

Для автоматической настройки двусторонней интеграции необходимо, при создании интеграции, использовать токен Администратора Jira. В этом случае Шерлок сможет самостоятельно зарегистрировать веб-хук при настройке интеграции репозитория с пространством в Jira.

В противном случае необходимо зарегистрировать веб-хук самостоятельно. Подробнее о том, как это сделать, написано в разделе Настройка веб-хуков в Jira.

Создание интеграции

1. Для добавления интеграции с Jira необходимо перейти в раздел Настройки системы () -> Интеграции (), выбрать Jira и нажать Подключить.

   

2. Заполнить необходимые параметры в открывшемся окне:

   • URL сервера: доменное имя или IP-адрес сервера Jira;

   • Токен API: токен доступа для Jira. Информацию о том, как его создать можно найти в документации Jira;

     к сведению

     Автоматическая регистрация веб-хуков для реализации двусторонней интеграции с Jira возможна только в случае использования токена Администратора.
     В любом ином сценарии веб-хук придется регистрировать в Jira "в ручном" режиме.

   • Протокол веб-хуков: протокол веб-хуков (http или https), который будет использоваться для создания веб-хуков;

   • Сертификат корневого УЦ:

     • Если выбрана опция Не проверять сертификат, то SSL-соединение будет установлено, однако, проверка валидности сертификата осуществляться не будет;
     • Если выбрана опция Проверять, то необходимо указать сертификат. Его можно приложить в виде файла формата crt или pem или вписать явно в поле для ввода текста.

3. Нажать кнопку Подключить. В случае успеха Шерлок оповестит о том, что подключение настроено и можно продолжать работу.

Изменение интеграции

1. Для изменения интеграции необходимо нажать на иконку редактирования (), расположенную рядом с интеграцией, которую необходимо изменить.

   
   к сведению

   Настройки изменения интеграции аналогичны тем, что используются и при ее создании.

2. Нажать кнопку Сохранить после внесения необходимых изменений. В случае успеха Шерлок оповестит о том, что подключение изменено и можно продолжать работу.

Удаление интеграции

1. Для удаления интеграции необходимо нажать на иконку удаления (), расположенную рядом с интеграцией, которую необходимо удалить.

   

2. В открывшейся форме нажать кнопку Отключить. В случае успеха Шерлок оповестит о том, что подключение удалено и можно продолжать работу.

   внимание

   В случае, если в Шерлоке присутствуют репозитории, для которых настроена интеграция с Jira удалить интеграцию на системном уровне не получится.
   Сперва необходимо удалить все интеграции репозиториев с Jira.