Chapitre 6. Préparation d'une mise à jour EUS-to-EUS
En raison de la conception fondamentale de Kubernetes, toutes les mises à jour d'OpenShift Container Platform entre les versions mineures doivent être sérialisées. Vous devez mettre à jour OpenShift Container Platform <4.y> vers <4.y 1>, puis vers <4.y 2>. Vous ne pouvez pas mettre à jour OpenShift Container Platform <4.y> vers <4.y 2> directement. Cependant, les administrateurs qui souhaitent effectuer une mise à jour entre deux versions Extended Update Support (EUS) peuvent le faire en ne subissant qu'un seul redémarrage des hôtes ne faisant pas partie du plan de contrôle.
Les mises à jour EUS-to-EUS ne sont viables qu'entre even-numbered minor versions d'OpenShift Container Platform.
Il y a un certain nombre de mises en garde à prendre en compte lors d'une mise à jour EUS-to-EUS.
-
Les mises à jour EUS-to-EUS ne sont proposées que lorsque les mises à jour entre toutes les versions concernées ont été mises à disposition sur les canaux
stable
. - Si vous rencontrez des problèmes pendant ou après la mise à jour vers la version mineure impaire mais avant la mise à jour vers la version paire suivante, la résolution de ces problèmes peut nécessiter que les hôtes du plan de contrôle terminent la mise à jour vers la version impaire avant d'aller de l'avant.
- Vous pouvez effectuer une mise à jour partielle en mettant à jour les nœuds du pool de travail ou du pool personnalisé pour tenir compte du temps nécessaire à la maintenance.
- Vous pouvez terminer le processus de mise à jour pendant plusieurs fenêtres de maintenance en vous arrêtant à des étapes intermédiaires. Cependant, prévoyez de terminer la mise à jour complète dans les 60 jours. Ce délai est essentiel pour garantir l'achèvement des processus normaux d'automatisation des clusters, y compris ceux associés à la rotation des certificats.
- Jusqu'à ce que les pools de configuration des machines soient désactivés et que la mise à jour soit terminée, certaines fonctionnalités et corrections de bogues dans <4.y 1> et <4.y 2> d'OpenShift Container Platform ne sont pas disponibles.
-
Tous les clusters peuvent se mettre à jour en utilisant les canaux EUS pour une mise à jour conventionnelle sans pause des pools, mais seuls les clusters avec des objets
MachineConfigPools
sans plan de contrôle peuvent effectuer une mise à jour EUS-to-EUS avec pause des pools.
6.1. Mise à jour EUS-to-EUS Copier lienLien copié sur presse-papiers!
La procédure suivante met en pause tous les pools de configuration de machines non maîtres et effectue les mises à jour de OpenShift Container Platform <4.y> vers <4.y 1> vers <4.y 2>, puis annule les pools de configuration de machines précédemment mis en pause. Cette procédure permet de réduire la durée totale des mises à jour et le nombre de redémarrages des nœuds de travail.
Conditions préalables
- Consultez les notes de version pour OpenShift Container Platform <4.y 1> et <4.y 2>
- Examinez les notes de mise à jour et les cycles de vie des produits en couches et des opérateurs OLM (Operator Lifecycle Manager). Certains peuvent nécessiter des mises à jour avant ou pendant une mise à jour EUS-to-EUS.
- Assurez-vous que vous connaissez les conditions préalables spécifiques à la version, telles que la suppression des API obsolètes, qui sont requises avant la mise à jour de OpenShift Container Platform <4.y 1> vers <4.y 2>.
6.1.1. Mise à jour EUS-to-EUS à l'aide de la console web Copier lienLien copié sur presse-papiers!
Conditions préalables
- Vérifiez que les pools de configuration des machines sont désactivés.
-
Avoir accès à la console web en tant qu'utilisateur avec les privilèges
admin
.
Procédure
- En utilisant la perspective de l'administrateur sur la console web, mettez à jour tous les opérateurs OLM (Operator Lifecycle Manager) vers les versions compatibles avec la version mise à jour que vous souhaitez obtenir. Vous trouverez de plus amples informations sur la manière d'effectuer cette action dans la section "Mise à jour des opérateurs installés" ; voir "Ressources supplémentaires".
Vérifiez que tous les pools de configuration de machines affichent un état de
Up to date
et qu'aucun pool de configuration de machines n'affiche un état deUPDATING
.Pour afficher l'état de tous les pools de configuration de machines, cliquez sur Compute
MachineConfigPools et examinez le contenu de la colonne Update status. NoteSi les pools de configuration de votre machine ont un statut
Updating
, veuillez attendre que ce statut passe àUp to date
. Ce processus peut prendre plusieurs minutes.Réglez votre chaîne sur
eus-<4.y 2>
.Pour définir votre canal, cliquez sur Administration
Cluster Settings Channel. Vous pouvez modifier votre chaîne en cliquant sur la chaîne actuelle en hyperlien. - Mettez en pause tous les pools de machines de travail, à l'exception du pool principal. Vous pouvez effectuer cette action dans l'onglet MachineConfigPools sous la page Compute. Sélectionnez les ellipses verticales à côté du pool de configuration de machines que vous souhaitez mettre en pause et cliquez sur Pause updates.
- Mettez à jour vers la version <4.y 1> et complétez jusqu'à l'étape Save. Vous trouverez plus d'informations sur la manière d'effectuer ces actions dans "Mise à jour d'un cluster à l'aide de la console Web" ; voir "Ressources supplémentaires".
- Assurez-vous que les mises à jour <4.y 1> sont complètes en consultant le site Last completed version de votre cluster. Vous trouverez ces informations sur la page Cluster Settings, sous l'onglet Details.
- Si nécessaire, mettez à jour vos opérateurs OLM en utilisant la perspective de l'administrateur dans la console web. Vous trouverez plus d'informations sur la manière d'effectuer ces actions dans "Mise à jour des opérateurs installés" ; voir "Ressources supplémentaires".
- Mettez à jour vers la version <4.y 2> et complétez jusqu'à l'étape Save. Vous trouverez plus d'informations sur la manière d'effectuer ces actions dans "Mise à jour d'un cluster à l'aide de la console Web" ; voir "Ressources supplémentaires".
- Assurez-vous que la mise à jour <4.y 2> est terminée en consultant le site Last completed version de votre cluster. Vous trouverez ces informations sur la page Cluster Settings, sous l'onglet Details.
Désactiver tous les pools de configuration de machines précédemment mis en pause. Vous pouvez effectuer cette action dans l'onglet MachineConfigPools sous la page Compute. Sélectionnez les ellipses verticales à côté du pool de configuration de machines que vous souhaitez mettre en pause et cliquez sur Unpause updates.
ImportantSi les pools ne sont pas désactivés, la grappe n'est pas autorisée à passer à une version mineure ultérieure et les tâches de maintenance telles que la rotation des certificats sont inhibées. La grappe risque donc de se dégrader à l'avenir.
Vérifiez que les pools précédemment mis en pause sont mis à jour et que votre cluster a terminé la mise à jour vers la version <4.y 2>.
Vous pouvez vérifier que vos pools ont été mis à jour dans l'onglet MachineConfigPools sous la page Compute en confirmant que la valeur de Update status est Up to date.
Vous pouvez vérifier que votre cluster a terminé la mise à jour en consultant le site Last completed version de votre cluster. Vous trouverez ces informations sur la page Cluster Settings, sous l'onglet Details.
6.1.2. Mise à jour EUS-to-EUS à l'aide de la CLI Copier lienLien copié sur presse-papiers!
Conditions préalables
- Vérifiez que les pools de configuration des machines sont désactivés.
-
Mettre à jour l'OpenShift CLI (
oc
) à la version cible avant chaque mise à jour.
Il est fortement déconseillé d'ignorer ce prérequis. Si l'OpenShift CLI (oc
) n'est pas mis à jour à la version cible avant votre mise à jour, des problèmes inattendus peuvent survenir.
Procédure
- En utilisant la perspective de l'administrateur sur la console web, mettez à jour tous les opérateurs OLM (Operator Lifecycle Manager) vers les versions compatibles avec la version mise à jour que vous souhaitez obtenir. Vous trouverez de plus amples informations sur la manière d'effectuer cette action dans la section "Mise à jour des opérateurs installés" ; voir "Ressources supplémentaires".
Vérifiez que tous les pools de configuration de machines affichent un état de
UPDATED
et qu'aucun pool de configuration de machines n'affiche un état deUPDATING
. Pour afficher l'état de tous les pools de configuration de machines, exécutez la commande suivante :oc get mcp
$ oc get mcp
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
NAME CONFIG UPDATED UPDATING master rendered-master-ecbb9582781c1091e1c9f19d50cf836c True False worker rendered-worker-00a3f0c68ae94e747193156b491553d5 True False
NAME CONFIG UPDATED UPDATING master rendered-master-ecbb9582781c1091e1c9f19d50cf836c True False worker rendered-worker-00a3f0c68ae94e747193156b491553d5 True False
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Votre version actuelle est <4.y>, et la version que vous souhaitez mettre à jour est <4.y 2>. Passez au canal
eus-<4.y 2>
en exécutant la commande suivante :oc adm upgrade channel eus-<4.y 2>
$ oc adm upgrade channel eus-<4.y 2>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow NoteSi vous recevez un message d'erreur indiquant que
eus-<4.y 2>
n'est pas l'un des canaux disponibles, cela signifie que Red Hat est toujours en train de déployer les mises à jour de la version EUS. Ce processus de déploiement prend généralement de 45 à 90 jours à partir de la date de l'AG.Mettez en pause tous les pools de machines de travail, à l'exception du pool maître, en exécutant la commande suivante :
oc patch mcp/worker --type merge --patch '{"spec":{"paused":true}}'
$ oc patch mcp/worker --type merge --patch '{"spec":{"paused":true}}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow NoteVous ne pouvez pas mettre en pause le pool principal.
Mettez à jour la version la plus récente en exécutant la commande suivante :
oc adm upgrade --to-latest
$ oc adm upgrade --to-latest
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
Mise à jour vers la dernière version <4.y 1.z>
Mise à jour vers la dernière version <4.y 1.z>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Vérifiez la version du cluster pour vous assurer que les mises à jour sont complètes en exécutant la commande suivante :
oc adm upgrade
$ oc adm upgrade
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
Cluster version is <4.y+1.z> ...
Cluster version is <4.y+1.z> ...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Mettez à jour la version <4.y 2> en exécutant la commande suivante :
oc adm upgrade --to-latest
$ oc adm upgrade --to-latest
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Récupérez la version du cluster pour vous assurer que les mises à jour <4.y 2> sont complètes en exécutant la commande suivante :
oc adm upgrade
$ oc adm upgrade
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
Cluster version is <4.y+1.z> ...
Cluster version is <4.y+1.z> ...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Pour mettre à jour vos nœuds de travail en <4.y 2>, désactivez tous les pools de configuration de machines précédemment mis en pause en exécutant la commande suivante :
oc patch mcp/worker --type merge --patch '{"spec":{"paused":false}}'
$ oc patch mcp/worker --type merge --patch '{"spec":{"paused":false}}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow ImportantSi les pools ne sont pas désactivés, la grappe n'est pas autorisée à se mettre à jour vers de futures versions mineures, et les tâches de maintenance telles que la rotation des certificats sont inhibées. La grappe risque donc de se dégrader à l'avenir.
Vérifiez que les pools précédemment mis en pause sont mis à jour et que la mise à jour vers la version <4.y 2> est terminée en exécutant la commande suivante :
oc get mcp
$ oc get mcp
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemple de sortie
NAME CONFIG UPDATED UPDATING master rendered-master-52da4d2760807cb2b96a3402179a9a4c True False worker rendered-worker-4756f60eccae96fb9dcb4c392c69d497 True False
NAME CONFIG UPDATED UPDATING master rendered-master-52da4d2760807cb2b96a3402179a9a4c True False worker rendered-worker-4756f60eccae96fb9dcb4c392c69d497 True False
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
6.1.3. Mise à jour EUS-to-EUS pour les produits en couches et les opérateurs installés via Operator Lifecycle Manager Copier lienLien copié sur presse-papiers!
En plus des étapes de mise à jour EUS vers EUS mentionnées pour la console web et le CLI, il existe des étapes supplémentaires à prendre en compte lors de l'exécution des mises à jour EUS vers EUS pour les clusters avec les éléments suivants :
- Produits stratifiés
- Opérateurs installés via le gestionnaire du cycle de vie des opérateurs (OLM)
Qu'est-ce qu'un produit en couches ?
Les produits en couches sont des produits composés de plusieurs produits sous-jacents destinés à être utilisés ensemble et qui ne peuvent pas être divisés en abonnements individuels. Pour des exemples de produits en couches de OpenShift Container Platform, voir Offre en couches sur OpenShift.
Lorsque vous effectuez une mise à jour EUS vers EUS pour les clusters de produits en couche et ceux des opérateurs qui ont été installés via OLM, vous devez effectuer les opérations suivantes :
- Assurez-vous que tous vos opérateurs précédemment installés par OLM sont mis à jour à leur dernière version dans leur dernier canal. La mise à jour des opérateurs garantit qu'ils disposent d'un chemin de mise à jour valide lorsque les catalogues OperatorHub par défaut passent de la version mineure actuelle à la suivante lors d'une mise à jour du cluster. Pour plus d'informations sur la mise à jour de vos opérateurs, voir "Preparing for an Operator update" dans "Additional resources".
- Confirmez la compatibilité de la version du cluster entre la version actuelle et la version prévue de l'opérateur. Vous pouvez vérifier avec quelles versions vos opérateurs OLM sont compatibles en utilisant le vérificateur d'informations de mise à jour des opérateurs de Red Hat OpenShift Container Platform.
À titre d'exemple, voici les étapes pour effectuer une mise à jour EUS-to-EUS de <4.y> vers <4.y 2> pour OpenShift Data Foundation (ODF). Cette opération peut être effectuée via le CLI ou la console web. Pour plus d'informations sur la mise à jour des clusters via l'interface de votre choix, consultez EUS-to-EUS update using the web console et \N "Mise à jour EUS-to-EUS à l'aide de la CLI" dans \N "Ressources supplémentaires".
Exemple de flux de travail
- Mettre en pause les pools de machines de travail.
-
Mettre à jour OpenShift <4.y>
OpenShift <4.y 1>. -
Mise à jour ODF <4.y>
ODF <4.y 1>. -
Mettre à jour OpenShift <4.y 1>
OpenShift <4.y 2>. - Mise à niveau vers ODF <4.y 2>.
- Désactivez les pools de machines de travail.
La mise à niveau vers ODF <4.y 2> peut avoir lieu avant ou après que les pools de machines de travail aient été désactivés.