Ziel
Wenn wir uns auf Git festlegen, erwähnen wir im Kommentar eine Aufgabe von Jira namentlich, woraufhin zwei Dinge passieren:
- In GitLab wird der Name des Problems zu einem aktiven Link dazu in Jira
- In Jira wird der Aufgabe ein Kommentar mit Links zum Commit und dem Benutzer, der ihn erstellt hat, sowie der Erwähnungstext selbst hinzugefügt
Einstellung
- Wir benötigen einen Jira-Benutzer mit Schreibrechten. Sie können ein vorhandenes verwenden. Beachten Sie jedoch, dass alle Kommentare in Jira bei der Erwähnung von Aufgaben aus dem Git im Namen dieses Benutzers erfolgen. Daher ist es besser, ein neues zu erstellen, es beispielsweise GitLab zu nennen und hinzuzufügen zu Jira mit Schreibrechten für alle Ihre Projekte.
- Wir benötigen einen GitLab-Benutzer mit Administratorrechten in jedem der Projekte, die wir verbinden. Für jedes Projekt wird die Integration separat konfiguriert.
- Öffnen Sie in GitLab das Projekt und gehen Sie zu Einstellungen -> Integration. Scrollen Sie nach unten und sehen Sie Projektleistungen mit einer langen Liste an Diensten, die verbunden werden können.
- Wir finden Jira in dieser Liste, ein Formular erscheint
- Einen Haken machen Aktivesum den Link zu aktivieren.
- Wie Sie dem Formular entnehmen können, können Sie das gewünschte Verhalten für Commits und Merge-Anfragen separat konfigurieren.
- Eingeben Web-URL Ihr Unternehmen in Jira, zum Beispiel „https://companyname.atlassian.net“
- Jira-API-URL – Wird ausgefüllt, wenn Sie eine andere Jira-Instanz haben. Der Standardwert lautet Web-URL.
- Felder Benutzername / E-Mail и 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 Benutzers ein, unter dessen Namen die Kommentare hinzugefügt werden. Im Fall von Jira Cloud hinterlegen Sie eine E-Mail und einen Token, den Sie erhalten können .
- Feld Übergangs-ID(s). Wenn Sie beispielsweise möchten, dass eine Aufgabe beim Erwähnen automatisch geschlossen wird, müssen Sie in diesem Feld die ID des Übergangs in den geschlossenen Zustand eingeben. Diese ID kann über die API abgerufen werden:
https://companyname.atlassian.net/rest/api/2/issue/ISSUENAME-123/transitionsDabei ist ISSUENAME-123 der Name einer Aufgabe im gewünschten Status. Sie erhalten JSON mit dem Transitions-Array, aus dem Sie die gewünschte ID entnehmen können.
Als Ergebnis, GitLab's Einstellungen -> Integration Jira hat jetzt einen grünen Indikator:
und das Element erscheint im Projektmenü Jira, was zum entsprechenden Projekt in Jira führt:
Использование:
Wenn wir einen Kommentar zu einem Commit schreiben (unabhängig davon, welches Tool wir zum Arbeiten mit Git verwenden), können wir den Namen der Aufgaben in Textform hinzufügen (ohne Anführungszeichen oder Sonderzeichen wie @).
bugfix XPROJECT-123, XPROJECT-124Infolgedessen wird ein Kommentar zur entsprechenden Aufgabe angezeigt:
und ein aktiver Link erscheint im Gitlab:
Source: habr.com