Syftet
NÀr vi gör en commit i git nÀmner vi en uppgift frÄn Jira i kommentaren vid namn, efter vilket tvÄ saker hÀnder:
- i GitLab blir uppgiftens namn en aktiv lÀnk till den i Jira
- i Jira lÀggs en kommentar till uppgiften med lÀnkar till committen och anvÀndaren som utförde den, samt sjÀlva texten av omnÀmnandet
InstÀllning
- Vi behöver en Jira-anvÀndare med rÀttighetsnivÄ write. Vi kan anvÀnda en befintlig, men kom ihÄg att alla kommentarer i Jira vid nÀmning av uppgifter frÄn git kommer att skickas frÄn denna anvÀndares namn, sÄ det Àr bÀttre att skapa en ny anvÀndare, kalla den till exempel GitLab, och ge den write-rÀttigheter i alla dina projekt i Jira.
- Vi behöver en GitLab-anvÀndare med administratörsrÀttigheter i varje projekt som vi kommer att koppla samman. För varje projekt konfigureras integrationen separat.
- I GitLab öppnar vi projektet, gÄr till InstÀllningar -> Integrationer. Scrolla ner, vi ser ProjektstjÀnster med en lÄng lista över tjÀnster som gÄr att koppla till.
- Sök efter Jira i denna lista, ett formulÀr dyker upp

- SÀtt kryss Aktiv, för att aktivera kopplingen.
- Som framgÄr av formulÀret kan man stÀlla in önskat beteende för commits och merge-förfrÄgningar separat.
- Vi anger Webbadress till ditt företags Jira, till exempel 'https://companyname.atlassian.net'
- Jira API-url â fylls i om du har en annan instans av Jira, standardvĂ€rdet kommer att anvĂ€ndas Webbadress.
- FÀlt AnvÀndarnamn/E-post och Lösenord/Token fylls i beroende pÄ om du anvÀnder Jira Server eller Jira Cloud. I fallet med Jira Server anger du anvÀndarnamn och lösenord för den anvÀndare som kommentarer kommer att lÀggas till frÄn. I fallet med Jira Cloud anger du e-post och token, vilken kan fÄs .
- FĂ€ltet ĂvergĂ„ngs-ID(n). Om du vill att uppgiften automatiskt ska stĂ€ngas vid omnĂ€mnandet behöver du ange övergĂ„ngs-ID:t för statusen closed i detta fĂ€lt. Detta ID kan fĂ„s via API:
https://companyname.atlassian.net/rest/api/2/issue/ISSUENAME-123/transitionsdÀr ISSUENAME-123 Àr namnet pÄ nÄgon uppgift i önskat tillstÄnd. Du kommer att fÄ JSON med en array av övergÄngar, frÄn vilken du kan ta det nödvÀndiga id:t.
Som ett resultat i GitLab har InstÀllningar -> Integrationer Jira nu en grön indikator:

och i projektmenyn kommer det att dyka upp en punkt Jira, som leder till det motsvarande projektet i Jira:
AnvÀndning:
NÀr vi skriver en kommentar till en commit (oavsett vilket verktyg vi anvÀnder för att arbeta med git) kan vi lÀgga till uppgiftsnamnen i textform (utan citat eller nÄgra specialtecken som @)
bugfix XPROJECT-123, XPROJECT-124som kommentaren kommer att falla pÄ den relevanta uppgiften:

och en aktiv lÀnk kommer att visas i GitLab:

KĂ€lla: habr.com



