Integratie van Jira met GitLab

Doel

Bij een commit in git vermelden we in de opmerking een taak uit Jira op naam, waarna er twee dingen gebeuren:

• in GitLab verandert de naam van de taak in een actieve link naar die in Jira

• in Jira wordt aan de taak een opmerking toegevoegd met links naar de commit en de gebruiker die deze heeft uitgevoerd, evenals de tekst van de verwijzing.

Instellingen

1. We hebben een Jira-gebruiker nodig met write-rechten. Je kunt een bestaande gebruiker gebruiken, maar het is belangrijk om te onthouden dat alle opmerkingen in Jira wanneer taken uit git worden genoemd, zullen komen van deze gebruiker. Het is dus beter om een nieuwe aan te maken, laten we hem bijvoorbeeld GitLab noemen, en deze in Jira toe te voegen met write-rechten voor al je projecten.
2. We hebben een GitLab-gebruiker nodig met beheerdersrechten in elk van de projecten die we gaan koppelen. Voor elk project wordt de integratie afzonderlijk ingesteld.
3. In GitLab openen we het project en gaan naar Instellingen -> Integraties. Scroll naar beneden, we zien Projectdiensten met een lange lijst van services die kunnen worden aangesloten.
   
4. We zoeken in deze lijst naar Jira, er verschijnt een formulier
   
   
   • We zetten een vinkje Actief, om de verbinding te activeren.
   • Zoals uit het formulier blijkt, kan het gedrag van commits en merge-verzoeken afzonderlijk worden ingesteld.
   • We voeren in Web-URL van jouw bedrijf in Jira, bijvoorbeeld ‘https://companyname.atlassian.net’
   • Jira API-URL — wordt ingevuld als je een andere Jira-instantie hebt, standaard wordt de waarde gebruikt Web-URL.
   • Velden Gebruikersnaam/E-mail en Wachtwoord/Token worden respectievelijk ingevuld afhankelijk van of je Jira Server of Jira Cloud gebruikt. In het geval van Jira Server voer je de gebruikersnaam en het wachtwoord in van de gebruiker van wie de opmerkingen worden toegevoegd. In het geval van Jira Cloud vul je het e-mailadres en de token in, die je kunt verkrijgen. hier.
   • Veld Overgang ID(s). Als je wilt dat de taak automatisch wordt gesloten bij vermelding, moet je in dit veld het ID van de overgang naar de status gesloten invoeren. Dit ID kan je ophalen via de API:

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

     waar ISSUENAME-123 de naam is van een taak in de juiste staat. Je krijgt een JSON met een array van overgangen, waaruit je het juiste id kunt nemen.

   Als gevolg hiervan heeft Jira in GitLab nu een groene indicator: Instellingen -> Integraties en zal er in het projectmenu een item verschijnen

   
   
   Jira , dat naar het bijbehorende project in Jira leidt:Gebruik:

   

Wanneer we een opmerking aan een commit schrijven (ongeacht welke tool we hiervoor gebruiken om met git te werken), kunnen we de naam van de taken in tekstvorm toevoegen (zonder aanhalingstekens of speciale symbolen zoals @).

Wanneer we een opmerking bij een commit schrijven (onbelangrijk welke tool we gebruiken om met git te werken), kunnen we de taaknamen in tekstvorm toevoegen (zonder aanhalingstekens of speciale symbolen zoals @)

bugfix XPROJECT-123, XPROJECT-124

als resultaat valt er een opmerking bij de bijbehorende taak:

en in GitLab verschijnt er een actieve link:

Bron: habr.com