Mise à niveau avec un patch à chaud

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 version de fonctionnalité, vous devez utiliser le shell d’administration.

        [Installation d’un patch à chaud en utilisant la Management Console](#installing-a-hotpatch-using-the-management-console)

        [Installation d’un patch à chaud à l’aide de la console d’administration](#installing-a-hotpatch-using-the-administrative-shell)

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 est présentée est une version de fonctionnalité et non une version corrective, vous ne pourrez pas utiliser la Management Console pour installer un correctif rapide. Au lieu de cela, vous devrez installer le patch à chaud à l’aide de l’interpréteur de commandes d’administration.

Activer les mises à jour automatiques. Pour plus d’informations, consultez « Activation de la recherche de mises à jour automatiques ».
À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.
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.
Cliquez sur Installer.

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

Remarque

Si vous avez activé les vérifications de mises à jour automatiques, vous n’avez pas besoin de télécharger le package de mise à niveau et pouvez utiliser le fichier qui a été téléchargé automatiquement. Pour plus d’informations, consultez « Activation de la recherche de mises à jour automatiques ».

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
```
```
ssh -p 122 admin@HOSTNAME
```
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).
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
```

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

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](#upgrading-the-primary-node-using-a-hotpatch)

        [Mise à niveau des nœuds supplémentaires à l’aide d’un patch à chaud](#upgrading-additional-nodes-using-a-hotpatch)

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 le nœud, suivez les instructions dans Installation d’un patch à chaud à l’aide de l’interpréteur de commandes d’administration.
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
```
Vérifiez la mise à niveau en exécutant :
```
ghe-version
```
Répétez les étapes ci-dessus pour chaque nœud supplémentaire.