Integrace Jira s GitLab

Cíl

Při commitu do gitu zmiňujeme v komentáři nějaký úkol z Jiry podle názvu, po čemž nastanou dvě věci:

• v GitLab se název úkolu změní na aktivní odkaz na něj v Jire

• v Juře se k úkolu přidá komentář se odkazy na commit a uživatele, který jej provedl, a také se přidá samotný text zmínky

Nastavení

1. Potřebujeme uživatele Jiry s právy úrovně write. Můžeme použít existujícího, ale je důležité si pamatovat, že všechny komentáře v Juře při zmiňování úkolů z gitu budou zaslány jménem tohoto uživatele, takže je lepší vytvořit nového, pojmenovat ho například GitLab a přidat do Jiry s právy write do všech vašich projektů.
2. Potřebujeme uživatele GitLab s právy administrátora v každém z projektů, které budeme připojovat. Pro každý projekt se integrace nastavuje zvlášť.
3. V GitLab otevřeme projekt, přejdeme na Nastavení -> Integrace. Posuneme se dolů, vidíme Služby projektu s dlouhým seznamem služeb, které lze připojit.
   
4. V tomto seznamu najdeme Jiru, zobrazí se formulář
   
   
   • Zaškrtneme políčko Aktivní, abychom aktivovali propojení.
   • Jak můžete vidět z formuláře, lze samostatně nastavit požadované chování pro commity a merge requesty.
   • Zadáváme Webová URL vaší společnosti v Juře, například ‘https://companyname.atlassian.net’
   • Jira API url — vyplní se, pokud máte jinou instanci Jiry, ve výchozím nastavení se použije hodnota Webová URL.
   • Pole Uživatelské jméno/E-mail a Heslo/Tokén se vyplňují podle toho, zda používáte Jira Server nebo Jira Cloud. V případě Jira Server zadáte uživatelské jméno a heslo uživatele, jménem kterého budou přidávány komentáře. V případě Jira Cloud zadáte e-mailovou adresu a token, který lze získat zde.
   • Pole ID přechodu(y). Pokud chcete, aby se při zmiňování úkolu automaticky uzavřel, musíte do tohoto pole zadat ID přechodu do stavu closed. Toto ID můžete získat pomocí API:

     https://companyname.atlassian.net/rest/api/2/issue/ISSUENAME-123/transitions 

     kde ISSUENAME-123 je název nějakého úkolu ve správném stavu. Získáte JSON s polem přechodů, ze kterého si můžete vzít požadované id.

   A jako výsledek v GitLab v Nastavení -> Integrace Jira nyní má zelený indikátor:

   
   
   a v nabídce projektu se objeví položka Jira, která vede k odpovídajícímu projektu v Juře:

   

Použití:

Když píšeme komentář k commitu (nezáleží na tom, jaký nástroj při tom používáme pro práci s gitem), můžeme do textu přidat název úkolů v textové podobě (bez uvozovek nebo jakýchkoli speciálních symbolů typu @)

oprava XPROJECT-123, XPROJECT-124

v důsledku toho k příslušnému úkolu přibude komentář:

a v GitLabu se objeví aktivní odkaz:

Zdroj: habr.com