Linear verbinden

Verbinden Sie Linear, damit Ihre Automatisierungen automatisch Issues anlegen, kommentieren oder aktualisieren können — ein Zertifikat, das bald abläuft, ein Monitor, der ausgefallen ist, eine Domain vor der Verlängerung — abgelegt beim richtigen Team, ohne dass jemand Details manuell übertragen muss.

Überblick

• Linear lässt sich entweder mit einem Klick (OAuth) oder mit einem API-Schlüssel verbinden.
• Nach der Verbindung können Ihre Automatisierungen Issues erstellen, kommentieren und deren Status ändern.
• Issues landen beim richtigen Team, mit den Details dessen, was die Automatisierung ausgelöst hat, bereits ausgefüllt.

Ihren Workspace verbinden

1. Gehen Sie zu Einstellungen, dann Integrationen.
2. Suchen Sie Linear und klicken Sie darauf.
3. Bestätigen Sie den Workspace, wenn Linear danach fragt.
4. Sie landen wieder in InfraNest, bereits verbunden — nichts zu kopieren.

NoteWenn die Schaltfläche „Verbinden“ ausgegraut ist, hat Ihr InfraNest-Administrator noch keine Linear-App registriert. Verwenden Sie stattdessen einen API-Schlüssel — dieser funktioniert nach der Verbindung genauso.

Mit einem API-Schlüssel verbinden

1. Öffnen Sie in Linear Settings → Account → Security & Access.
2. Erstellen Sie unter Personal API keys einen Schlüssel. Geben Sie ihm Read- und Write-Zugriff.
3. Kopieren Sie den Schlüssel — Linear zeigt ihn nur einmal an.
4. Gehen Sie in InfraNest zu Einstellungen → Integrationen → Linear, fügen Sie den Schlüssel ein und klicken Sie auf Speichern.

InfraNest prüft den Schlüssel sofort und zeigt den Workspace an, zu dem er gehört, damit Sie bestätigen können, dass Sie den richtigen verbunden haben.

WarningEin Schlüssel kann auf bestimmte Teams beschränkt sein. Wenn Sie ihn einschränken, stellen Sie sicher, dass er das Team enthält, in dem Sie Issues anlegen möchten — ein Schlüssel, der dieses ausschließt, lässt sich problemlos verbinden und schlägt erst fehl, wenn eine Automatisierung ausgeführt wird.

Der Schlüssel ist an die Person gebunden, die ihn erstellt hat. Verlässt diese Person das Team, funktioniert der Schlüssel nicht mehr — für eine Verbindung, auf die sich das ganze Team verlässt, ist der Schlüssel eines Admins oder die Verbindung mit einem Klick die sicherere Wahl.

Issues aus einer Automatisierung erstellen

1. Erstellen Sie eine Regel wie gewohnt.
2. Wählen Sie Create Linear issue als Aktion.
3. Legen Sie Team fest — beginnen Sie zu tippen und wählen Sie aus Ihren Linear-Teams, oder geben Sie einen Team-Key wie ENG ein.
4. Füllen Sie Title und Description aus — reiner Text, und Sie können Werte aus dem Auslöser der Regel einfügen, sodass das Issue direkt den Domainnamen oder Monitor enthält.
5. (Optional) Legen Sie Status fest — lassen Sie es leer, und Linear platziert das Issue dort, wo neue Issues dieses Teams normalerweise landen.
6. (Optional) Legen Sie Project und Assignee fest — Projekte werden für das gewählte Team angezeigt; als Assignee kann jede Person in Ihrem Workspace gewählt werden, oder geben Sie stattdessen deren E-Mail-Adresse ein.
7. (Optional) Legen Sie Priority fest, anhand von Linears eigener Skala (1 ist Urgent, 4 ist Low).

Das von der Regel erstellte Issue steht späteren Schritten in derselben Regel zur Verfügung, sodass Sie den Link direkt nach dem Erstellen an Slack posten können — oder es kommentieren oder schließen, mit den unten stehenden Aktionen.

Ein Issue kommentieren oder den Status ändern

1. Fügen Sie Comment on Linear issue oder Set Linear issue status als Schritt in Ihrer Regel hinzu.
2. Geben Sie an, um welches Issue es geht — nennen Sie die Kennung, die Sie in Linear sehen (z. B. ENG-14), oder beziehen Sie sich auf das Issue, das ein vorheriger Schritt in derselben Regel erstellt hat (die Auswahl vorheriger Werte bietet dies an).
3. Für einen Kommentar schreiben Sie den Text — nützlich als Gegenstück einer Regel, die Issues öffnet: Der Monitor erholt sich, und das Issue vermerkt dies.
4. Für eine Statusänderung geben Sie den Namen genau so ein, wie er im Board dieses Teams erscheint („In Progress“, „Done“). Status gehören zu einem Team, und das Team ergibt sich aus dem Issue selbst, daher gibt es hier keine Auswahlliste.

Fehlerbehebung

„Linear rejected the key“ — der Schlüssel ist falsch, abgelaufen oder wurde ohne Write-Zugriff erstellt. Erstellen Sie einen neuen und fügen Sie ihn erneut ein.

Die Teamliste ist leer. Wählen Sie zuerst eine Verbindung oben in der Aktion. Ist sie weiterhin leer, ist der Schlüssel wahrscheinlich auf Teams beschränkt, die er nicht sehen kann — prüfen Sie dessen Team-Einschränkungen in Linear.

Die Statusliste ist leer. Status gehören zu einem Team, wählen Sie also zuerst das Team. Stammt das Team aus dem Auslöser, statt ausgewählt zu werden, bleibt die Liste leer — Sie können den Statusnamen stattdessen eingeben, und die Automatisierung löst ihn bei der Ausführung auf.

Die Projektliste ist leer. Projekte gehören zu Teams — wählen Sie zuerst das Team, dann werden nur dessen Projekte angeboten.

Eine Automatisierung ist mit „Linear rejected the request“ fehlgeschlagen. Öffnen Sie den Lauf unter Automatisierungen → Verlauf; der Schritt zeigt, was Linear gemeldet hat. Die übliche Ursache ist ein Team, das der Schlüssel nicht erreichen kann, oder ein Statusname, der bei diesem Team nicht existiert.

„No Linear user matches…“ — zwei Personen können denselben Anzeigenamen haben, daher gleicht die Automatisierung zuerst anhand der E-Mail-Adresse ab. Verwenden Sie die Adresse, um sicherzustellen, welche Person gemeint ist.