Интеграция с Jira


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

Для создания интеграции можно использовать как локальную версию Jira, так и Jira Cloud.

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

Для создания новой интеграции с Jira нажмите кнопку “Добавить” и заполните необходимые поля.

Установление соединения

  • Укажите URL-адрес веб-страницы, например https://jira.example.com
  • Укажите URL-адрес API Jira, например https://jira-api.example.com Если оставить данное поле пустым, то будет использоваться значение URL-адрес веб-страницы. Оставьте пустым данное поле для Jira Cloud.
  • Выберите метод аутентификации
    • Базовый. Аутентификации с помощью электронной почты или имени пользователя и API-токена или пароля.
    • Токен личного доступа Jira. Токен можно создать в настройках профиля Jira, в разделе Персональные токены доступа

Для проверки установленного соединения есть соответствующая кнопка

Триггеры

В данном разделе выбираются события - коммит или запрос на слияние, после которых срабатывает интеграция. Для работы интеграции можно упоминать задачу как в виде полной ссылки (например, https://jira.example/browse/GIT-1), так и в виде только префикса (например, GIT-1). Упоминать задачи в запросе на слияния можно в заголовке или описании. Кроме того, интеграция будет реагировать на изменение статуса запроса на слияние.

Настройка действий - создание комментария или изменение статуса задачи, происходит также здесь.

  • Включить комментарии. Интеграция автоматически создаст комментарий в задаче с описанием события, в котором данная задача была упомянута. Для выбора полноты комментария присутствуют опции Стандартные комментарии и Расширенные комментарии.

  • Переводить задачи Jira в их финальное состояние. Интеграция автоматически переведет статус задачи в финальный. Настройка Использовать пользовательский ID финального состояния позволит указать конкретный ID статуса, если в вашем рабочем процессе Jira финальный статус отличается от Done.

Сопоставление задач в Jira

Для ограничения списка задач, упоминание которых вызовет срабатывание интеграции, необходимо воспользоваться следующими настройками:

  • Регулярное выражение для задач в Jira. Сопоставление ключей задач Jira с регулярными выражениями, соответствующие синтаксису RE2

  • Префикс для проблем в Jira. Сопоставление ключей задач Jira c указанным префиксом. (например, GIT #)

Пример работы интеграции

Внимание! Максимальное количество интеграций для каждого проекта 1