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

Цел

При коммите в git упоминаем в комментарии какую-либо задачу из Jira по имени, после чего происходят две вещи:

в GitLab название задачи превращается в активную ссылку на неё в Jira

в Jira к задаче добавляется комментарий со ссылками на коммит и пользователя, его совершившего, а также добавляется сам текст упоминания

Настройка

Нам нужен пользователь Jira с правами уровня write. Можно использовать существующего, важно помнить, что все комментарии в Jira при упоминании задач из git будут падать от имени этого пользователя, поэтому лучше создать нового, назвать его, скажем, GitLab, и добавить в Jira с правами write во все ваши проекты.
Нам нужен пользователь GitLab с правами администратора в каждом из проектов, который мы будем подключать. Для каждого проекта интеграцию настраиваем отдельно.
В GitLab открываем проект, заходим в Настройки -> Интеграции. Скроллим вниз, видим Сервисы проекта с длинным списком сервисов, которые можно подключить.
Находим в этом списке Jira, появляется форма
- Ставим галочку Активен, чтобы активировать связь.
- Как видно из формы, можно отдельно настроить нужное поведение для коммитов и merge-реквестов.
- Вводим Web URL вашей компании в Jira, например ‘https://companyname.atlassian.net’
- Jira API url — заполняется, если у вас есть другой инстанс Jira, по умолчанию будет использоваться значение Web URL.
- Полета Имя пользователя/Email и Пароль/Токен заполняются соответственно тому, используете ли вы Jira Server или Jira Cloud. В случае Jira Server вы вводите имя пользователя и пароль пользователя, от имени которого будут добавляться комментарии. В случае Jira Cloud вы указываете email и токен, который можно получить тук..
- Поле ID перехода. Если вы хотите, чтобы при упоминании задачи она автоматически закрывалась, то в этом поле нужно прописать ID перехода в состояние closed. Этот ID можно получить по API:
```
https://companyname.atlassian.net/rest/api/2/issue/ISSUENAME-123/transitions 
```
  где ISSUENAME-123 — имя какой-нибудь задачи в нужном состоянии. Вы получите JSON с массивом переходов, из которого можно взять нужный id.
В результате, в GitLab в Настройки -> Интеграции Jira теперь имеет зеленый индикатор:

и в меню проекта появится пункт Jira, который ведет в соответствующий проект в Jira:

Использование:

Когда пишем комментарий к коммиту (не важно, какой инструмент мы используем для работы с git), можем добавить название задач в текстовом виде (без кавычек или каких-либо спецсимволов типа @)

bugfix XPROJECT-123, XPROJECT-124

в резултат на съответната задача ще падне коментар:

и в GitLab ще се появи активна връзка:

Източник: habr.com