🥇Integration von Jira mit GitLab

Ziel

Wenn wir beim Commit in git eine Jira-Aufgabe mit ihrem Namen im Kommentar erwähnen, passieren zwei Dinge:

Im GitLab wird der Titel der Aufgabe zu einem aktiven Link zu dieser in Jira

In Jira wird ein Kommentar zur Aufgabe hinzugefügt, der Links zum Commit und zum Benutzer enthält, der es durchgeführt hat, sowie den Text der Erwähnung

Konfiguration

Wir benötigen einen Jira-Benutzer mit Schreibrechten. Es kann ein vorhandener Benutzer verwendet werden, jedoch sollte beachtet werden, dass alle Kommentare in Jira, bei der Erwähnung von Aufgaben aus git, im Namen dieses Benutzers erstellt werden. Daher ist es besser, einen neuen Benutzer zu erstellen, ihn beispielsweise GitLab zu nennen und mit Schreibrechten zu all Ihren Projekten in Jira hinzuzufügen.
Wir benötigen einen GitLab-Benutzer mit Administrationsrechten in jedem der Projekte, die wir verbinden wollen. Die Integration wird für jedes Projekt separat konfiguriert.
Öffnen Sie im GitLab das Projekt und gehen Sie zu Einstellungen -> Integrationen. Scrollen Sie nach unten und sehen Sie Projektservices , in einer langen Liste von Diensten, die angebunden werden können.
Suchen Sie in dieser Liste nach Jira, ein Formular erscheint
- Setzen Sie ein Häkchen Active, um die Verbindung zu aktivieren.
- Wie aus dem Formular hervorgeht, kann das gewünschte Verhalten für Commits und Merge-Requests separat konfiguriert werden.
- Einfügen Web-URL Ihrer Firma in Jira, z.B. ‘https://companyname.atlassian.net’
- Jira API-URL — wird ausgefüllt, wenn Sie eine andere Jira-Instanz haben, standardmäßig wird der Wert verwendet Web-URL.
- Felder Benutzername/E-Mail und Passwort/Token werden entsprechend ausgefüllt, ob Sie Jira Server oder Jira Cloud verwenden. Bei Jira Server geben Sie den Benutzernamen und das Passwort des Nutzers ein, in dessen Namen Kommentare hinzugefügt werden. Bei Jira Cloud tragen Sie die E-Mail und den Token ein, den Sie erhalten können hier.
- Feld Übergangs-ID(s). Wenn Sie möchten, dass beim Erwähnen einer Aufgabe diese automatisch geschlossen wird, müssen Sie die ID für den Übergang in den Status 'closed' in dieses Feld eintragen. Diese ID erhalten Sie über die API:
```
https://companyname.atlassian.net/rest/api/2/issue/ISSUENAME-123/transitions 
```
  wo ISSUENAME-123 der Name einer Aufgabe im gewünschten Status ist. Sie erhalten ein JSON mit einem Array von Übergängen, aus dem Sie die benötigte ID entnehmen können.
In GitLab wurde Einstellungen -> Integrationen Jira hat jetzt einen grünen Indikator:

und im Projektmenü erscheint der Punkt Jira, der zum entsprechenden Projekt in Jira führt:

Verwendung:

Wenn wir einen Kommentar zu einem Commit schreiben (es spielt keine Rolle, welches Tool wir dafür verwenden, um mit git zu arbeiten), können wir die Bezeichnungen der Aufgaben in Textform hinzufügen (ohne Anführungszeichen oder spezielle Symbole wie @)