Installation de GitHub Enterprise Server sur Hyper-V

Prérequis

• Vous devez disposer d’un fichier de licence GitHub Enterprise. Pour plus d’informations, consultez « Configuration d’un essai de GitHub Enterprise Server » et « À propos des licences pour GitHub Enterprise ».
• Vous devez avoir Windows Server (versions 2008 à 2022) avec prise en charge d’Hyper-V.
• La plupart des actions nécessaires pour créer votre machine virtuelle peuvent également être effectuées à l’aide du Gestionnaire Hyper-V. Toutefois, nous vous recommandons d’utiliser l’interpréteur de ligne de commande Windows PowerShell pour la configuration initiale. Vous trouverez ci-après des exemples avec PowerShell. Pour plus d’informations, consultez le guide Microsoft Prise en main de Windows PowerShell.

Considérations matérielles

• Exigences minimales recommandées
• Stockage
• Processeur et mémoire

Exigences minimales recommandées

Nous recommandons différentes configurations matérielles en fonction du nombre de licences utilisateur pour votre instance GitHub Enterprise Server. Si vous approvisionnez plus de ressources que les exigences minimales recommandées, cela améliorera les performances et la mise à l’échelle de votre instance.

Licences utilisateur	Processeurs virtuels x86-64	Mémoire	Stockage racine	Stockage (de données) attaché	D’OPÉRATIONS D’E/S PAR SECONDE
Essai, démonstration ou 10 utilisateurs légers	4	32 Go	400 Go	500 Go	600
Jusqu’à 1 000	8	48 Go	400 Go	500 Go	3000
1 000 à 3 000	16	64 Go	400 Go	1 000 Go	6000
3 000 à 5 000	32	128 Go	400 Go	1 500 Go	9000
5 000 à 8 000	48	256 Go	400 Go	3 000 Go	12 000
8 000 à 10 000+	64	512 Go	400 Go	5 000 Go	15000

Si vous envisagez d’activer GitHub Actions ou GitHub Advanced Security pour les utilisateurs de votre instance, d’autres ressources sont requises.

• GitHub Actions - augmenter l'unité centrale et la mémoire d'au moins 25 %
• GitHub Advanced Security - augmenter le CPU et la mémoire d'au moins 25 %

Ces ajustements doivent être appliqués aux exigences de base pour chaque niveau utilisateur. Nous vous recommandons de surveiller toutes les modifications apportées à vos ressources, car d’autres augmentations peuvent être nécessaires.

Pour plus d’informations sur ces configurations requises, consultez « Bien démarrer avec GitHub Actions pour GitHub Enterprise Server ».

Si vous envisagez d’activer Container registry pour les utilisateurs de votre instance, d’autres ressources sont requises. Pour plus d’informations sur ces configurations requises, consultez « Bien démarrer avec GitHub Packages pour votre entreprise ».

Pour plus d’informations sur l’ajustement des ressources pour une instance existante, consultez « Augmentation de la capacité de stockage » et « Augmentation des ressources processeur ou mémoire ».

Stockage

Nous recommandons un disque SSD haute performance avec un nombre élevé d’IOPS et une faible latence pour GitHub Enterprise Server. Les charges de travail sont gourmandes en E/S. Si vous utilisez un hyperviseur nu, nous vous recommandons d’attacher directement le disque ou d’utiliser un disque d’un réseau de zone de stockage (SAN).

Votre instance nécessite un disque de données persistant séparé du disque racine. Pour plus d’informations, consultez « Vue d’ensemble du système ».

Pour configurer GitHub Actions, vous devez fournir un stockage d’objets blob externe. Pour plus d’informations, consultez « Bien démarrer avec GitHub Actions pour GitHub Enterprise Server ».

L’espace disponible sur le système de fichiers racine sera de 50 % de la taille totale du disque. Vous pouvez redimensionner le disque racine de votre instance en créant une nouvelle instance ou en utilisant une instance existante. Pour plus d’informations, consultez « Vue d’ensemble du système » et « Augmentation de la capacité de stockage ».

Processeur et mémoire

Les ressources processeur et mémoire que GitHub Enterprise Server requiert dépendent des niveaux d’activité pour les utilisateurs, les automatisations et les intégrations.

Toutes les machines virtuelles que vous provisionnez pour votre instance GitHub Enterprise Server doivent utiliser l’architecture de processeur x86-64. Les autres architectures ne sont pas prises en charge, telles que AAarch64 ou arm64.

Si vous envisagez d’activer GitHub Actions pour les utilisateurs de votre instance GitHub Enterprise Server, il se peut que vous deviez approvisionner des ressources processeur et mémoire supplémentaires pour celle-ci. Pour plus d’informations, consultez « Bien démarrer avec GitHub Actions pour GitHub Enterprise Server ».

Quand vous augmentez les ressources d’UC, GitHub vous recommande d’ajouter au moins 6,5 Go de mémoire par processeur virtuel (jusqu’à 16 processeurs virtuels) que vous approvisionnez pour l’instance. Lorsque vous utilisez plus de 16 processeurs virtuels, vous n’avez pas besoin d’ajouter 6,5 Go de mémoire par processeur virtuel, mais vous devez surveiller votre instance pour vous assurer qu’elle dispose de suffisamment de mémoire.

