Avertissement : Le processus d’allocation de nouvelles ressources système varie selon la plateforme de virtualisation et le type de ressource. Vous devez toujours configurer le monitoring et l’alerte des ressources système clés. Pour plus d’informations, consultez « Surveillance de votre instance ».
Remarque : Avant d’augmenter les ressources liées au processeur ou à la mémoire, mettez votre instance en mode maintenance. Vous pouvez valider les changements apportés en configurant une liste d’exceptions IP pour autoriser l’accès à partir des adresses IP spécifiées. Pour plus d’informations, consultez « Activation et planification du mode de maintenance ».
Ajout de ressources processeur ou mémoire pour AWS
Remarque : Pour ajouter des ressources processeur ou mémoire pour AWS, vous devez savoir utiliser la console de gestion AWS ou l’interface de ligne de commande aws ec2
pour gérer les instances EC2. Pour plus d’informations sur l’utilisation des outils AWS que vous choisirez pour effectuer le redimensionnement, consultez la documentation AWS sur le redimensionnement d’une instance Amazon EBS.
Considérations relatives au redimensionnement pour AWS
Avant d’augmenter les ressources processeur ou mémoire pour votre instance GitHub Enterprise Server, prenez connaissance des recommandations suivantes.
- Mettez à l’échelle votre mémoire avec des processeurs. 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.
- Attribuez une adresse IP élastique à l’instance. Si vous n’avez pas affecté d’adresse IP élastique à votre instance, vous devrez ajuster les enregistrements A DNS de votre hôte GitHub Enterprise Server après le redémarrage pour prendre en compte la modification au niveau de l’adresse IP publique. Une fois que votre instance a redémarré, elle conserve l’adresse IP élastique si vous l’avez lancée dans un cloud privé virtuel (VPC). Si vous créez l’instance dans un réseau EC2-Classic, vous devez réattribuer manuellement l’adresse IP élastique à l’instance.
Types d’instances AWS pris en charge
Vous devez déterminer le type d’instance que vous souhaitez mettre à niveau en fonction des spécifications de processeur/mémoire.
Remarque : Vous pouvez toujours faire un scale-up de votre processeur ou de votre mémoire en redimensionnant votre instance. Toutefois, parce que le redimensionnement de votre processeur ou de votre mémoire nécessite un temps d’arrêt pour vos utilisateurs, nous vous recommandons de surprovisionner les ressources pour prendre en compte la mise à l’échelle.
GitHub recommande une instance à mémoire optimisée pour GitHub Enterprise Server. Pour plus d’informations, consultez Types d’instances Amazon EC2 sur le site web Amazon EC2.
Redimensionnement pour AWS
Remarque : Pour les instances lancées dans EC2-Classic, notez à la fois l’adresse IP élastique associée à l’instance et l’ID de l’instance. Une fois que vous avez redémarré l’instance, réassociez l’adresse IP élastique.
Il n’est pas possible d’ajouter des ressources processeur ou mémoire à une instance AWS/EC2 existante. Vous devez à la place :
- Arrêter l’instance.
- Changer de type d’instance.
- Démarrer l'instance.
- Une fois que l’instance a entièrement redémarré et que vous pouvez l’atteindre, utilisez l’interpréteur de commandes d’administration SSH pour vérifier que la nouvelle configuration de ressource est reconnue :
ssh -p 122 admin@HOSTNAME
ghe-system-info
Ajout de ressources processeur ou mémoire sur Microsoft Azure
Remarque : Pour ajouter des ressources processeur ou mémoire dans Microsoft Azure, vous devez savoir gérer les instances de machine virtuelle à l’aide du portail Azure, d’Azure CLI ou d’Azure PowerShell. Pour plus d’informations sur l’utilisation des outils Azure que vous choisirez pour effectuer le redimensionnement, consultez la documentation Azure sur le changement de taille d’une machine virtuelle.
Considérations relatives au redimensionnement pour Microsoft Azure
Avant d’augmenter les ressources processeur ou mémoire pour votre instance GitHub Enterprise Server, prenez connaissance des recommandations suivantes.
- Mettez à l’échelle votre mémoire avec des processeurs. 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.
- Attribuez une adresse IP statique à l’instance. Si vous n’avez pas affecté d’adresse IP statique à votre instance, vous devrez peut-être ajuster les enregistrements A DNS de votre hôte GitHub Enterprise Server après le redémarrage pour prendre en compte la modification au niveau de l’adresse IP publique.
Tailles d’instance Microsoft Azure prises en charge
Vous devez déterminer la taille d’instance que vous souhaitez mettre à niveau en fonction des spécifications de processeur/mémoire.
Remarque : Vous pouvez toujours faire un scale-up de votre processeur ou de votre mémoire en redimensionnant votre instance. Toutefois, parce que le redimensionnement de votre processeur ou de votre mémoire nécessite un temps d’arrêt pour vos utilisateurs, nous vous recommandons de surprovisionner les ressources pour prendre en compte la mise à l’échelle.
L’appliance GitHub Enterprise Server nécessite un disque de données de stockage Premium et est prise en charge sur n’importe quelle machine virtuelle Azure qui prend en charge le stockage Premium. Les types de machines virtuelles Azure avec le suffixe s
prennent en charge le stockage Premium. Pour plus d’informations, consultez Quels sont les types de disque disponibles dans Azure ? et « Stockage Azure Premium : conception sous le signe de la haute performance » dans la documentation Azure.
GitHub recommande une machine virtuelle optimisée en mémoire pour GitHub Enterprise Server. Pour plus d’informations, consultez « Tailles de machine virtuelle à mémoire optimisée » dans la documentation Azure.
GitHub Enterprise Server prend en charge n’importe quelle région qui prend en charge votre type de machine virtuelle. Pour plus d’informations sur les régions prises en charge pour chaque machine virtuelle, consultez « Disponibilité des produits par région » d’Azure.
Redimensionnement pour Microsoft Azure
Vous pouvez effectuer un scale-up de la machine virtuelle en changeant sa taille. Le changement de taille provoquera son redémarrage. Dans certains cas, vous devez commencer par libérer la machine virtuelle. Cela peut se produire si la nouvelle taille n’est pas disponible sur le cluster matériel qui héberge actuellement la machine virtuelle.
- Consultez la documentation Azure sur le changement de taille d’une machine virtuelle pour savoir comment procéder.
- Une fois que l’instance a entièrement redémarré et que vous pouvez l’atteindre, utilisez l’interpréteur de commandes d’administration SSH pour vérifier que la nouvelle configuration de ressource est reconnue :
ssh -p 122 admin@HOSTNAME
ghe-system-info
Ajout de ressources processeur ou mémoire pour OpenStack KVM
Il n’est pas possible d’ajouter des ressources processeur ou mémoire à une instance OpenStack KVM existante. Vous devez à la place :
- Capturer un instantané de l’instance active.
- Arrêter l’instance.
- Sélectionner une nouvelle version d’instance qui a les ressources processeur et/ou de mémoire souhaitées.
Ajout de ressources processeur ou mémoire pour VMware
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.
- Utilisez le client vSphere pour vous connecter à l’hôte VMware ESXi.
- Arrêtez votre instance GitHub Enterprise Server.
- Sélectionnez la machine virtuelle, puis cliquez sur Modifier les paramètres.
- Sous « Matériel », ajustez les ressources processeur et/ou mémoire allouées à la machine virtuelle en fonction des besoins.
- Pour démarrer la machine virtuelle, cliquez sur OK.
- Une fois que l’instance a entièrement redémarré et que vous pouvez l’atteindre, utilisez l’interpréteur de commandes d’administration SSH pour vérifier que la nouvelle configuration de ressource est reconnue :
ssh -p 122 admin@HOSTNAME
ghe-system-info