Mål
Når vi gjør et commit i git, nevner vi et oppdrag fra Jira med navnet i kommentaren, hvoretter to ting skjer:
- i GitLab blir oppgave-navnet til en aktiv lenke til den i Jira
- i Jira legges det til en kommentar på oppgaven med lenker til commit og brukeren som utførte det, i tillegg til teksten med omtalen
Konfigurasjon
- Vi trenger en Jira-bruker med skrivetilgang. Vi kan bruke en eksisterende, men det er viktig å huske at alle kommentarer i Jira ved omtale av oppgaver fra git vil komme fra denne brukeren, så det er best å opprette en ny, for eksempel kalt GitLab, og legge til i Jira med skrivetilgang i alle prosjektene dine.
- Vi trenger en GitLab-bruker med administratorrettigheter i hvert av prosjektene vi skal koble til. For hvert prosjekt konfigureres integrasjonen separat.
- I GitLab åpner vi prosjektet, går til Innstillinger -> Integrasjoner. Vi ruller ned, ser Prosjekttjenester med en lang liste over tjenester som kan kobles til.
- Vi finner Jira i denne listen, og et skjema dukker opp

- Setter avkrysningsruten Aktiv, for å aktivere forbindelsen.
- Som det fremgår av skjemaet, kan vi konfigurere ønsket atferd for commits og merge-forespørselen særskilt.
- Vi skriver inn Web-URL-en til ditt selskap i Jira, for eksempel 'https://companyname.atlassian.net'
- Jira API-url — fylles ut hvis du har en annen instans av Jira, som standard brukes verdien Web-URL-en.
- Feltene Brukernavn/E-post og Passord/Tokenn fylles ut avhengig av om du bruker Jira Server eller Jira Cloud. I tilfelle av Jira Server skriver du inn brukernavn og passord til brukeren som kommentarene skal legges til fra. I tilfelle Jira Cloud skriver du inn e-post og token som du kan få .
- Felt Overgangs-ID(er). Hvis du for eksempel ønsker at oppgaven automatisk skal lukkes når den blir nevnt, må du oppgi ID-en for overgangen til statusen ''lukket''. Denne ID-en kan hentes fra API-en:
https://companyname.atlassian.net/rest/api/2/issue/ISSUENAME-123/transitionshvor ISSUENAME-123 er navnet på en hvilken som helst oppgave i ønsket tilstand. Du får JSON med en matrise av overganger, hvorfra du kan ta den nødvendige ID-en.
Som et resultat, i GitLab, Innstillinger -> Integrasjoner Jira har nå en grønn indikator:

og i prosjektmenyen vil det komme et punkt Jira, som fører til det aktuelle prosjektet i Jira:
Bruk:
Når vi skriver en kommentar til commit (uansett hvilket verktøy vi bruker for å jobbe med git), kan vi legge til navnet på oppgavene i tekstformat (uten anførselstegn eller spesialtegn som @)
bugfix XPROJECT-123, XPROJECT-124Som vil føre til at kommentaren faller til den relevante oppgaven:

og det vil dukke opp en aktiv lenke i GitLab:

Kilde: habr.com



