Skip to main content

Installation de GitHub Enterprise Server sur Hyper-V

Pour installer GitHub Enterprise Server sur Hyper-V, vous devez le déployer sur un ordinateur exécutant Windows Server (de la version 2008 à la version 2019).

Prérequis

Considérations matérielles

Configuration minimale requise

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

Licences utilisateurProcesseurs virtuelsMémoireStockage racineStockage (de données) attaché
Essai, démonstration ou 10 utilisateurs légers432 Go200 Go150 Go
10 à 3 000848 Go200 Go300 Go
3 000 à 5 0001264 Go200 Go500 Go
5 000 à 8 0001696 Go200 Go750 Go
8 000 à 10 000+20160 Go200 Go1 000 Go

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

Processeurs virtuelsMémoireConcurrence maximale
864 Go740 travaux
16128 Go1 250 travaux
32160 Go2 700 travaux
64256 Go4 500 travaux
96384 Go7 000 travaux

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

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.

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

Lorsque vous augmentez les ressources du processeur, nous vous recommandons 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.

Avertissement : nous recommandons aux utilisateurs de configurer des événements de webhook pour avertir des systèmes externes de l’activité sur GitHub Enterprise Server. Les vérifications automatisées des modifications, ou l’interrogation, auront un impact négatif sur les performances et la scalabilité de votre instance. Pour plus d’informations, consultez « À propos des webhooks ».

Pour plus d’informations sur la supervision de la capacité et du niveau de performance de GitHub Enterprise Server, consultez « Supervision de votre appliance ».

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

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 ». 1. 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.
  2. Sous « GitHub local », sélectionnez le menu déroulant « Sélectionnez votre hyperviseur », puis cliquez sur Hyper-V (VHD) .

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

  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 l’appliance GitHub Enterprise Server ».
  2. L’instance redémarre automatiquement. 1. Cliquez sur Accéder à votre instance.

Pour aller plus loin