Sie können GitHub Enterprise Server auf Global Azure oder Azure Government bereitstellen.
Voraussetzungen
- Du musst über eine GitHub Enterprise-Lizenzdatei verfügen. Besuche enterprise.github.com, um eine vorhandene Lizenzdatei herunterzuladen oder eine Testlizenz anzufordern. Weitere Informationen findest Du unter „Deine GitHub Enterprise-Lizenz verwalten."
- Sie müssen über ein Azure-Konto verfügen, das neue Computer bereitstellen kann. Weitere Informationen finden Sie auf der „Microsoft Azure-Website“.
- Die meisten Aktionen, die zum Starten Ihrer virtuellen Maschine (VM) erforderlich sind, können auch mithilfe des Azure-Portals ausgeführt werden. Zur Ersteinrichtung sollten Sie jedoch die Azure-Befehlszeilenschnittstelle (CLI) installieren. Im Folgenden finden Sie Beispiele zur Verwendung der Azure CLI 2.0. Weitere Informationen finden Sie im Azure-Leitfaden „Installieren der Azure CLI“.
Grundlegendes zur Hardware
GitHub Enterprise Server schreibt eine persistente Data-Disk vor, die von der Root-Disk getrennt ist. Weitere Informationen findest Du unter „Systemübersicht“. Wir empfehlen verschiedene Hardwarekonfigurationen basierend auf der Anzahl in Ihre GitHub Enterprise Server-Instanz verwendeten Benutzerlizenzen. |
Benutzerlizenzen | vCPUs | Arbeitsspeicher | Attached-Storage | Root-Storage |
---|---|---|---|---|
Test, Demo oder 10 Benutzer mit eingeschränkten Funktionen | 2 | 16 GB | 100 GB | 200 GB |
10–3000 | 4 | 32 GB | 250 GB | 200 GB |
3000–5000 | 8 | 64 GB | 500 GB | 200 GB |
5000–8000 | 12 | 96 GB | 750 GB | 200 GB |
8000–10000+ | 16 | 128 GB | 1000 GB | 200 GB |
Es gibt Mindestempfehlungen. Entsprechend Deiner Nutzung, beispielsweise in Bezug auf die Benutzeraktivität und die ausgewählten Integrationen, sind möglicherweise mehr Ressourcen erforderlich. Es wird empfohlen, beim Erhöhen der CPU-Ressourcen mindestens 6.5 GB Speicher für jede CPU (bis zu 16 CPUs) hinzuzufügen, die der GitHub Enterprise Server Instanz angehängt wurden. Weitere Informationen findest Du unter „CPU- und Arbeitsspeicherressourcen erhöhen.“
Hinweis: Die Größe der Root-Disk kann geändert werden, indem eine neue Appliance erstellt oder eine vorhandene Appliance verwendet wird. Weitere Informationen findest Du unter „Speicherkapazität erhöhen“.
Warnung: Wir empfehlen Dir Webhooks zu verwenden, um Repository-Änderungen für die fortlaufende Integration (CI) oder für ähnliche Systeme abzurufen. Durch regelmäßige automatische Überprüfungen oder durch das automatische Abrufen wird die Skalierbarkeit Deiner Instanz erheblich reduziert. Weitere Informationen findest Du unter „Informationen zu Webhooks“.
Typ der virtuellen Maschine ermitteln
Bevor Sie Ihre GitHub Enterprise Server-Instanz auf Azure starten, müssen Sie den Typ der virtuellen Maschine ermitteln, der den Anforderungen Ihrer Organisation am besten gerecht wird.
Unterstützte VM-Typen und -Regionen
Für die GitHub Enterprise Server-Appliance ist eine Premium-Storage-Daten-Disk erforderlich. Zudem wird sie auf jeder Azure-VM unterstützt, die Premium-Storage unterstützt. Weitere Informationen finden Sie unter „SSD Premium“ in der Azure-Dokumentation. Allgemeine Informationen zu den verfügbaren VMs finden Sie auf der Übersichtsseite zu Azure-VMs.
GitHub Enterprise Server unterstützt jede Region, die Ihren VM-Typ unterstützt. Weitere Informationen zu den unterstützten Regionen für jede VM finden Sie auf der Azure-Website „Verfügbare Produkte nach Region“.
Empfohlene VM-Typen
Sie sollten einen DS v2-Instanztyp mit mindestens 14 GB RAM verwenden. Sie können jeden unterstützten VM-Typ verwenden. Basierend auf der Anzahl Deiner Benutzerlizenzen empfehlen wir die folgenden Instanztypen.
Benutzer | Empfohlener Typ |
---|---|
Test, Demo oder 10 Benutzer mit eingeschränkten Funktionen | Standard_DS11_v2 |
10–3000 | Standard_DS12_v2 |
3000–8000 | Standard_DS14_v2 |
8000–10000+ | Standard_DS15_v2 |
Hinweis: Du kannst Deine CPU oder Deinen Arbeitsspeicher jederzeit hochskalieren, indem Du die Größe Deiner Instanz anpasst. Da das Anpassen Deiner CPU- oder Arbeitsspeichergröße jedoch Ausfallzeiten für Deine Benutzer bedeutet, empfehlen wir ein Over-Provisioning der zu skalierenden Ressourcen.
GitHub Enterprise Server-VM erstellen
Zum Erstellen der Instanz musst Du das GitHub Enterprise Server-Abbild auf Deine virtuelle Maschine importieren und ein zusätzliches Storage-Volume für Deine Instanzdaten anhängen. Weitere Informationen findest Du unter „Grundlegendes zur Hardware“.
-
Suchen Sie nach dem neuesten GitHub Enterprise Server-Appliance-Image. Weitere Informationen zum Befehl
vm image list
finden Sie unter „az vm image list“ in der Microsoft-Dokumentation.$ az vm image list --all -f GitHub-Enterprise | grep '"urn":' | sort -V
-
Erstellen Sie mithilfe des von Ihnen ermittelten Appliance-Images eine neue VM. Weitere Informationen finden Sie unter „az vm create“ in der Microsoft-Dokumentation.
Übergeben Sie Optionen für den Namen Ihrer VM, den Ressourcentyp, die Größe Ihrer VM, den Namen Ihrer bevorzugten Azure-Region, den Namen der von Ihnen im vorherigen Schritt aufgelisteten Appliance-Image-VM und die Storage-SKU für den Premium-Storage. Weitere Informationen zu Ressourcengruppen finden Sie unter „Ressourcengruppen“ in der Microsoft-Dokumentation.
$ az vm create -n VM_NAME -g RESOURCE_GROUP --size VM_SIZE -l REGION --image APPLIANCE_IMAGE_NAME --storage-sku Premium_LRS
-
Konfigurieren Sie die Sicherheitseinstellungen auf Ihrer VM, um die erforderlichen Ports zu öffnen. Weitere Informationen finden Sie unter „az vm open-port“ in der Microsoft-Dokumentation. In der folgenden Tabelle finden Sie eine Beschreibung der einzelnen Ports, um festzustellen, welche Ports Sie öffnen müssen.
$ az vm open-port -n VM_NAME -g RESOURCE_GROUP --port PORT_NUMBER
Diese Tabelle zeigt, wofür jeder Port verwendet wird.
Port Dienst Beschreibung 22 SSH Git über SSH-Zugriff. Unterstützt das Klonen, Abrufen und Übertragen von Vorgängen an öffentliche/private Repositorys. 25 SMTP SMTP mit Verschlüsselung (STARTTLS) wird unterstützt. 80 HTTP Webanwendungszugriff. Alle Anforderungen werden an den HTTPS-Port weitergeleitet, wenn SSL aktiviert ist. 122 SSH Shellzugriff auf die Instanz. Der standardmäßige SSH-Port (22) ist für den Git- und SSH-Netzwerk-Traffic der Anwendung vorgesehen. 161/UDP SNMP Für Netzwerküberwachungs-Protokollvorgänge erforderlich. 443 HTTPS Webanwendung und Git über HTTPS-Zugriff. 1194/UDP VPN Sicherer Replikationsnetzwerktunnel in einer hochverfügbaren Konfiguration. 8080 HTTP Webbasierte Managementkonsole in Nur-Text. Nur erforderlich, wenn SSL manuell deaktiviert wird. 8443 HTTPS Sichere webbasierte Managementkonsole. Für die grundlegende Installation und Konfiguration erforderlich. 9418 Git Einfacher Git-Protokollport. Nur Klon- und Abrufvorgänge zu öffentlichen Repositorys. Unverschlüsselte Netzwerkkommunikation. -
Erstelle eine neue unverschlüsselte Daten-Festplatte, hänge sie an die VM und konfiguriere die Größe entsprechend Deiner Anzahl von Benutzerlizenzen. Weitere Informationen finden Sie unter „az vm disk attach“ in der Microsoft-Dokumentation.
Übergeben Sie Optionen für den Namen Ihrer VM (z. B.
ghe-acme-corp
), die Ressourcengruppe, die Premium-Storage-SKU, die Größe der Disk (z. B.100
) und einen Namen für die resultierende VHD.$ az vm disk attach --vm-name VM_NAME -g RESOURCE_GROUP --sku Premium_LRS --new -z SIZE_IN_GB --name ghe-data.vhd --caching ReadWrite
Hinweis: Damit Nicht-Produktionsinstanzen einen ausreichenden E/A-Durchsatz aufweisen, wird eine minimale Disk-Größe von 40 GiB mit aktiviertem Lese-/Schreib-Caching (
--caching ReadWrite
) empfohlen.
GitHub Enterprise Server-VM konfigurieren
-
Vor der VM-Konfiguration müssen Sie darauf warten, dass sie den Status „ReadyRole“ aufweist. Führen Sie den Befehl
vm list
aus, um den Status der VM zu überprüfen. Weitere Informationen finden Sie unter „az vm list“ in der Microsoft-Dokumentation.$ az vm list -d -g RESOURCE_GROUP -o table > Name ResourceGroup PowerState PublicIps Fqdns Location Zones > ------ --------------- ------------ ------------ ------- ---------- ------- > VM_NAME RESOURCE_GROUP VM running 40.76.79.202 eastus
Hinweis: Azure erstellt nicht automatisch einen FQDN-Eintrag für die VM. Weitere Informationen finden Sie im Azure-Leitfaden „Erstellen eines vollqualifizierten Domänennamens im Azure-Portal für eine Linux-VM“.
-
Kopiere den Namen des öffentlichen DNS der virtuellen Maschine, und füge ihn in einen Webbrowser ein.
-
Lade an der Eingabeaufforderung Deine Lizenzdatei hoch, und lege das Passwort für die Managementkonsole fest. Weitere Informationen findest Du unter „Deine GitHub Enterprise-Lizenz verwalten."
-
Konfiguriere in der Managementkonsole Deine gewünschten Einstellungen, und speichere sie. Weitere Informationen finden Sie unter „GitHub Enterprise Server-Appliance konfigurieren“.
-
Die Instanz wird automatisch neu gestartet.
-
Klicke auf Visit your instance (Instanz aufrufen).
Weiterführende Informationen