Auf die Verwaltungsshell (SSH) zugreifen

Mit dem SSH-Zugriff kannst du die Befehlszeilenprogramme von GitHub Enterprise Server ausführen, um Probleme zu behandeln, Sicherungen auszuführen und die Replikation zu konfigurieren.

In diesem Artikel

Informationen zum Verwaltungsshellzugriff

Wenn du über SSH-Zugriff auf die Verwaltungsshell verfügst, kannst du 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 musst du deinen öffentlichen SSH-Schlüssel zur Liste der autorisierten Schlüssel deiner Instanz hinzufügen. Weitere Informationen findest du unter Generieren eines neuen SSH-Schlüssels und Hinzufügen des Schlüssels zum ssh-agent.

  1. Klicke in einem Verwaltungskonto auf GitHub Enterprise Server und dann in der rechten oberen Ecke einer beliebigen Seite auf „“.
  2. Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.
  3. Wähle auf der Randleiste „ Websiteadministrator“ die Option Verwaltungskonsole aus.
  4. Füge unter „SSH-Zugriff“ deinen Schlüssel in das Textfeld „Neuen SSH-Schlüssel hinzufügen“ ein, und klicke anschließend auf Schlüssel hinzufügen. Die Änderung wird sofort wirksam, sodass du nicht auf Einstellungen speichern klicken musst.

Verbindung zur Verwaltungsshell über SSH herstellen

Nachdem du der Liste deinen SSH-Schlüssel hinzugefügt hast, stelle als Benutzer adminadmin auf Port 122 eine Verbindung zur Instanz über SSH her.

$ 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

Sollte der Fehler Permission denied (publickey) angezeigt werden, wenn du versuchst, über SSH eine Verbindung mit Ihre GitHub Enterprise Server-Instance herzustellen, vergewissere dich, dass zur Verbindungsherstellung Port 122 verwendet wird. Möglicherweise musst du explizit angeben, welcher private SSH-Schlüssel verwendet werden soll.

Führe ssh mit dem Argument -i aus, um einen privaten SSH-Schlüssel mithilfe der Befehlszeile anzugeben.

ssh -i /path/to/ghe_private_key -p 122 admin@HOSTNAME

Du kannst auch 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, kannst du lokal auf die Verwaltungsshell zugreifen. Melde Dich als Benutzer admin mit dem Kennwort 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. Dein Supportvertrag wird ggf. ungültig, wenn du System- und Anwendungsdateien änderst, Programme ausführst oder nicht unterstützte Softwarepakete installierst. Gehen Sie bitte zu GitHub Enterprise Support bei Fragen zu den laut deinem Supportvertrag zulässigen Aktivitäten.