Jira verbinden

Verbinden Sie Jira, damit Ihre Automatisierungen automatisch Tickets erstellen, aktualisieren und verknüpfen können — zum Beispiel wenn ein Zertifikat bald abläuft, ein Monitor ausfällt oder eine Domain-Verlängerung ansteht. Dieser Artikel richtet sich an alle, die die Jira-Verbindung in InfraNest einrichten oder Probleme damit beheben.

Übersicht

• Automatisierungen können Jira-Tickets erstellen, kommentieren, ihren Status ändern und sie mit dem betreffenden Zertifikat, Monitor oder der Domain verknüpfen.
• Kein manuelles Übertragen von Details mehr — das Ticket kommt bereits ausgefüllt an.
• Funktioniert mit Jira Cloud (eine something.atlassian.net-Adresse). Jira Data Center und Server werden nicht unterstützt.

Ihre Site verbinden

1. Gehen Sie zu Einstellungen → Integrationen und suchen Sie Jira.
2. Klicken Sie auf Connect with Jira.
3. Bestätigen Sie den Zugriff, wenn Atlassian danach fragt. Sie landen bereits verbunden zurück in InfraNest — nichts zu kopieren.
4. Wenn Sie mehr als eine Atlassian-Site haben, wählen Sie aus, welche verwendet werden soll. Bei genau einer wählt InfraNest sie automatisch für Sie aus.

NoteWenn Connect with Jira ausgegraut ist, hat Ihr InfraNest-Administrator noch keine Jira-App registriert. Verwenden Sie stattdessen ein API-Token — es funktioniert nach der Verbindung genauso.

Mit einem API-Token verbinden

1. Öffnen Sie in Atlassian Account settings → Security → API tokens und erstellen Sie ein Token.
2. Kopieren Sie es — Atlassian zeigt es nur einmal an.
3. Gehen Sie in InfraNest zu Einstellungen → Integrationen → Jira und füllen Sie drei Felder aus:
   • Jira URL — zum Beispiel acme.atlassian.net. Das Einfügen der vollständigen Adresse einer beliebigen Jira-Seite funktioniert ebenfalls.
   • Atlassian account email — die Adresse, mit der Sie sich anmelden.
   • API token — das gerade kopierte Token.
4. InfraNest prüft die Verbindung sofort und zeigt an, zu wem das Konto gehört, damit Sie bestätigen können, dass Sie das richtige verbunden haben.

TipVerwenden Sie die E-Mail-Adresse, mit der Sie sich anmelden. Eine andere Adresse auf derselben Site wird abgelehnt, und der Fehler sieht dann eher nach einem ungültigen Token als nach einer falschen E-Mail aus.

Das Token handelt in Ihrem Namen und kann daher nur Tickets in Projekten erstellen, die Sie bereits sehen können. Es ist auch persönlich an Sie gebunden — wenn Sie das Unternehmen verlassen, funktioniert es nicht mehr. Für eine Verbindung, auf die sich das gesamte Team verlässt, ist das Token eines Administrators oder die Ein-Klick-Option Connect with Jira die sicherere Wahl.

Ein Ticket aus einer Automatisierung erstellen

1. Erstellen Sie eine Regel wie gewohnt und wählen Sie Create Jira issue als Aktion.
2. Füllen Sie Project aus — beginnen Sie zu tippen und wählen Sie aus Ihren Projekten, oder geben Sie einen Projektschlüssel wie OPS ein.
3. Wählen Sie Issue type — Task, Bug oder was auch immer Ihr Projekt sonst verwendet. Subtask-Typen werden nicht angeboten, da sie ein übergeordnetes Ticket benötigen.
4. Füllen Sie Summary und Description aus — reiner Text, wobei Sie Werte aus dem Auslöser der Regel einfügen können, sodass das Ticket bereits mit dem Domainnamen oder Monitor ankommt.
5. Legen Sie optional Assignee fest — beginnen Sie einen Namen oder eine E-Mail-Adresse einzugeben. Es werden nur Personen angeboten, die diesem Projekt tatsächlich zugewiesen werden können.
6. Legen Sie optional Priority und Labels fest — Labels dürfen keine Leerzeichen enthalten; verwenden Sie stattdessen einen Bindestrich.

