GitHub Enterprise Server auf XenServer installieren

Vorrausetzungen

• Sie müssen ü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 den XenServer Hypervisor auf der Maschine installieren, auf der Ihre GitHub Enterprise Server-VM (virtuelle Maschine) ausgeführt wird. Es werden die Versionen 6.0 bis 7.0 unterstützt.
• Zur Ersteinrichtung sollten Sie die XenCenter Windows Management Console verwenden. Im Folgenden finden Sie Anweisungen zur Verwendung von XenCenter Windows Management Console. Weitere Informationen finden Sie im Citrix-Leitfaden unter „How to Download and Install a New Version of XenCenter“.

Grundlegendes zur Hardware

• Minimum requirements
• Speicher
• CPU and memory

Minimum requirements

We recommend different hardware configurations depending on the number of user licenses for Ihre GitHub Enterprise Server-Instanz. If you provision more resources than the minimum requirements, your instance will perform and scale better.

Minimum requirements for an instance with beta features enabled are bold in the following table. For more information, see "Beta features in GitHub Enterprise Server 2.22." | | Benutzerlizenzen | vCPUs | Arbeitsspeicher | Attached-Storage | Root-Storage | |:---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------:| ------------:| | Test, Demo oder 10 Benutzer mit eingeschränkten Funktionen | 2
or 4 | 16 GB
or 32 GB | 100 GB
or 150 GB | 200 GB | | 10–3000 | 4
or 8 | 32 GB
or 48 GB | 250 GB
or 300 GB | 200 GB | | 3000–5000 | 8
or 12 | 64 GB | 500 GB | 200 GB | | 5000–8000 | 12
or 16 | 96 GB | 750 GB | 200 GB | | 8000–10000+ | 16
or 20 | 128 GB
or 160 GB | 1000 GB | 200 GB |

Beta features in GitHub Enterprise Server 2.22

If you enable beta features in GitHub Enterprise Server 2.22, your instance requires additional hardware resources. For more information about the beta features, see the release notes for the 2.22 series on the GitHub Enterprise website. For more information about adjusting resources for an existing instance, see "Increasing storage capacity" and "Increasing CPU or memory resources."

If you enable the beta for GitHub Actions on your instance, we recommend planning for additional capacity.

• You must configure at least one runner for GitHub Actions workflows. Weitere Informationen findest Du unter „Informationen zu selbst-gehosteten Runnern“.
• You must configure external blob storage. For more information, see "Enabling GitHub Actions and configuring storage."

The additional CPU and memory resources you need to provision for your instance depend on the number of workflows your users run concurrently, and the overall levels of activity for users, automations, and integrations.

Speicher

We recommend a high-performance SSD with high input/output operations per second (IOPS) and low latency for GitHub Enterprise Server. Workloads are I/O intensive. If you use a bare metal hypervisor, we recommend directly attaching the disk or using a disk from a storage area network (SAN).

Your instance requires a persistent data disk separate from the root disk. Weitere Informationen findest Du unter „Systemübersicht“.

If you enable the beta of GitHub Actions in GitHub Enterprise Server 2.22, you'll need to configure external blob storage. For more information, see "Enabling GitHub Actions and configuring storage."

You can resize your instance's root disk by building a new instance or using an existing instance. Weitere Informationen findest Du unter „Speicherkapazität erhöhen“.

CPU and memory

GitHub Enterprise Server requires more CPU and memory resources depending on levels of activity for users, automations, and integrations.

When you increase CPU resources, we recommend adding at least 6.5 GB of memory for each vCPU (up to 16 vCPUs) that you provision for the instance. When you use more than 16 vCPUs, you don't need to add 6.5 GB of memory for each vCPU, but you should monitor your instance to ensure it has enough memory.

You can increase your instance's CPU or memory resources. For more information, see "Increasing CPU or memory resources.

GitHub Enterprise Server-Image herunterladen

1. Navigieren Sie zur GitHub Enterprise Server-Downloadseite.
2. Klicke zum Herunterladen Deiner Lizenzdatei auf Download license (Lizenz herunterladen).
3. Klicken Sie auf Get the latest release of GitHub Enterprise Server (Neueste Version von GitHub Enterprise Server abrufen).
4. Wählen Sie „GitHub On-premises“ (GitHub (lokal)) aus, und klicken Sie anschließend auf XenServer (VHD).
5. Klicke zum Herunterladen Deiner Lizenzdatei auf Download license (Lizenz herunterladen).

GitHub Enterprise Server-Instanz 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 finden Sie unter „Grundlegendes zur Hardware“.

1. Importieren Sie in XenCenter das von Ihnen heruntergeladene GitHub Enterprise Server-Image. Anweisungen finden Sie im XenCenter-Leitfaden unter „Importieren von Disk-Images“.
   • Wählen Sie Don't use Operating System Fixup (Betriebssystemkorrektur nicht verwenden) für den Schritt „Enable Operating System Fixup“ (Betriebssystemkorrektur aktivieren) aus.
   • Lassen Sie die VM nach Abschluss ausgeschaltet.
2. Erstelle eine neue virtuelle Festplatte, die Du als angehängtes Speichervolumen für Deine Instanzdaten verwendest und konfiguriere die Größe basierend auf der Anzahl Deiner Benutzerlizenzen. 1. Erstelle eine neue virtuelle Festplatte, die Du als angehängtes Speichervolumen für Deine Instanzdaten verwendest und konfiguriere die Größe basierend auf der Anzahl Deiner Benutzerlizenzen. Anweisungen finden Sie im XenCenter-Leitfaden unter „Virtuelle Laufwerke hinzufügen“.

GitHub Enterprise Server-Instanz konfigurieren

1. Kopiere den Namen des öffentlichen DNS der virtuellen Maschine, und füge ihn in einen Webbrowser ein.
2. 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."
3. Konfigurieren Sie in der Managementkonsole Ihre gewünschten Einstellungen, und speichern Sie sie. Weitere Informationen finden Sie unter „GitHub Enterprise Server-Appliance konfigurieren“.
4. Die Instanz wird automatisch neu gestartet.
5. Klicke auf Visit your instance (Instanz aufrufen).

Weiterführende Informationen

• „Systemübersicht“