GitHub-Probleme

Wenn Sie Inhaber der Organisation sind, können Sie Jamdesk sofort genehmigen:

1. Klicken Sie unter der Organisationsauswahl auf GitHub auf grant Jamdesk access on GitHub (oder gehen Sie zu GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk)
2. Klicken Sie unter Organization access neben Ihrer Organisation auf Grant
3. Klicken Sie im Jamdesk-Einrichtungsablauf auf refresh the list. Ihre Organisation wird sofort angezeigt

Wenn Sie Mitglied und kein Inhaber sind, wird stattdessen eine Request-Schaltfläche angezeigt. Wenn Sie darauf klicken, wird eine Genehmigungsanfrage an die Administratoren Ihrer Organisation gesendet.

Wenn Sie Mitglied ohne Inhaberrechte sind, senden Sie zunächst eine Genehmigungsanfrage an Ihre Administratoren:

1. Gehen Sie zu GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk
2. Klicken Sie unter Organization access neben Ihrer Organisation auf Request. Dadurch werden die Administratoren Ihrer Organisation benachrichtigt
3. Ein Administrator genehmigt die Anfrage unter Settings → Third-party access → OAuth application policy der Organisation (ausstehende Anfragen zeigen eine Approve-Schaltfläche)
4. Kehren Sie zum Jamdesk-Einrichtungsablauf 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.

Möchten Sie 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:

1. Schließen Sie die Jamdesk-Einrichtung mit Ihrem persönlichen Konto ab
2. Öffnen Sie das erstellte Repository auf GitHub
3. Gehen Sie zu Settings → General → Danger Zone
4. Klicken Sie auf Transfer und wählen Sie Ihre Organisation als Ziel aus
5. Trennen Sie in Jamdesk die Verbindung zum Repository und stellen Sie sie auf der Settings-Seite Ihres Projekts wieder her

Dies funktioniert nicht, wenn Ihr Unternehmen Ihr GitHub-Konto verwaltet. Lesen Sie stattdessen den Abschnitt Von Unternehmen verwaltete GitHub-Konten.

1. Bitten Sie einen Enterprise-Inhaber, über die Registerkarte Organizations Ihres Enterprise eine Organisation zu erstellen. Bitten Sie ihn, Ihnen das Erstellen von Repositories darin zu erlauben.
2. Übertragen Sie Ihr Dokumentations-Repository dorthin. Gehen Sie im Repository zu Settings, klicken Sie unten auf Transfer und wählen Sie die neue Organisation aus.
3. Klicken Sie in Jamdesk auf Connect an existing repository (oder in den Projekteinstellungen auf Install GitHub App). Wählen Sie auf GitHub die Organisation aus, wählen Sie Only select repositories, markieren Sie Ihr Repository und installieren Sie die App.

Wenn GitHub statt Install die Option Request anzeigt, erhält ein Organisationsinhaber eine E-Mail zur Genehmigung. Klicken Sie anschließend erneut auf die Jamdesk-Schaltfläche.

Verwenden Sie diese Option, wenn Ihr Unternehmen keine Organisation hinzufügen kann. Klären Sie dies zuerst mit Ihrem GitHub-Administrator, da die Dokumentation außerhalb des GitHub-Kontos Ihres Unternehmens gespeichert wird.

1. Melden Sie sich in einem privaten Browserfenster mit einem persönlichen Konto bei GitHub an (oder erstellen Sie eines).
2. Erstellen Sie in diesem Konto ein leeres privates Repository.
3. Übertragen Sie eine Kopie Ihrer Dokumentation dorthin. GitHub kann Repositories nicht aus einem verwalteten Enterprise verschieben, daher ist eine Kopie erforderlich.

git remote set-url origin https://jsmith@github.com/jsmith/product-docs.git
git push -u origin main

Lassen Sie jsmith@ in der URL stehen, damit Git nach den Anmeldedaten Ihres persönlichen Kontos fragt.

4. Klicken Sie in Jamdesk auf Connect an existing repository (oder in den Projekteinstellungen auf Install GitHub App), installieren Sie Jamdesk in Ihrem persönlichen Konto und wählen Sie das Repository aus.

Verwaltete Konten können keine Pushes an Repositories außerhalb Ihres Enterprise durchführen. Daher benötigt jede Person, die die Dokumentation bearbeitet, ein persönliches GitHub-Konto. Fügen Sie diese Personen als Mitbearbeiter zum Repository hinzu.

1. Gehen Sie zu GitHub → Settings → Applications → Jamdesk
2. Prüfen Sie, ob der Zugriff auf das Repository gewährt wurde
3. Klicken Sie auf Configure, um weitere Repositories hinzuzufügen

Für Repositories von Organisationen gilt:

1. Ein Organisationsadministrator muss Jamdesk genehmigen
2. Gehen Sie zu den Organisationseinstellungen → Third-party access
3. Genehmigen Sie die Zugriffsanfrage von Jamdesk

Für private Repositories ist eine Autorisierung durch GitHub erforderlich. Autorisieren Sie Jamdesk bei Bedarf erneut.