Aktivieren von GitHub Connect für GHE.com

Du kannst auf zusätzliche Features und Workflows für Ihre GitHub Enterprise Server-Instance zugreifen, indem du GitHub Connect aktivierst. Weitere Informationen findest du unter Informationen zu GitHub Verbinden.

Auf GHE.com enthalten GitHub Connect-Features keine Funktionalität, die auf Ressourcen für GitHub.com basiert.

Was geschieht bei der Aktivierung von GitHub Connect?

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

Administratorzugriff: Du benötigst Administratorzugriff auf ein Enterprise-Konto auf GHE.com und eine GitHub Enterprise Server-Instanz.
Versionsanforderung: Deine GitHub Enterprise Server-Instanz muss GitHub Enterprise Server 3.12 oder höher ausführen.
Proxykonfiguration: Ermögliche bei der Verwendung eines Proxyservers die Verbindung mit den folgenden GHE.com-Hostnamen (ersetze SUBDOMAIN durch die Unterdomäne deines Unternehmens).
- SUBDOMAIN.ghe.com
- api.SUBDOMAIN.ghe.com
- uploads.SUBDOMAIN.ghe.com
Weitere Informationen findest du unter Konfigurieren eines ausgehenden Webproxyservers.

Schritt 1: Aktivieren einer Verbindung mit GHE.com

Standardmäßig verbindet GitHub Connect GitHub Enterprise Server mit GitHub.com. Du musst es deiner Instanz ermöglichen, eine Verbindung mit der Unterdomäne von GHE.com herzustellen.

Um die Verbindung zu ermöglichen, muss eine Person mit SSH-Administratorzugriff auf deine GitHub Enterprise Server-Instanz 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 findest du unter Auf die Verwaltungsshell (SSH) zugreifen.
Shell
```
ssh -p 122 admin@HOSTNAME
```
```
ssh -p 122 admin@HOSTNAME
```

Führe den folgenden Befehl aus, um für GitHub Connect die Verbindung mit GHE.com herzustellen. Ersetze SUBDOMAIN durch die Unterdomäne für dein 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.

Note

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

Nach Abschluss der Ausführung kannst du GitHub Connect konfigurieren.

Schritt 2: Aktivieren von GitHub Connect

Um GitHub Connect zu aktivieren, musst du sowohl auf GitHub Enterprise Server als auch GitHub Enterprise Cloud eine Unternehmensbesitzerin sein.

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

Melde dich bei Ihre GitHub Enterprise Server-Instance und GHE.com an.
Klicken Sie in der oberen rechten Ecke von GitHub Enterprise Server auf Ihr Profilfoto und dann auf Unternehmenseinstellungen.
Wähle auf der Randleiste des Unternehmenskontos die Option GitHub Connect aus.
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ähle die einzelnen Features von GitHub Connect aus, die du aktivieren möchtest. Weitere Informationen findest du unter Informationen zu GitHub Verbinden.

Erneutes Aktivieren von Verbindungen mit GitHub.com

Um GitHub Connect für GitHub.com erneut zu aktivieren, musst du deine 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 findest du unter Auf die Verwaltungsshell (SSH) zugreifen.
Shell
```
ssh -p 122 admin@HOSTNAME
```
```
ssh -p 122 admin@HOSTNAME
```

Führen Sie den folgenden Befehl aus.