Ziel
Wenn wir in Git committen, erwähnen wir im Kommentar eine Jira-Aufgabe nach ihrem Namen, woraufhin zwei Dinge passieren:
- im GitLab wird der Name der Aufgabe in einen aktiven Link zu ihr in Jira umgewandelt
- in Jira wird der Aufgabe ein Kommentar mit Links zum Commit und dem Benutzer, der es ausgeführt hat, hinzugefügt, sowie der Text der Erwähnung selbst
Einstellungen
- Wir benötigen einen Jira-Benutzer mit Schreibrechten. Wir können einen vorhandenen Benutzer verwenden, es ist jedoch wichtig zu beachten, dass alle Kommentare in Jira beim Erwähnen von Aufgaben aus Git im Namen dieses Benutzers eingetragen werden. Daher ist es besser, einen neuen Benutzer zu erstellen, ihn zum Beispiel GitLab zu nennen und ihm in Jira Schreibrechte für alle Ihre Projekte zu geben.
- Wir benötigen einen GitLab-Benutzer mit Administratorrechten in jedem der Projekte, die wir anschließen werden. Die Integration wird für jedes Projekt separat konfiguriert.
- In GitLab öffnen wir das Projekt, gehen zu Einstellungen -> Integrationen. Wir scrollen nach unten und sehen Projektservices mit einer langen Liste der Dienste, die angeschlossen werden können.
- Wir finden in dieser Liste Jira, daraufhin erscheint ein Formular

- Wir setzen ein Häkchen Active, um die Verbindung zu aktivieren.
- Wie aus dem Formular ersichtlich ist, können wir das gewünschte Verhalten für Commits und Merge-Anfragen separat konfigurieren.
- Wir geben ein Web-URL Ihres Unternehmens in Jira an, zum Beispiel ‘https://companyname.atlassian.net’
- Jira API-URL wird ausgefüllt, wenn Sie eine andere Instanz von Jira 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. Im Fall von Jira Server geben Sie den Benutzernamen und das Passwort des Benutzers ein, im Namen dessen Kommentare hinzugefügt werden. Bei Jira Cloud tragen Sie die E-Mail und das Token ein, das Sie erhalten können .
- Feld Übergangs-ID(s). Wenn Sie möchten, dass eine Aufgabe beim Erwähnen automatisch geschlossen wird, müssen Sie in diesem Feld die ID des Übergangs zum Zustand "geschlossen" angeben. Diese ID kann über die API erhalten werden:
https://companyname.atlassian.net/rest/api/2/issue/ISSUENAME-123/transitionswobei ISSUENAME-123 der Name einer beliebigen Aufgabe im gewünschten Zustand ist. Sie erhalten ein JSON mit einem Array von Übergängen, aus dem Sie die benötigte ID entnehmen können.
Infolgedessen hat Jira in GitLab jetzt einen grünen Indikator: Einstellungen -> Integrationen und im Projektmenü erscheint der Punkt

Jira , der zu dem entsprechenden Projekt in Jira führt:Verwendung:
Wenn wir einen Kommentar zu einem Commit schreiben (unabhängig davon, welches Tool wir dabei für die Arbeit mit Git verwenden), können wir den Namen der Aufgaben textuell (ohne Anführungszeichen oder spezielle Symbole wie @) hinzufügen.
Wenn wir einen Kommentar zu einem Commit schreiben (unabhängig von dem Tool, das wir dafür verwenden, um mit git zu arbeiten), können wir die Namen der Aufgaben im Textformat (ohne Anführungszeichen oder spezielle Symbole wie @) hinzufügen.
Bugfix XPROJECT-123, XPROJECT-124Infolge wird ein Kommentar zur entsprechenden Aufgabe hinzugefügt:

und im GitLab erscheint ein aktiver Link:

Quelle: habr.com



