GitHub Issues verbinden: Schritt-für-Schritt-Anleitung
Erstellt für jeden fehlgeschlagenen Test ein GitHub-Issue, kommentiert es bei erneutem Fehlschlagen und schließt es, sobald der Test fehlerfrei besteht. GitHub akzeptiert keine Datei-Uploads, daher wird im Issue der Ordner mit den Nachweisen genannt, statt den Screenshot anzuhängen. Diese Anleitung führt Sie von Anfang an bis zur überprüften Verbindung und nennt mögliche Fehler samt Ursache und Lösung.
Zuletzt aktualisiert:
Halten Sie Ihre Zugangsdaten geheim. Fügen Sie niemals ein Token, einen Schlüssel, ein Passwort oder eine Webhook-URL in einen Chat ein. Geben Sie diese ausschließlich unter Studio → Einstellungen → Integrationen ein. Dort werden sie in der .env-Datei Ihres Arbeitsbereichs gespeichert und als Punkte angezeigt. Das gilt auch für KI-Assistenten: Sie können Sie durch diese Anleitung führen, benötigen aber niemals Ihr Token.
Was Sie benötigen
- Ein GitHub-Konto, das Issues im Repository erstellen darf (ein Projektmitarbeiter oder der Eigentümer).
- Ein Repository mit aktivierten Issues (Repository-Einstellungen → Funktionen → Issues).
- Ein differenziertes persönliches Zugriffstoken mit Issues → Lesen und Schreiben für dieses Repository oder ein klassisches Token mit dem Berechtigungsumfang repo.
Zugangsdaten beschaffen
- Öffnen Sie https://github.com/settings/personal-access-tokens/new (ein differenziertes Token).
- Geben Sie einen Namen und ein Ablaufdatum an und wählen Sie unter Repository-Zugriff die Option Nur ausgewählte Repositorys, dann das Repository, in dem die Issues erstellt werden sollen.
- Setzen Sie unter Berechtigungen → Repository-Berechtigungen die Berechtigung Issues auf Lesen und Schreiben. Weitere Berechtigungen sind nicht erforderlich.
- Erstellen Sie das Token und kopieren Sie es sofort. GitHub zeigt es nur einmal an. Fügen Sie es ausschließlich im Studio ein (nächster Schritt).
Im Studio verbinden
- Öffnen Sie im Studio Einstellungen → Integrationen → GitHub Issues verbinden.
- Geben Sie bei Aufforderung das Token ein und klicken Sie auf Speichern & prüfen. Das Studio zeigt an, wem das Token gehört und auf wie viele Repositorys es zugreifen kann.
- Wählen Sie unter "Issues erstellen in" das Repository aus. Die Liste enthält nur Repositorys, auf die das Token zugreifen kann und bei denen Issues aktiviert sind.
- Aktivieren Sie
GITHUB_ISSUES_ENABLED.
Funktion überprüfen
- Verbindung prüfen zeigt "angemeldet als <you>" und "<owner/repo> akzeptiert Issues" an. Die Prüfung liest nur Daten; sie erstellt niemals ein Issue.
- Öffnen Sie Einstellungen → Integrationen → Tickets und klicken Sie beim GitHub-Ziel auf Testticket erstellen. Dadurch wird ein Issue mit dem Label nexus-test erstellt.
- Öffnen Sie es auf GitHub, überprüfen Sie das Label und schließen oder löschen Sie es anschließend.
Häufige Fehler
| Was Sie sehen | Ursache | Lösung |
|---|---|---|
| "GitHub hat das Token abgelehnt (401)" | Das Token ist falsch, abgelaufen, widerrufen oder unvollständig kopiert. | Erstellen Sie ein neues Token mit Issues → Lesen und Schreiben und speichern Sie es erneut. |
| HTTP 403 | Dem Token fehlt die Issues-Berechtigung, das Repository wurde dafür nicht ausgewählt oder das Anfragelimit ist erreicht. | Bearbeiten Sie das Token: Setzen Sie Issues auf Lesen und Schreiben und wählen Sie das Repository aus. Ist das Anfragelimit erreicht, warten Sie einige Minuten. |
| HTTP 404 | Das Repository existiert nicht, wurde umbenannt oder ist für das Token nicht sichtbar (private Repositorys müssen bei einem differenzierten Token ausgewählt werden). | Wählen Sie das Repository aus der Liste aus oder fügen Sie es zum Repository-Zugriff des Tokens hinzu. |
| HTTP 422 | GitHub hat ein Feld des Issues abgelehnt, meist eine zugewiesene Person, die kein Projektmitarbeiter ist, oder einen Titel oder ein Label, das GitHub nicht akzeptiert. | Entfernen Sie unter Einstellungen → Integrationen → Tickets die zugewiesene Person oder fügen Sie diese Person als Projektmitarbeiter hinzu. |
| "Bei <repo> sind Issues deaktiviert" | Die Issues-Funktion ist im Repository deaktiviert. | Aktivieren Sie im Repository Einstellungen → Funktionen → Issues oder wählen Sie ein anderes Repository. |
| "GitHub konnte nicht erreicht werden (…)" oder "hat nicht rechtzeitig geantwortet" | Dieser PC kann api.github.com nicht erreichen: wegen eines VPNs oder Proxys oder einer fehlenden Netzwerkverbindung. | Öffnen Sie github.com in einem Browser auf demselben PC und wiederholen Sie dann die Prüfung. |
| Alle Prüfungen sind erfolgreich, aber es erscheint kein Issue | GITHUB_ISSUES_ENABLED ist false; oder das Ergebnis war FLAKY oder umgebungsbedingt; oder es war ein Sandbox-Durchlauf; oder der Test hat bereits ein offenes Issue (bei erneutem Fehlschlagen wird stattdessen ein Kommentar hinzugefügt). | Aktivieren Sie GITHUB_ISSUES_ENABLED und überprüfen Sie die Verbindung mit Testticket erstellen. |
Konfigurationsschlüssel
| Schlüssel | Funktionsumfang | Gültiger Wert | So prüfen Sie ihn |
|---|---|---|---|
GITHUB_ISSUES_ENABLED | GitHub-Issues bei Fehlern erstellen | true oder false | Aktivieren Sie die Option nach erfolgreicher Prüfung mit Verbindung prüfen, und führen Sie dann Testticket erstellen aus. |
GITHUB_ISSUES_TOKEN | GitHub-Zugriffstoken (geheim, nur auf diesem Computer gespeichert) | Eine Zeile, keine Anführungszeichen, keine Leerzeichen | Verbindung prüfen: "Token abgelehnt" bedeutet, dass es falsch, abgelaufen oder widerrufen ist. |
GITHUB_ISSUES_REPO | GitHub-Repository für Issues | owner/repo, etwa acme/web | Wählen Sie es aus der Liste; das Studio speichert nur ein Repository, auf das das Token Zugriff hat und bei dem Issues aktiviert sind. |
Mehr: alle Integrationen, die Einstellungsanleitung, Fehlerbehebung. Weitere Anleitungen: Jira Cloud, Azure Boards, Slack, Microsoft Teams, Telegram.
Kommen Sie nicht weiter? Schreiben Sie an [email protected] und geben Sie die genaue Fehlerzeile an, die das Studio anzeigt. Senden Sie kein Token mit.