Aktivieren von GitHub Connect für GHE.com

Sie können auf Ihre GitHub Enterprise Server-Instance auf zusätzliche Funktionen und Workflows zugreifen, indem Sie GitHub Connect aktivieren. Weitere Informationen findest du unter Informationen zu GitHub Connect.

Wenn Sie eine Verbindung mit einem Unternehmen herstellen unter GHE.com:

Serverstatistik ist nicht verfügbar.
GitHub.com Aktionen sind nicht verfügbar.

Was geschieht, wenn GitHub Connect sie aktiviert ist?

Wenn du GitHub Connect aktivierst, konfiguriere eine Verbindung zwischen Ihre GitHub Enterprise Server-Instance und einem Unternehmenskonto für GitHub Enterprise Cloud. Die Verbindung verwendet HTTPS über die Ports 443 oder 80 und wird durch TLS gesichert.

Die Aktivierung von GitHub Connect erstellt eine GitHub App, die dem Unternehmenskonto auf GitHub Enterprise Cloud gehört. GitHub Enterprise Server verwendet die Anmeldeinformationen von GitHub App, um Anforderungen an GitHub Enterprise Cloud zu stellen.

In GitHub Enterprise Server werden Anmeldeinformationen der GitHub App gespeichert. Diese Anmeldeinformationen werden zu allen Knoten in einer Hochverfügbarkeits- oder Clusteringumgebung repliziert und in von GitHub Enterprise Server Backup Utilities erstellten Sicherungen, einschließlich Momentaufnahmen, gespeichert.

Ein Authentifizierungstoken, das eine Stunde lang gültig ist
Ein privater Schlüssel zum Generieren eines neuen Authentifizierungstokens

Voraussetzungen

Administrativer Zugriff: Sie benötigen administratorseitigen Zugriff auf ein Unternehmenskonto und GHE.com eine GitHub Enterprise Server Instanz.
Versionsanforderung: Ihre GitHub Enterprise Server Instanz muss 3.12 oder höher ausführen GitHub Enterprise Server .
Proxykonfiguration: Wenn Sie einen Proxyserver verwenden, lassen Sie die Verbindung mit den folgenden GHE.com Hostnamen zu (ersetzen Sie SUBDOMÄNE durch die Unterdomäne Ihres Unternehmens).
- SUBDOMAIN.ghe.com
- api.SUBDOMAIN.ghe.com
- uploads.SUBDOMAIN.ghe.com
Weitere Informationen findest du unter Konfigurieren eines ausgehenden Webproxyservers.

Schritt 1: Aktivieren der Verbindung mit GHE.com

Standardmäßig verbindet GitHub ConnectGitHub Enterprise Server mit GitHub.com. Sie müssen Ihre Instanz aktivieren, um eine Verbindung mit der Unterdomäne Ihres Unternehmens herzustellen GHE.com.

Um die Verbindung zu deine GitHub Enterprise Server-Instanz aktivieren, muss eine Person mit Administrator-SSH-Zugriff die folgenden Aufgaben ausführen.

Melde dich über SSH bei Ihre GitHub Enterprise Server-Instance an. Wenn deine Instanz mehrere Knoten umfasst, wenn z. B. Hochverfügbarkeit oder Georeplikation konfiguriert ist, wird SSH im primären Knoten konfiguriert. Wenn du einen Cluster verwendest, kannst du SSH in einen beliebigen Knoten einfügen. Ersetzen Sie HOSTNAME durch den Hostnamen Ihrer Instanz bzw. durch den Hostnamen oder die IP-Adresse eines Knotens. Weitere Informationen finden Sie unter Auf die Verwaltungsshell (SSH) zugreifen.
Shell
```
ssh -p 122 admin@HOSTNAME
```
```
ssh -p 122 admin@HOSTNAME
```

Führen Sie den folgenden Befehl aus, damit Ihre Instanz eine Verbindung mit GHE.com für GitHub Connect herstellen kann. Ersetzen Sie SUBDOMAIN durch die Unterdomäne für Ihr Unternehmen auf GHE.com, z. B. octocorp.

Shell

ghe-config app.github.github-connect-ghe-com-enabled true
ghe-config app.github.github-connect-ghe-com-subdomain "SUBDOMAIN"

ghe-config app.github.github-connect-ghe-com-enabled true
ghe-config app.github.github-connect-ghe-com-subdomain "SUBDOMAIN"

Führe den folgenden Befehl aus, um die Konfiguration anzuwenden.

Hinweis

Während einer Konfiguration können Dienste auf deine GitHub Enterprise Server-Instanz neu gestartet werden, was zu kurzen Ausfallzeiten für Benutzer führen kann.
Shell
```
ghe-config-apply
```
```
ghe-config-apply
```

Nach Abschluss der Ausführung können Sie GitHub Connect konfigurieren.

Schritt 2: Aktivieren GitHub Connect

Um GitHub Connect zu aktivieren, müssen Sie sowohl auf GitHub Enterprise Server als auch auf GitHub Enterprise Cloud Unternehmensbesitzer sein.

Personen mit einem Benutzerkonto in beiden Umgebungen können die Konten über deine GitHub Enterprise Server-Instanz miteinander verbinden.

Melden Sie sich bei Ihre GitHub Enterprise Server-Instance und GHE.com.
Klicke in der oberen rechten Ecke von GitHub Enterprise Server auf dein Profilbild und dann auf Enterprise settings.
Klicken Sie oben auf der Seite auf GitHub Connect.
Klicke unter „GitHub Connect noch nicht aktiviert“, und klicke auf GitHub Connect aktivieren. Wenn du auf Aktivieren GitHub Connect klickst, stimmst du den GitHub-Nutzungsbedingungen für zusätzliche Produkte und Funktionen zu.
Klicke rechts neben dem Unternehmenskonto, das du verbinden möchtest, auf Verbinden.
Wählen Sie aus, welche einzelnen Funktionen von GitHub Connect Sie aktivieren möchten. Weitere Informationen findest du unter Informationen zu GitHub Connect.

Erneutes Aktivieren von Verbindungen zu GitHub.com

Wenn Sie GitHub Connect für GitHub.com erneut aktivieren müssen, müssen Sie Ihre Einstellungen neu konfigurieren.

Melde dich über SSH bei Ihre GitHub Enterprise Server-Instance an. Wenn deine Instanz mehrere Knoten umfasst, wenn z. B. Hochverfügbarkeit oder Georeplikation konfiguriert ist, wird SSH im primären Knoten konfiguriert. Wenn du einen Cluster verwendest, kannst du SSH in einen beliebigen Knoten einfügen. Ersetzen Sie HOSTNAME durch den Hostnamen Ihrer Instanz bzw. durch den Hostnamen oder die IP-Adresse eines Knotens. Weitere Informationen finden Sie unter Auf die Verwaltungsshell (SSH) zugreifen.
Shell
```
ssh -p 122 admin@HOSTNAME
```
```
ssh -p 122 admin@HOSTNAME
```

Führen Sie den folgenden Befehl aus.