Cieľ
Pri commitovaní v gite spomíname v komentári akúkoľvek úlohu z Jira podľa mena, po čom nastanú dve veci:
- v GitLabe sa názov úlohy premení na aktívny odkaz na ňu v Jire
- v Jire sa k úlohe pridá komentár s odkazmi na commit a používateľa, ktorý ho vykonal, a tiež sa pridá samotný text zmienky
Nastavenie
- Potrebujeme používateľa Jiry s právami na úrovni write. Môžeme použiť existujúceho, je dôležité pamätať, že všetky komentáre v Jire pri zmienke úloh z gitu budú prichádzať od tohto používateľa, preto je lepšie vytvoriť nového s názvom, povedzme, GitLab a pridať ho do Jiry s právami write vo všetkých vašich projektoch.
- Potrebujeme používateľa GitLab s administrátorskými právami v každom projekte, ktorý budeme pripojovať. Pre každý projekt sa integrácia nastavuje samostatne.
- V GitLabe otvoríme projekt, prejdeme na Nastavenia -> Integrácie. Posunieme sa nadol, vidíme Služby projektu s dlhým zoznamom služieb, ktoré môžeme pripojiť.
- Nájdeme v tomto zozname Jira, objaví sa formulár

- Zaškrtneme políčko Aktívne, aby sme aktivovali spojenie.
- Ako je vidieť z formulára, môžeme samostatne nastaviť požadované správanie pre commit a merge-requesty.
- Zadáme Web URL vašej spoločnosti v Jire, napríklad ‘https://companyname.atlassian.net’
- Jira API url — vyplní sa, ak máte iný inštanciu Jiry, predvolene sa použije hodnota Web URL.
- Polia Používateľské meno/email a Heslo/token sa vyplnia v závislosti od toho, či používate Jira Server alebo Jira Cloud. V prípade Jira Server zadáte používateľské meno a heslo používateľa, od ktorého budú pridané komentáre. V prípade Jira Cloud zadáte email a token, ktorý môžete získať .
- Pole ID prechodu. Ak chcete, aby sa napríklad úloha automaticky uzavrela pri zmienke, musíte v tomto poli uviesť ID prechodu do stavu closed. Toto ID môžete získať prostredníctvom API:
https://companyname.atlassian.net/rest/api/2/issue/ISSUENAME-123/transitionskde ISSUENAME-123 je názov nejakej úlohy v požadovanom stave. Dostanete JSON s poľom prechodov, z ktorého môžete získať požadované id.
V dôsledku toho v GitLabe Nastavenia -> Integrácie Jira teraz má zelený indikátor:

a v menu projektu sa objaví položka Jira, ktorá vedie do príslušného projektu v Jire:
Použitie:
Keď píšeme komentár k commitu (je jedno, aký nástroj používame na prácu s gitom), môžeme pridať názvy úloh v textovej forme (bez úvodzoviek alebo akýchkoľvek špeciálnych symbolov typu @)
bugfix XPROJECT-123, XPROJECT-124v dôsledku toho sa k príslušnej úlohe pridá komentár:

a v GitLabe sa objaví aktívny odkaz:

Zdroj: habr.com



