À propos du remplacement de nœuds de cluster GitHub Enterprise Server
Vous pouvez remplacer un nœud fonctionnel dans un cluster GitHub Enterprise Server ou remplacer un nœud qui a échoué de manière inattendue.
Avertissement : Pour éviter les conflits, ne réutilisez pas un nom d’hôte précédemment attribué à un nœud du cluster.
Remplacement d’un nœud fonctionnel
Vous pouvez remplacer un nœud fonctionnel existant dans votre cluster. Par exemple, vous voudrez peut-être fournir à une machine virtuelle des ressources de processeur, de mémoire ou de stockage supplémentaires.
Pour remplacer un nœud fonctionnel, installez l’appliance GitHub Enterprise Server sur une nouvelle machine virtuelle, configurez une adresse IP, ajoutez le nouveau nœud au fichier de configuration du cluster, initialisez le cluster et appliquez la configuration, puis mettez le nœud que vous avez remplacé hors connexion.
-
Provisionnez et installez GitHub Enterprise Server avec un nom d’hôte unique sur le nœud de remplacement.
-
En utilisant l’interpréteur de commandes d’administration ou DHCP, configurez uniquement l’adresse IP du nœud de remplacement. Ne configurez pas d’autres paramètres.
-
Pour ajouter le nœud de remplacement nouvellement provisionné, sur n’importe quel nœud, modifiez le fichier
cluster.conf
pour supprimer le nœud ayant échoué et ajouter le nœud de remplacement. Par exemple, ce fichiercluster.conf
modifié remplaceghe-data-node-3
par le nœud nouvellement provisionné,ghe-replacement-data-node-3
:[cluster "ghe-replacement-data-node-3"] hostname = ghe-replacement-data-node-3 ipv4 = 192.168.0.7 # ipv6 = fd12:3456:789a:1::7 git-server = true pages-server = true mysql-server = true elasticsearch-server = true redis-server = true memcache-server = true metrics-server = true storage-server = true
-
À partir de l’interpréteur de commandes d’administration du nœud avec le
cluster.conf
modifié, exécutezghe-cluster-config-init
. Cette commande initialise le nœud nouvellement ajouté dans le cluster. -
À partir du même nœud, exécutez
ghe-cluster-config-apply
. Cette commande valide le fichier de configuration, le copie sur chaque nœud du cluster et configure chaque nœud en fonction du fichiercluster.conf
modifié. -
Si vous prenez un nœud hors connexion qui fournit des services de données, tels que
git-server
,pages-server
oustorage-server
, évacuez le nœud. Pour plus d’informations, consultez « Évacuation d’un nœud de cluster exécutant des services de données ». -
Pour marquer le nœud défaillant hors connexion, sur n’importe quel nœud, modifiez le fichier de configuration du cluster (
cluster.conf
) dans la section de nœud appropriée pour inclure le texteoffline = true
.Par exemple, ce fichier
cluster.conf
modifié marque le nœudghe-data-node-3
comme étant hors connexion :[cluster "ghe-data-node-3"] hostname = ghe-data-node-3 offline = true ipv4 = 192.168.0.6 # ipv6 = fd12:3456:789a:1::6
-
À partir de l’interpréteur de commandes d’administration du nœud où vous avez modifié
cluster.conf
, exécutezghe-cluster-config-apply
. Cette commande valide le fichier de configuration, le copie sur chaque nœud du cluster et marque le nœud comme étant hors connexion. -
Si vous remplacez le nœud MySQL ou Redis principal, dans
cluster.conf
, modifiez la valeurmysql-master
ouredis-master
avec le nom du nœud de remplacement.Par exemple, ce fichier
cluster.conf
modifié spécifie un nœud de cluster nouvellement approvisionné,ghe-replacement-data-node-1
, en tant que nœud MySQL et Redis principal :mysql-master = ghe-replacement-data-node-1 redis-master = ghe-replacement-data-node-1
Remplacement d’un nœud en cas d’urgence
Vous pouvez remplacer un nœud défaillant dans votre cluster. Par exemple, un problème logiciel ou matériel peut affecter la disponibilité d’un nœud.
Pour remplacer un nœud en cas d’urgence, installez l’appliance GitHub Enterprise Server sur une nouvelle machine virtuelle, configurez une adresse IP, mettez le nœud défaillant hors connexion, appliquez la configuration, ajoutez le nouveau nœud au fichier de configuration du cluster, initialisez le cluster et appliquez la configuration, et éventuellement, évacuez le nœud défaillant.
-
Provisionnez et installez GitHub Enterprise Server avec un nom d’hôte unique sur le nœud de remplacement.
-
En utilisant l’interpréteur de commandes d’administration ou DHCP, configurez uniquement l’adresse IP du nœud de remplacement. Ne configurez pas d’autres paramètres.
-
Pour marquer le nœud défaillant hors connexion, sur n’importe quel nœud, modifiez le fichier de configuration du cluster (
cluster.conf
) dans la section de nœud appropriée pour inclure le texteoffline = true
.Par exemple, ce fichier
cluster.conf
modifié marque le nœudghe-data-node-3
comme étant hors connexion :[cluster "ghe-data-node-3"] hostname = ghe-data-node-3 offline = true ipv4 = 192.168.0.6 # ipv6 = fd12:3456:789a:1::6
-
À partir de l’interpréteur de commandes d’administration du nœud où vous avez modifié
cluster.conf
, exécutezghe-cluster-config-apply
. Cette commande valide le fichier de configuration, le copie sur chaque nœud du cluster et marque le nœud comme étant hors connexion. -
Pour ajouter le nœud de remplacement nouvellement provisionné, sur n’importe quel nœud, modifiez le fichier
cluster.conf
pour supprimer le nœud ayant échoué et ajouter le nœud de remplacement. Par exemple, ce fichiercluster.conf
modifié remplaceghe-data-node-3
par le nœud nouvellement provisionné,ghe-replacement-data-node-3
:[cluster "ghe-replacement-data-node-3"] hostname = ghe-replacement-data-node-3 ipv4 = 192.168.0.7 # ipv6 = fd12:3456:789a:1::7 git-server = true pages-server = true mysql-server = true elasticsearch-server = true redis-server = true memcache-server = true metrics-server = true storage-server = true
-
Si vous remplacez le nœud MySQL ou Redis principal, dans
cluster.conf
, modifiez la valeurmysql-master
ouredis-master
avec le nom du nœud de remplacement.Par exemple, ce fichier
cluster.conf
modifié spécifie un nœud de cluster nouvellement approvisionné,ghe-replacement-data-node-1
, en tant que nœud MySQL et Redis principal :mysql-master = ghe-replacement-data-node-1 redis-master = ghe-replacement-data-node-1
-
À partir de l’interpréteur de commandes d’administration du nœud avec le
cluster.conf
modifié, exécutezghe-cluster-config-init
. Cette commande initialise le nœud nouvellement ajouté dans le cluster. -
À partir du même nœud, exécutez
ghe-cluster-config-apply
. Cette commande valide le fichier de configuration, le copie sur chaque nœud du cluster et configure chaque nœud en fonction du fichiercluster.conf
modifié. -
Si vous prenez un nœud hors connexion qui fournit des services de données, tels que
git-server
,pages-server
oustorage-server
, évacuez le nœud. Pour plus d’informations, consultez « Évacuation d’un nœud de cluster exécutant des services de données ».