GitHub Issues
Beheben Sie fehlende Organisationen beim Einrichten, fehlende Repositories, fehlgeschlagene Webhooks, Berechtigungsfehler und Branch-Abweichungen mit der GitHub-Integration von Jamdesk.
Die meisten Probleme mit der GitHub-Integration sind auf Berechtigungen, fehlgeschlagene Webhooks oder Abweichungen bei Branches zurückzuführen.
Organisation wird beim Einrichten nicht angezeigt
Während des Ablaufs der Starter-Dokumentation zeigt Jamdesk Ihre GitHub-Organisationen an, damit Sie auswählen können, wo das Repository erstellt werden soll. Die Liste stammt aus der OAuth API von GitHub, und GitHub blendet Organisationen in zwei Fällen aus:
- Einschränkungen für OAuth-Apps: Ihre Organisation beschränkt den Zugriff von Drittanbieter-Apps (Standardeinstellung von GitHub für neue Organisationen) und hat Jamdesk noch nicht genehmigt.
- SAML SSO: Ihre Organisation erfordert eine SAML-Authentifizierung, bevor die API sie zurückgibt.
Wenn Sie Inhaber der Organisation sind, können Sie Jamdesk sofort genehmigen:
- Klicken Sie unter der Organisationsauswahl auf grant Jamdesk access on GitHub (oder gehen Sie zu GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk).
- Klicken Sie unter Organization access neben Ihrer Organisation auf Grant.
- Klicken Sie im Einrichtungsablauf von Jamdesk auf refresh the list. Ihre Organisation wird sofort angezeigt.
Wenn Sie Mitglied und kein Inhaber sind, wird stattdessen die Schaltfläche Request angezeigt. Wenn Sie darauf klicken, wird eine Genehmigungsanfrage an die Administratoren Ihrer Organisation gesendet.
Wenn Sie Mitglied ohne Inhaberrechte sind, senden Sie Ihren Administratoren zunächst eine Genehmigungsanfrage:
- Gehen Sie zu GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk.
- Klicken Sie unter Organization access neben Ihrer Organisation auf Request. Dadurch werden die Administratoren Ihrer Organisation benachrichtigt.
- Ein Administrator genehmigt die Anfrage unter Settings → Third-party access → OAuth application policy der Organisation (ausstehende Anfragen zeigen eine Schaltfläche Approve).
- Kehren Sie zum Einrichtungsablauf von Jamdesk zurück und klicken Sie auf refresh the list. Ihre Organisation sollte nun angezeigt werden.
Eine ausführliche Anleitung finden Sie im GitHub-Leitfaden zum Genehmigen von OAuth-Apps für Ihre Organisation.
Sie möchten nicht auf die Genehmigung durch einen Administrator warten? Wählen Sie während der Einrichtung Ihr persönliches Konto aus und übertragen Sie das Repository anschließend in Ihre Organisation:
- Schließen Sie die Einrichtung von Jamdesk mit Ihrem persönlichen Konto ab.
- Gehen Sie zum erstellten Repository auf GitHub.
- Navigieren Sie zu Settings → General → Danger Zone.
- Klicken Sie auf Transfer und wählen Sie Ihre Organisation als Ziel aus.
- Trennen Sie in Jamdesk die Verbindung zum Repository und verbinden Sie es auf der Seite Settings Ihres Projekts erneut.
Durch das Trennen und erneute Verbinden wird eine neue Dokumentations-URL erstellt (z. B. kann sich your-project.jamdesk.app ändern). Wenn Sie Ihre URL bereits weitergegeben oder eine benutzerdefinierte Domain eingerichtet haben, wenden Sie sich vor dem Trennen an den Support, damit wir Ihre Konfiguration beibehalten können.
Repository wird nicht angezeigt
Wenn Ihr Repository nicht in der Liste angezeigt wird:
- Gehen Sie zu GitHub → Settings → Applications → Jamdesk.
- Prüfen Sie, ob der Zugriff auf das Repository gewährt wurde.
- Klicken Sie auf Configure, um weitere Repositories hinzuzufügen.
Für Repositories von Organisationen gilt:
- Ein Administrator der Organisation muss Jamdesk genehmigen.
- Gehen Sie zu den Einstellungen der Organisation → Third-party access.
- Genehmigen Sie die Zugriffsanfrage von Jamdesk.
Für private Repositories ist eine GitHub-Autorisierung erforderlich. Autorisieren Sie Jamdesk bei Bedarf erneut.
Builds werden nicht ausgelöst
Wenn Pushes keine Builds auslösen:
- Gehen Sie zu Ihrem Repository auf GitHub.
- Navigieren Sie zu Settings → Webhooks.
- Suchen Sie den Jamdesk-Webhook.
- Prüfen Sie "Recent Deliveries" auf Fehler.
Builds werden nur für Ihren konfigurierten Branch ausgelöst. Prüfen Sie Settings in Jamdesk.
- Gehen Sie in Jamdesk zu den Settings des Projekts.
- Klicken Sie auf Re-sync GitHub.
Webhook-Fehler
404 Not Found
Der Webhook-Endpoint konnte nicht erreicht werden.
Lösung: Synchronisieren Sie die GitHub-Verbindung in den Projekteinstellungen erneut.
401 Unauthorized
Die Authentifizierung ist fehlgeschlagen.
Lösung:
- Gehen Sie zu den Kontoeinstellungen Ihres GitHub-Kontos.
- Navigieren Sie zu Applications → Authorized OAuth Apps.
- Widerrufen Sie Jamdesk.
- Autorisieren Sie Jamdesk in den Einstellungen erneut.
500 Server Error
Vorübergehendes Problem bei Jamdesk.
Lösung: Warten Sie einige Minuten und führen Sie einen weiteren Push durch oder lösen Sie einen manuellen Rebuild aus.
Berechtigungsfehler
"Repository not found" während des Builds:
- Das Repository wurde möglicherweise gelöscht oder umbenannt.
- Jamdesk hat möglicherweise den Zugriff verloren.
- Autorisieren Sie Ihre GitHub-Verbindung erneut.
Branch-Probleme
Falscher Branch wird erstellt
Prüfen Sie Ihren konfigurierten Branch unter Settings → Repository.
Branch umbenannt oder gelöscht
Aktualisieren Sie Ihre Branch-Einstellung entsprechend dem neuen Branchnamen.