🥇Integracja Jira z GitLab

Cel

Podczas commitowania w git wspominamy w komentarzu o jakimkolwiek zadaniu z Jira po nazwie, po czym zachodzą dwie rzeczy:

w GitLab tytuł zadania zamienia się w aktywne łącze do niego w Jira

w Jira do zadania dodawany jest komentarz z linkami do commit oraz użytkownika, który go wykonał, a także dołączany jest sam tekst wspomnienia

Konfiguracja

Potrzebujemy użytkownika Jira z uprawnieniami na poziomie write. Można użyć istniejącego, ważne jest, aby pamiętać, że wszystkie komentarze w Jira przy wspomnieniu zadań z gita będą spadały od tego użytkownika, dlatego lepiej stworzyć nowego, nazwać go powiedzmy GitLab i dodać do Jira z uprawnieniami write we wszystkich twoich projektach.
Potrzebujemy użytkownika GitLab z prawami administratora w każdym z projektów, które będziemy podłączać. Dla każdego projektu integracja jest konfigurowana osobno.
W GitLab otwieramy projekt, przechodzimy do Ustawienia -> Integrations. Przewijamy w dół, widzimy Usługi projektu , z długą listą usług, które można podłączyć.
Znajdujemy na tej liście Jira, pojawia się formularz
- Stawiamy haczyk Active, aby aktywować powiązanie.
- Jak widać z formularza, można osobno skonfigurować pożądane zachowanie dla commitów i merge-requestów.
- Wprowadzamy Web URL twojej firmy w Jira, na przykład 'https://companyname.atlassian.net'
- URL API Jira — uzupełnia się, jeśli masz inną instancję Jira, domyślnie będzie używana wartość Web URL.
- Pola Nazwa użytkownika / E-mail i Hasło / Token uzupełniają się stosownie do tego, czy korzystasz z Jira Server czy Jira Cloud. W przypadku Jira Server wprowadzasz nazwę użytkownika i hasło użytkownika, z którego będą dodawane komentarze. W przypadku Jira Cloud wprowadzasz e-mail i token, który można uzyskać tutaj.
- Pole ID przejścia. Jeśli chcesz, powiedzmy, aby przy wspomnieniu zadania automatycznie się zamykało, to w tym polu należy wpisać ID przejścia w stan zamknięty. Ten ID można uzyskać przez API:
```
https://companyname.atlassian.net/rest/api/2/issue/ISSUENAME-123/transitions 
```
  gdzie ISSUENAME-123 — nazwa jakiegoś zadania w odpowiednim stanie. Otrzymasz JSON z tablicą przejść, z której możesz wziąć potrzebne id.
W rezultacie w GitLab w Ustawienia -> Integrations Jira teraz ma zielony wskaźnik:

i w menu projektu pojawi się punkt Jira, który prowadzi do odpowiedniego projektu w Jira:

Użycie:

Kiedy piszemy komentarz do commitu (nie ma znaczenia, jakiego narzędzia używamy do pracy z gitem), możemy dodać nazwę zadań w formie tekstowej (bez cudzysłowów lub jakichkolwiek znaków specjalnych typu @)

bugfix XPROJECT-123, XPROJECT-124

W przypadku odpowiedniego zadania pojawi się komentarz:

a w GitLabie pojawi się aktywne odnośnik:

Źródło: habr.com