9.4. Mise à jour d'un cluster à l'aide de la CLI

Procédure

1. Affichez les mises à jour disponibles et notez le numéro de version de la mise à jour que vous souhaitez appliquer :

   $ oc adm upgrade

   Exemple de sortie

   Cluster version is 4.9.23
   
   Upstream is unset, so the cluster will use an appropriate default.
   Channel: stable-4.9 (available channels: candidate-4.10, candidate-4.9, fast-4.10, fast-4.9, stable-4.10, stable-4.9, eus-4.10)
   
   Recommended updates:
   
   VERSION IMAGE
   4.9.24  quay.io/openshift-release-dev/ocp-release@sha256:6a899c54dda6b844bb12a247e324a0f6cde367e880b73ba110c056df6d018032
   4.9.25  quay.io/openshift-release-dev/ocp-release@sha256:2eafde815e543b92f70839972f585cc52aa7c37aa72d5f3c8bc886b0fd45707a
   4.9.26  quay.io/openshift-release-dev/ocp-release@sha256:3ccd09dd08c303f27a543351f787d09b83979cd31cf0b4c6ff56cd68814ef6c8
   4.9.27  quay.io/openshift-release-dev/ocp-release@sha256:1c7db78eec0cf05df2cead44f69c0e4b2c3234d5635c88a41e1b922c3bedae16
   4.9.28  quay.io/openshift-release-dev/ocp-release@sha256:4084d94969b186e20189649b5affba7da59f7d1943e4e5bc7ef78b981eafb7a8
   4.9.29  quay.io/openshift-release-dev/ocp-release@sha256:b04ca01d116f0134a102a57f86c67e5b1a3b5da1c4a580af91d521b8fa0aa6ec
   4.9.31  quay.io/openshift-release-dev/ocp-release@sha256:2a28b8ebb53d67dd80594421c39e36d9896b1e65cb54af81fbb86ea9ac3bf2d7
   4.9.32  quay.io/openshift-release-dev/ocp-release@sha256:ecdb6d0df547b857eaf0edb5574ddd64ca6d9aff1fa61fd1ac6fb641203bedfa

   Note

   Pour plus de détails et d'informations sur la manière d'effectuer une mise à niveau du canal EUS-to-EUS, veuillez consulter la page Preparing to perform an EUS-to-EUS upgrade, répertoriée dans la section Ressources supplémentaires.

2. En fonction des besoins de votre organisation, définissez le canal de mise à niveau approprié. Par exemple, vous pouvez définir votre canal sur stable-4.12, fast-4.12, ou eus-4.12. Pour plus d'informations sur les canaux, consultez le site Understanding update channels and releases dans la section Ressources supplémentaires.

   $ oc adm upgrade channel <channel>

   Par exemple, pour régler le canal sur stable-4.12:

   $ oc adm upgrade channel stable-4.12

   Important

   Pour les clusters de production, vous devez vous abonner à un canal stable-*, eus-* ou fast-*.

   Note

   Lorsque vous êtes prêt à passer à la version mineure suivante, choisissez le canal qui correspond à cette version mineure. Plus le canal de mise à jour est déclaré tôt, plus le cluster peut recommander des chemins de mise à jour vers la version cible. Le cluster peut prendre un certain temps pour évaluer toutes les mises à jour possibles et proposer les meilleures recommandations de mise à jour. Les recommandations de mise à jour peuvent changer au fil du temps, car elles sont basées sur les options de mise à jour disponibles à ce moment-là.

   Si vous ne voyez pas de chemin de mise à jour pour votre version mineure cible, continuez à mettre à jour votre cluster avec la dernière version de correctif pour votre version actuelle jusqu'à ce que la version mineure suivante soit disponible dans le chemin.

3. Appliquer une mise à jour :

   • Pour mettre à jour la dernière version :

     $ oc adm upgrade --to-latest=true 1

   • Pour mettre à jour une version spécifique :

     oc adm upgrade --to=<version> 1

     1 1

     <version> est la version de mise à jour que vous avez obtenue à partir de la sortie de la commande oc adm upgrade.

4. Examinez l'état de l'opérateur de la version du cluster :

   $ oc adm upgrade

5. Une fois la mise à jour terminée, vous pouvez confirmer que la version du cluster a été mise à jour :

   $ oc get clusterversion

   Exemple de sortie

   Cluster version is <version>
   
   Upstream is unset, so the cluster will use an appropriate default.
   Channel: stable-4.10 (available channels: candidate-4.10, candidate-4.11, eus-4.10, fast-4.10, fast-4.11, stable-4.10)
   
   No updates available. You may force an upgrade to a specific release image, but doing so might not be supported and might result in downtime or data loss.

   Note

   Si la commande oc get clusterversion affiche l'erreur suivante alors que l'état de PROGRESSING est True, vous pouvez ignorer l'erreur.

   NAME    VERSION AVAILABLE PROGRESSING SINCE STATUS
   version 4.10.26 True      True        24m   Unable to apply 4.11.0-rc.7: an unknown error has occurred: MultipleErrors

6. Si vous mettez à niveau votre cluster vers la version mineure suivante, telle que la version X.y vers X.(y 1), il est recommandé de confirmer que vos nœuds sont mis à niveau avant de déployer des charges de travail qui dépendent d'une nouvelle fonctionnalité :

   $ oc get nodes

   Exemple de sortie

   NAME                           STATUS   ROLES    AGE   VERSION
   ip-10-0-168-251.ec2.internal   Ready    master   82m   v1.25.0
   ip-10-0-170-223.ec2.internal   Ready    master   82m   v1.25.0
   ip-10-0-179-95.ec2.internal    Ready    worker   70m   v1.25.0
   ip-10-0-182-134.ec2.internal   Ready    worker   70m   v1.25.0
   ip-10-0-211-16.ec2.internal    Ready    master   82m   v1.25.0
   ip-10-0-250-100.ec2.internal   Ready    worker   69m   v1.25.0