Auf die Verwaltungsshell (SSH) zugreifen
Der SSH-Zugriff ermöglicht Ihnen die Ausführung der GitHub Enterprise Server-Befehlszeilendienstprogramme und eignet sich zur Fehlerbehebung, zum Ausführen von Backups und zum Konfigurieren der Replikation.
Inhalt dieses Artikels
- Informationen zum Verwaltungsshellzugriff
- Zugriff auf die Verwaltungsshell über SSH aktivieren
- Verbindung zur Verwaltungsshell über SSH herstellen
- Auf die Verwaltungsshell mithilfe der lokalen Konsole zugreifen
- Zugriffseinschränkungen für die Verwaltungsshell
Informationen zum Verwaltungsshellzugriff
Wenn Sie über SSH-Zugriff auf die Verwaltungsshell verfügen, können Sie die Befehlszeilendienstprogramme von GitHub Enterprise Server ausführen. Der SSH-Zugriff eignet sich zudem zur Fehlerbehebung, zum Ausführen von Backups und zum Konfigurieren der Replikation. Der SSH-Verwaltungszugriff wird getrennt vom Git SSH-Zugriff verwaltet und ist nur über Port 122 zugänglich.
Zugriff auf die Verwaltungsshell über SSH aktivieren
Zum Aktivieren des SSH-Verwaltungszugriffs müssen Sie Ihren öffentlichen SSH-Schlüssel zur Liste der autorisierten Schlüssel Ihrer Instanz hinzufügen.
Tipp: Die Änderungen an den autorisierten SSH-Schlüsseln werden sofort wirksam.
-
Klicken Sie in der oberen rechten Ecke einer beliebigen Seite auf .
-
Klicken Sie auf der linken Seitenleiste auf Managementkonsole.
-
Fügen Sie unter „SSH access“ (SSH-Zugriff) Ihren Schlüssel in das Textfeld ein, und klicken Sie anschließend auf Add key (Schlüssel hinzufügen).
-
Klicken Sie auf der linken Seitenleiste auf Save settings (Einstellungen speichern).
Verbindung zur Verwaltungsshell über SSH herstellen
Nachdem Sie der Liste Ihren SSH-Schlüssel hinzugefügt haben, verbinden Sie als der Benutzer admin
auf Port 122 die Instanz über SSH.
$ ssh -p 122 admin@github.example.com
Last login: Sun Nov 9 07:53:29 2014 from 169.254.1.1
admin@github-example-com:~$ █
Fehlerbehebung bei SSH-Verbindungsproblemen
Wenn der Fehler Permission denied (publickey)
(Berechtigung verweigert (öffentlicher Schlüssel)) angezeigt wird, wenn Sie versuchen, über SSH eine Verbindung zu Ihre GitHub Enterprise Server-Instanz herzustellen, sollten Sie bestätigen, dass Sie die Verbindung über Port 122 vornehmen. Möglicherweise müssen Sie explizit angeben, welcher private SSH-Schlüssel verwendet werden soll.
Führen Sie zum Angeben eines privaten SSH-Schlüssels an der Befehlszeile ssh
mit dem Argument -i
aus.
ssh -i /path/to/ghe_private_key -p 122 admin@hostname
Darüber hinaus können Sie einen privaten SSH-Schlüssel mithilfe der SSH-Konfigurationsdatei (~/.ssh/config
) angeben.
Host hostname
IdentityFile /path/to/ghe_private_key
User admin
Port 122
Auf die Verwaltungsshell mithilfe der lokalen Konsole zugreifen
In einer Notfallsituation, beispielsweise wenn SSH nicht verfügbar ist, können Sie lokal auf die Verwaltungsshell zugreifen. Melden Sie sich als der Benutzer admin
mit dem Passwort an, das während der Ersteinrichtung von GitHub Enterprise Server festgelegt wurde.
Zugriffseinschränkungen für die Verwaltungsshell
Der Verwaltungsshellzugriff ist nur zur Fehlerbehebung und zum Durchführen dokumentierter Vorgehensweisen zulässig. Ihr Supportvertrag wird ggf. ungültig, wenn Sie System- und Anwendungsdateien ändern, Programme ausführen oder nicht unterstützte Softwarepakete installieren. Please contact GitHub Enterprise-Support oder GitHub Premium-Support if you have a question about the activities allowed by your support contract.