Pour plus d’informations sur la supervision de la capacité et des performances de GitHub Enterprise Server, consultez « Surveillance de votre instance ».

Vous pouvez augmenter les ressources processeur ou mémoire de votre instance. Pour plus d’informations, consultez « Augmentation des ressources processeur ou mémoire ».

Dois-je utiliser VMotion ?

VMotion peut être exceptionnellement utile pour la gestion générale des ressources, mais l’impact sur l’instance invitée peut être significatif. Avec des instances GitHub Enterprise Server plus importantes (8 CPU/64 GB RAM et plus), un événement VMotion peut entraîner une panne totale du GitHub Enterprise Server pour les utilisateurs finaux en raison d'une réduction considérable du CPU, de la RAM et des IOPS de stockage. Dans cette optique, GitHub Enterprise Server doit être considérée comme une application « très sensible à la latence ».

Pour les grands déploiements sur VMWare qui ont activé le Distributed Resource Scheduler (DRS), nous recommandons de configurer une règle d'affinité VM-to-Host pour votre GitHub Enterprise Server afin d'essayer de maintenir l'appliance virtuelle sur un seul hôte. Si une migration avec VMotion est nécessaire, nous recommandons de considérer ceci comme un « arrêt planifié », et de placer GitHub Enterprise Server en mode maintenance jusqu'à ce que la migration soit terminée.

Nous vous recommandons également de configurer le paramètre de gestion de l’alimentation ESXi sur « Hautes performances ». Nous avons vu des cas où les performances globales du système peuvent être affectées négativement si cela est laissé à « Équilibré ».

Téléchargement de l’image de GitHub Enterprise Server

1. Téléchargez votre licence. Pour plus d’informations, consultez « Téléchargement de votre licence pour GitHub Enterprise ».

2. Accédez à l’image que vous souhaitez utiliser pour votre nouvelle instance.

   • Accédez aux Notes de publication.
   • Sur la barre latérale droite, cliquez sur la version que vous souhaitez télécharger.
   • Cliquez sur Télécharger GitHub Enterprise Server X.X.X.

3. Sous « GitHub local », sélectionnez le menu déroulant « Sélectionnez votre hyperviseur », puis cliquez sur Hyper-V (VHD) .

4. Cliquez sur Télécharger pour Hyper-V (VHD) .

Création de l’instance GitHub Enterprise Server

Pour créer l’instance, vous devez importer l’image GitHub Enterprise Server sur votre machine virtuelle et attacher un volume de stockage supplémentaire pour vos données d’instance. Pour plus d’informations, consultez « Considérations matérielles ».

1. Dans PowerShell, créez une machine virtuelle de génération 1, configurez la taille en fonction du nombre de licences utilisateur et attachez l’image de GitHub Enterprise Server que vous avez téléchargée. Pour plus d’informations, consultez New-VM dans la documentation Microsoft.

   PS C:\> New-VM -Generation 1 -Name VM_NAME -MemoryStartupBytes MEMORY_SIZE -BootDevice VHD -VHDPath PATH_TO_VHD  
   

2. Créez un disque virtuel à utiliser comme volume de stockage attaché pour vos données d’instance, et configurez la taille en fonction du nombre de licences utilisateur. Si vous réutilisez un disque existant, vérifiez que le disque est vide et qu’il n’existe aucune partition. Remplacez PATH_TO_DATA_DISK par l’emplacement de création du disque. Pour plus d’informations, consultez « New-VHD » dans la documentation Microsoft.

   PS C:\> New-VHD -Path PATH_TO_DATA_DISK -SizeBytes DISK_SIZE
   

3. Attachez le disque de données à votre instance. Pour plus d’informations, consultez Add-VMHardDiskDrive dans la documentation Microsoft.

   PS C:\> Add-VMHardDiskDrive -VMName VM_NAME -Path PATH_TO_DATA_DISK
   

4. Démarrez la machine virtuelle. Pour plus d’informations, consultez Start-VM dans la documentation Microsoft.

   PS C:\> Start-VM -Name VM_NAME
   

5. Récupérez l’adresse IP de votre machine virtuelle. Pour plus d’informations, consultez Get-VMNetworkAdapter dans la documentation Microsoft.

   PS C:\> (Get-VMNetworkAdapter -VMName VM_NAME).IpAddresses
   

6. Copiez l’adresse IP de la machine virtuelle et collez-la dans un navigateur web.

Configuration de l’instance GitHub Enterprise Server

Pour configurer l’instance, vous devez charger un fichier de licence, définir le mot de passe racine Management Console, configurer les paramètres de l’instance et redémarrer l’instance.

1. Copiez le nom DNS public de la machine virtuelle et collez-le dans un navigateur web.
2. À l’invite, chargez votre fichier de licence et définissez un mot de passe pour la console de gestion. Pour plus d’informations, consultez « Gestion de votre licence pour GitHub Enterprise ».
3. Dans la Management Console, configurez et enregistrez les paramètres de votre choix. Pour plus d’informations, consultez « Configuration de GitHub Enterprise ».
4. L’instance redémarre automatiquement.
5. Cliquez sur Accéder à votre instance.

Pour aller plus loin

• « Vue d’ensemble du système »
• À propos des mises à niveau vers de nouvelles mises en production