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.

Important

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

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

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

  1. 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".
  2. 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 de UPDATING.

    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.

    Note

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

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

  4. 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.
  5. 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".
  6. 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.
  7. 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".
  8. 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".
  9. 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.
  10. 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.

    Important

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

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

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

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

  1. 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".
  2. 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 de UPDATING. Pour afficher l'état de tous les pools de configuration de machines, exécutez la commande suivante :

    $ oc get mcp
    Copy to Clipboard Toggle word wrap

    Exemple de sortie

    NAME     CONFIG                                         	UPDATED   UPDATING
    master   rendered-master-ecbb9582781c1091e1c9f19d50cf836c       True  	  False
    worker   rendered-worker-00a3f0c68ae94e747193156b491553d5       True  	  False
    Copy to Clipboard Toggle word wrap

  3. 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>
    Copy to Clipboard Toggle word wrap
    Note

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

  4. 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}}'
    Copy to Clipboard Toggle word wrap
    Note

    Vous ne pouvez pas mettre en pause le pool principal.

  5. Mettez à jour la version la plus récente en exécutant la commande suivante :

    $ oc adm upgrade --to-latest
    Copy to Clipboard Toggle word wrap

    Exemple de sortie

    Mise à jour vers la dernière version <4.y 1.z>
    Copy to Clipboard Toggle word wrap

  6. 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
    Copy to Clipboard Toggle word wrap

    Exemple de sortie

    Cluster version is <4.y+1.z>
    ...
    Copy to Clipboard Toggle word wrap

  7. Mettez à jour la version <4.y 2> en exécutant la commande suivante :

    $ oc adm upgrade --to-latest
    Copy to Clipboard Toggle word wrap
  8. 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
    Copy to Clipboard Toggle word wrap

    Exemple de sortie

    Cluster version is <4.y+1.z>
    ...
    Copy to Clipboard Toggle word wrap

  9. 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}}'
    Copy to Clipboard Toggle word wrap
    Important

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

  10. 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
    Copy to Clipboard Toggle word wrap

    Exemple de sortie

    NAME 	   CONFIG                                            UPDATED     UPDATING
    master   rendered-master-52da4d2760807cb2b96a3402179a9a4c    True  	 False
    worker   rendered-worker-4756f60eccae96fb9dcb4c392c69d497    True 	 False
    Copy to Clipboard Toggle word wrap

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 :

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

  1. Mettre en pause les pools de machines de travail.
  2. Mettre à jour OpenShift <4.y> OpenShift <4.y 1>.
  3. Mise à jour ODF <4.y> ODF <4.y 1>.
  4. Mettre à jour OpenShift <4.y 1> OpenShift <4.y 2>.
  5. Mise à niveau vers ODF <4.y 2>.
  6. Désactivez les pools de machines de travail.
Note

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.

Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat