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 finden Sie 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?

When you enable GitHub Connect, you configure a connection between Ihre GitHub Enterprise Server-Instance and an enterprise account on GitHub Enterprise Cloud. Die Verbindung verwendet HTTPS über die Ports 443 oder 80 und wird durch TLS gesichert.

Enabling GitHub Connect creates a GitHub App owned by the enterprise account on GitHub Enterprise Cloud. GitHub Enterprise Server uses the GitHub App's credentials to make requests to GitHub Enterprise Cloud.

GitHub Enterprise Server stores credentials from the GitHub App. The following credentials will be replicated to all nodes in a high availability or cluster environment, and stored in any backups, including snapshots created by GitHub Enterprise Server Backup Utilities.

• An authentication token, which is valid for one hour
• A private key, which is used to generate a new authentication token

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 finden Sie 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.

1. 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
   

2. 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"
   

3. 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
   

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.

1. Melde dich bei Ihre GitHub Enterprise Server-Instance und GHE.com an.

2. Klicken Sie in der oberen rechten Ecke von GitHub Enterprise Server auf Ihr Profilfoto und dann auf Unternehmenseinstellungen.

   

3. Wähle auf der Randleiste des Unternehmenskontos die Option GitHub Connect aus.

4. 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.

5. Klicke rechts neben dem Unternehmenskonto, das du verbinden möchtest, auf Verbinden.

6. Wähle die einzelnen Features von GitHub Connect aus, die du aktivieren möchtest. Weitere Informationen finden Sie 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.

1. 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
   

2. Führen Sie den folgenden Befehl aus.

   Shell

   ghe-config app.github.github-connect-ghe-com-enabled false
   

3. 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
   

4. Aktiviere GitHub Connect auf GitHub.com. Weitere Informationen finden Sie unter „Enabling GitHub Connect for GitHub.com“.