GitHub¶

Verwenden Sie die GitHub-Integration, um GitHub-Issues direkt in Zammad-Tickets zu verfolgen. Fügen Sie Hyperlinks zu Issues hinzu und erhalten Sie eine Live-Zusammenfassung von Metadaten wie Status (offen/geschlossen), zugewiesene Personen, Labels und mehr.

Bitte beachten Sie, dass unsere GitHub-Integration keine Pull-Requests unterstützt.

Einrichtung¶

Erstellen Sie in Ihren GitHub-Einstellungen ein neues API-Token unter Developer settings > Personal access tokens > Generate new token. Lassen Sie den Abschnitt Scopes leer.

Erstellen Sie einen neuen API-Schlüssel ohne Scopes/Berechtigungen.¶

Hinweis

🔒 Funktioniert das auch für private Repos?

Nein. Um private Repos zu verknüpfen, verwenden Sie stattdessen den repo Scope. Denken Sie daran, dass das resultierende Token viele Berechtigungen beinhaltet, die es eigentlich nicht braucht. Das stellt ein Sicherheitsrisiko dar, falls Ihr Token in die falschen Hände geraten sollte.

Leider ist dies aufgrund der Art und Weise, wie die OAuth-Token-Bereiche von GitHub eingerichtet sind, die einzige Möglichkeit, Issues in privaten Repos zu verknüpfen.
Geben Sie Ihr neues API-Token in Zammad ein und aktivieren Sie die GitHub-Integration.

Verwenden Sie den Standard-API-Endpunkt (https://api.github.com/graphql), es sei denn, Sie verwenden GitHub Enterprise Server.

Sobald Sie das erledigt haben wird eine neue Registerkarte für GitHub-Issues im Ticketbereich angezeigt. 🎉

Fehlerbehebung¶

Die Token-Verifizierung dauert sehr lange

Leichte Verzögerungen sind normal (<2 Min.), insbesondere bei stark belasteten Systemen.

Administratoren von selbst gehosteten Instanzen sollten Ihre Netzwerkeinstellungen prüfen und sicherstellen, dass Ihr Zammad-Server api.github.com erreichen kann.

Ich habe die Seite neu geladen, und jetzt ist das API-Token verschwunden

Dies kann darauf hindeuten, dass Zammad noch dabei ist, Ihr API-Token zu verifizieren. Versuchen Sie, die Seite in ein paar Minuten noch einmal zu laden.