Das von der Regel erstellte Ticket steht späteren Schritten in derselben Regel zur Verfügung, sodass Sie den Link direkt nach der Erstellung an Slack senden können — oder es kommentieren, verschieben oder verknüpfen, mit den unten stehenden Aktionen.

Kommentieren, Status ändern oder verknüpfen

Drei weitere Aktionen wirken auf ein bereits bestehendes Ticket. Alle fragen, welches Ticket gemeint ist: Geben Sie den in Jira angezeigten Schlüssel an (OPS-14), oder verweisen Sie auf das Ticket, das ein vorheriger Schritt in derselben Regel erstellt hat — die Auswahl früherer Werte bietet dies an.

1. Comment on Jira issue — fügt einen Kommentar hinzu. Nützlich als Gegenstück zu einer Regel, die Tickets erstellt: Der Monitor erholt sich, und das Ticket vermerkt dies.
2. Set Jira issue status — verschiebt das Ticket, sodass eine Regel, die Arbeit eröffnet hat, sie auch abschließen kann. Geben Sie den Status ein, in dem es enden soll („Done“), oder den Namen, den Ihr Workflow dem Schritt gibt („Close Issue“) — beides funktioniert.
3. Add Jira issue link — setzt im Links-Bereich des Tickets einen Link zurück zu dem betreffenden Zertifikat, Monitor oder der Domain. Ein erneutes Ausführen der Regel aktualisiert diesen Link, statt einen zweiten hinzuzufügen.

Fehlerbehebung

„Jira rejected the token“ — prüfen Sie alle drei Felder, nicht nur das Token. Die häufigste Ursache ist eine E-Mail-Adresse, die nicht mit der übereinstimmt, mit der Sie sich bei Atlassian anmelden.

„Your Atlassian account cannot use the Jira API“ — das Token ist gültig, aber das Konto darf die API auf dieser Site nicht verwenden. Ihr Jira-Administrator kann das ändern.

„This Jira connection has no site selected yet“ — Sie haben mehr als eine Atlassian-Site autorisiert und noch keine ausgewählt. Öffnen Sie die Verbindung unter Einstellungen → Integrationen und wählen Sie sie aus.

Die Projektliste ist leer. Wählen Sie zuerst oben in der Aktion eine Verbindung aus. Bleibt sie leer, kann das Konto möglicherweise keine Projekte sehen.

Die Liste für Issue-Typ oder Assignee ist leer. Beide gehören zu einem Projekt, wählen Sie also zuerst das Projekt aus. Wenn das Projekt aus dem Auslöser stammt, statt ausgewählt zu werden, bleiben die Listen leer, und Sie können die Werte stattdessen eingeben — die Automatisierung ermittelt sie zur Laufzeit.

Eine Automatisierung ist fehlgeschlagen mit der Meldung, dass ein Feld erforderlich ist. Manche Projekte machen auf ihrem Erstellungsbildschirm zusätzliche Felder verpflichtend, während die Jira-Aktion von InfraNest eine feste Auswahl anbietet. Der Fehler nennt das von Jira geforderte Feld — öffnen Sie den Lauf unter Automatisierungen → History, um es zu sehen. Machen Sie das Feld entweder in Jira optional, oder erstellen Sie das Ticket in einem Projekt, das es nicht verlangt.

„Jira offers no transitions on OPS-14 right now.“ Jira erlaubt nur die Schritte, die der Workflow vom aktuellen Status des Tickets aus zulässt. Ein bereits als Done markiertes Ticket kann nicht erneut auf Done gesetzt werden. Die Meldung listet auf, was mit dem Ticket möglich ist — wählen Sie daraus.

„No transition named … is available.“ Ihr Workflow nennt diesen Schritt anders. Die Meldung listet die verfügbaren Optionen auf; verwenden Sie diejenige, die zum gewünschten Status führt.