Formålet
Når vi laver en commit i git, nævner vi en opgave fra Jira med navn i kommentaren, hvorefter der sker to ting:
- i GitLab bliver opgaven til et aktivt link til den i Jira
- i Jira tilføjes der en kommentar til opgaven med links til committet og brugeren, der udførte det, samt selve teksthenvisningen
Indstillinger
- Vi har brug for en Jira-bruger med skriveadgang. Vi kan bruge en eksisterende, men det er vigtigt at huske, at alle kommentarer i Jira, når der henvises til opgaver fra git, vil komme fra denne bruger, så det er bedre at oprette en ny, kalde den f.eks. GitLab og tilføje den til Jira med skriveadgang til alle dine projekter.
- Vi har brug for en GitLab-bruger med administratorrettigheder i hvert af de projekter, vi vil tilslutte. Integrationen konfigureres særskilt for hvert projekt.
- I GitLab åbner vi projektet, går ind i Indstillinger -> Integrationer. Rul ned, og vi ser Projekttjenester med en lang liste af tjenester, der kan tilsluttes.
- Vi finder Jira i denne liste, og der vises en formular

- Vi sætter et flueben Aktiv, for at aktivere forbindelsen.
- Som det fremgår af formularen, kan man konfigurere specifik adfærd for commits og merge-requests.
- Vi indtaster Web-URL til din virksomhed i Jira, f.eks. ‘https://companyname.atlassian.net’
- Jira API URL — udfyldes, hvis du har en anden instans af Jira, standardværdien vil blive brugt Web-URL.
- Felter Brugernavn/E-mail og Adgangskode/Tokener udfyldes afhængigt af, om du bruger Jira Server eller Jira Cloud. I tilfælde af Jira Server indtaster du brugernavnet og adgangskoden for den bruger, som kommentarerne skal tilføjes fra. I tilfælde af Jira Cloud angiver du e-mail og token, som kan fås .
- Felt Overgang ID(er). Hvis du ønsker, at en opgave automatisk skal lukkes, når den nævnes, skal du skrive overgangs-ID'et til tilstanden lukket i dette felt. Du kan få dette ID via API:
https://companyname.atlassian.net/rest/api/2/issue/ISSUENAME-123/transitionshvor ISSUENAME-123 er navnet på en opgave i den ønskede tilstand. Du vil få en JSON med et array af overgange, hvorfra du kan tage det nødvendige id.
Som et resultat vil der i GitLab i Indstillinger -> Integrationer Jira nu være en grøn indikator:

og i projektmenuen vil der være et punkt Jira, der fører til det tilsvarende projekt i Jira:
Brug:
Når vi skriver en kommentar til en commit (uanset hvilket værktøj vi bruger til at arbejde med git), kan vi tilføje opgavenavne i tekstform (uden citationstegn eller specialtegn som @)
bugfix XPROJECT-123, XPROJECT-124Som følge af den relevante opgave vil der blive tilføjet en kommentar:

og der vil blive oprettet et aktivt link i GitLab:

Kilde: habr.com



