Augmentation de la capacité de stockage

À 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

Configuration minimale recommandée

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

Réparation des erreurs de système de fichiers

Si la vérification du système de fichiers échoue pendant ghe-storage-extend, procédez comme suit pour la réparer.

Vérifiez que l’appliance est en mode maintenance et qu’aucun travail en arrière-plan n’est en cours d’exécution :

ghe-maintenance -s
ghe-resque-info

ghe-maintenance -s
ghe-resque-info

1. Arrêtez et activez le volume utilisateur, puis exécutez une vérification forcée du système de fichiers (réponse automatique oui) :

   Shell

   sudo systemctl stop ghe-user-disk
   VGNAME=$(sudo lvs --noheadings -o vg_name | grep ghe_storage_ | awk '{ print $1 }')
   sudo vgchange -ay "$VGNAME"
   sudo vgscan --mknodes
   sudo fsck -fy /dev/mapper/${VGNAME}-ghe_user_data
   

2. Réessayez le redimensionnement :

   Shell

   ghe-storage-extend
   

3. Remontez et vérifiez la nouvelle taille :

   Shell

   sudo systemctl start ghe-user-disk
   df -h /data/user
   

4. Redémarrez et vérifiez :

   Shell

   sudo reboot
   df -h /data/user
   

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

Avant de redimensionner la partition racine, déterminez si l'appliance possède une table de partition GUID.

Sur les instances créées à partir des versions GHES 3.14 et ultérieures, suivez les instructions de la section Augmenter la taille de la partition racine sur une table de partition GUID.

Sur les instances créées à partir de versions GHES antérieures à 3.14, suivez les instructions de la section Augmenter la taille de la partition racine sur une table de partition héritée.

Pour vérifier le type de table de partition, exécutez la commande suivante. Le résultat doit être soit gpt, soit msdos.

sudo lsblk -no pttype $(findmnt -no source /)

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.

Augmenter la taille de la partition racine sur une table de partition GUID

1. Sauvegardez votre partition de démarrage EFI existante :

   sudo dd if=/dev/disk/by-label/EFIBOOT of=EFIBOOT.bak bs=1M
   

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

   sudo parted /dev/xvdg mklabel gpt
   sudo parted -a optimal /dev/xvdg mkpart bios fat32 1MiB 2MiB
   sudo parted /dev/xvdg set 1 bios_grub on
   sudo parted -a optimal /dev/xvdg mkpart efi fat32 2MiB 512MiB
   sudo parted /dev/xvdg set 2 esp on
   sudo parted -a optimal /dev/xvdg mkpart primary 512MiB 50%
   sudo parted /dev/xvdg set 3 boot off
   sudo parted /dev/xvdg set 3 esp off
   sudo parted -a optimal /dev/xvdg mkpart primary 50% 100%
   

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

4. 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/xvdg3
   

5. Exécutez ces commandes sur les partitions secondaires du disque nouvellement ajouté :

   sudo dd if=/dev/disk/by-label/EFIBOOT of=/dev/xvdg2 bs=1M
   sudo mkfs.ext4 -L fallback /dev/xvdg4
   

6. Arrêtez l’appliance :

   sudo poweroff
   

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

8. Démarrez l’appliance.

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

Augmenter la taille de la partition racine sur une table de partition héritée

1. 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%
   

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

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

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

   sudo mkfs.ext4 -L fallback /dev/xvdg2
   

5. Arrêtez l’appliance :

   sudo poweroff
   

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

7. Démarrez l’appliance.

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