Augmentation de la capacité de stockage

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

À mesure que le nombre d’utilisateurs rejoignant votre instance GitHub Enterprise Server augmente, vous pouvez être amené à redimensionner votre volume de stockage. Consultez la documentation de votre plateforme de virtualisation pour plus d’informations sur le redimensionnement du stockage.

Conditions requises et recommandations

Exigences minimales recommandées

Licences utilisateur	Processeurs virtuels x86-64	Mémoire	Stockage racine	Stockage (de données) attaché
Essai, démonstration ou 10 utilisateurs légers	4	32 Go	200 Go	150 Go
10 à 3 000	8	48 Go	200 Go	300 Go
3 000 à 5 000	12	64 Go	200 Go	500 Go
5 000 à 8 000	16	96 Go	200 Go	750 Go
8 000 à 10 000+	20	160 Go	200 Go	1 000 Go

Le stockage racine fait référence à la taille totale du disque racine de votre instance. L’espace disponible sur le système de fichiers racine est de 50 % du stockage total disponible sur le disque racine. Pour plus d’informations, consultez « Vue d’ensemble du système ».

Augmentation de la taille de partition de données

1. Redimensionnez le disque de volume utilisateur existant à l’aide des outils de votre plateforme de virtualisation.

2. Connexion SSH à votre instance GitHub Enterprise Server. Si votre instance comprend plusieurs nœuds, par exemple si la haute disponibilité ou la géoréplication sont configurées, connectez-vous via SSH au nœud principal. Si vous utilisez un cluster, vous pouvez vous connecter via SSH à n’importe quel nœud. Remplacez HOSTNAME par le nom d’hôte de votre instance, le nom d’hôte ou l’adresse IP d’un nœud. Pour plus d’informations, consultez « Accès à l’interpréteur de commandes d’administration (SSH) ».

   Shell

   ssh -p 122 admin@HOSTNAME
   

3. Faites passer l’appliance en mode maintenance. Pour plus d’informations, consultez « Activation et planification du mode de maintenance ».

4. Redémarrez l’appliance pour détecter la nouvelle allocation de stockage :

   sudo reboot
   

5. Exécutez la commande ghe-storage-extend pour développer le système de fichiers /data/user :

   ghe-storage-extend
   

6. Vérifiez que les services système fonctionnent correctement, puis quittez le mode maintenance. Pour plus d’informations, consultez « Activation et planification du mode de maintenance ».

Augmentation de la taille de partition racine en utilisant une nouvelle appliance

1. Configurez une nouvelle instance de GitHub Enterprise Server avec un disque racine plus grand utilisant la même version que votre appliance actuelle. Pour plus d’informations, consultez « Configuration d’une instance GitHub Enterprise Server ».

2. Arrêtez l’appliance actuelle :

   sudo poweroff
   

3. Détachez le disque de données de l’appliance actuelle à l’aide des outils de votre plateforme de virtualisation.

4. Attachez le disque de données à la nouvelle appliance avec le disque racine de taille supérieure.

Augmentation de la taille de partition racine en utilisant une nouvelle appliance

1. Attachez un nouveau disque à votre appliance GitHub Enterprise Server.

2. Exécutez la commande lsblk pour identifier le nom d’appareil du nouveau disque.

3. Exécutez la commande parted pour formater le disque, avec le nom de votre appareil par /dev/xvdg :

   sudo parted /dev/xvdg mklabel msdos
   sudo parted /dev/xvdg mkpart primary ext4 0% 50%
   sudo parted /dev/xvdg mkpart primary ext4 50% 100%
   

4. Si votre appliance est configurée pour la haute disponibilité ou la géoréplication, pour arrêter la réplication, exécutez la commande ghe-repl-stop sur chaque nœud de réplica :

   ghe-repl-stop
   

5. Pour installer le logiciel GitHub Enterprise Server sur le disque nouvellement partitionné, exécutez la commande ghe-upgrade. Vous devez remplacer PACKAGE-NAME.pkg par le chemin d’accès à un package de mise à niveau spécifique à la plateforme qui correspond à la version de GitHub Enterprise Server déjà en cours d’exécution sur l’appliance. Vous ne pouvez pas utiliser un package de mise à niveau à chaud universel comme github-enterprise-2.11.9.hpkg. Après que la commande ghe-upgrade a abouti, les services d’application se terminent automatiquement.

   ghe-upgrade PACKAGE-NAME.pkg -s -t /dev/xvdg1
   

6. Exécutez la commande sur la partition secondaire du disque nouvellement ajouté :

   sudo mkfs.ext4 -L fallback /dev/xvdg2
   

7. Arrêtez l’appliance :

   sudo poweroff
   

8. Dans l’hyperviseur, supprimez l’ancien disque racine et attachez le nouveau au même emplacement que l’ancien disque racine.

9. Démarrez l’appliance.

10. Vérifiez que les services système fonctionnent correctement, puis quittez le mode maintenance. Pour plus d’informations, consultez « Activation et planification du mode de maintenance ».

Si votre appliance est configurée pour la haute disponibilité ou la géoréplication, pensez à lancer la réplication sur chaque nœud réplica à l’aide de ghe-repl-start après que le stockage a été mis à niveau sur tous les nœuds.