Mise à niveau avec un patch à chaud

Vous pouvez mettre à niveau GitHub Enterprise Server vers la dernière version corrective en utilisant un patch à chaud.

Vous pouvez utiliser la mise à niveau à chaud pour effectuer une mise à niveau vers une version de correctif plus récente, mais pas une mise en production de fonctionnalité. Par exemple, vous pouvez effectuer une mise à niveau de 2.10.1 vers 2.10.5, parce qu’ils sont dans la même série de fonctionnalités, mais pas de 2.10.9 vers 2.11.0 parce qu’ils sont dans des séries de fonctionnalités différentes.

Les mises à jour correctives à chaud ne nécessitent pas toujours de redémarrage. Lorsque vous installez le correctif à chaud, un message s’affiche dans le terminal si l’un des packages a besoin d’un redémarrage pour terminer la mise à jour. Vous pouvez planifier ce redémarrage à un moment commode, mais nous vous recommandons de redémarrer dès que possible, en particulier s’il existe des correctifs de sécurité.

Les patchs à chaud nécessitent une exécution de configuration, qui peut provoquer une brève période d’erreurs ou d’absence de réponse pour tout ou partie des services sur votre instance GitHub Enterprise Server. Vous n’êtes pas obligé d’activer le mode maintenance pendant l’installation d’un patch à chaud, mais cela garantit que les utilisateurs voient une page de maintenance au lieu de messages d’erreur ou d’expiration de délai. Consultez « Activation et planification du mode de maintenance ».

La Management Console vous permet d’installer un patch à chaud immédiatement ou de planifier une installation ultérieure. Vous pouvez utiliser l’interpréteur de commandes d’administration pour installer un patch à chaud avec l’utilitaire ghe-upgrade. Consultez « Vue d'ensemble du processus de mise à niveau » et « Conditions à remplir pour la mise à niveau. »

Mise à niveau d’une instance autonome en utilisant un patch à chaud

Si vous mettez à niveau une instance avec un nœud à l’aide d’un patch à chaud et que votre cible est une version corrective, vous pouvez effectuer la mise à niveau en utilisant la Management Console. Pour effectuer une mise à niveau vers une mise en production de fonctionnalité, vous devez utiliser l’interpréteur de commandes d’administration.

• Installation d’un patch à chaud à l’aide de la Management Console
• Installation d’un patch à chaud à l’aide de l’interpréteur de commandes d’administration

Installation d’un patch à chaud à l’aide de la Management Console

Vous pouvez utiliser la Management Console pour effectuer une mise à niveau avec un patch à chaud en activant les mises à jour automatiques. La dernière version disponible de GitHub Enterprise Server vers laquelle effectuer une mise à niveau vous sera alors présentée.

Si la cible de mise à niveau qui vous êtes présentée est une mise en production de fonctionnalité et non une version corrective, vous ne pourrez pas utiliser vous servir de la Management Console pour installer un patch à chaud. Au lieu de cela, vous devrez installer le patch à chaud à l’aide de l’interpréteur de commandes d’administration.

1. Activer les mises à jour automatiques. Pour plus d’informations, consultez « Activation de la recherche de mises à jour automatiques ».

2. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.

3. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.

4. Dans la barre latérale «  Administrateur de site », cliquez sur Management Console .

5. Dans la barre de navigation supérieure, cliquez sur Mises à jour.

   

6. Après avoir téléchargé un nouveau patch à chaud, sélectionnez le menu déroulant Installer le package.

   • Pour l’installer immédiatement, cliquez sur Maintenant.
   • Pour une installation ultérieure, sélectionnez une date ultérieure.

7. Cliquez sur Installer.

Installation d’un patch à chaud à l’aide de l’interpréteur de commandes d’administration

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

2. Accédez à la page des versions de GitHub Enterprise Server. En regard de la version vers laquelle vous effectuez une mise à niveau, cliquez sur Télécharger, puis sur l’onglet Mise à niveau. Copiez l’URL du package à chaud de mise à niveau (fichier .hpkg).

3. Téléchargez le package de mise à niveau sur votre instance GitHub Enterprise Server en utilisant curl :

   admin@HOSTNAME:~$ curl -L -O UPGRADE-PKG-URL
   

4. Exécutez la commande ghe-upgrade en utilisant le nom de fichier du package :

   admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg
   *** verifying upgrade package signature...
   

5. Si au moins un service ou un composant système nécessite de redémarrer, le script de mise à niveau du patch à chaud vous en avertit. Par exemple, les mises à jour de noyau, de MySQL ou d’Elasticsearch peuvent nécessiter un redémarrage.

Mise à niveau d’une instance avec plusieurs nœuds en utilisant un patch à chaud

Si vous installez un patch à chaud, vous n’avez pas besoin de passer en mode maintenance ou d’arrêter la réplication.

• Mise à niveau du nœud principal à l’aide d’un patch à chaud
• Mise à niveau des nœuds supplémentaires à l’aide d’un patch à chaud

Mise à niveau du nœud principal à l’aide d’un patch à chaud

Pour obtenir des instructions permettant de mettre à niveau le nœud principal, consultez « Installation d’un patch à chaud à l’aide de l’interpréteur de commandes d’administration ».

Mise à niveau des nœuds supplémentaires à l’aide d’un patch à chaud

Pour mettre à niveau une instance qui comprend plusieurs nœuds, tels qu’une configuration de haute disponibilité ou de géoréplication, vous devez répéter la procédure suivante sur chaque nœud de réplica, un par un.

1. Pour mettre à niveau le nœud, suivez les instructions dans « Installation d’un patch à chaud à l’aide de l’interpréteur de commandes d’administration ».

2. Connectez-vous au nœud de réplica via SSH en tant qu’utilisateur admin sur le port 122 :

   ssh -p 122 admin@REPLICA_HOST
   

3. Vérifiez la mise à niveau en exécutant :

   ghe-version
   

4. Répétez les étapes ci-dessus pour chaque nœud supplémentaire.