Mettre à jour votre cluster Openshift hébergé

Ce guide explique comment effectuer une mise à jour automatique de votre cluster OpenShift en utilisant la ressource CAVControlPlane disponible.

---

1. Vue d’ensemble de la ressource CAVControlPlane

• La ressource CAVControlPlane est créée automatiquement pour votre cluster au démarrage. Elle est essentielle pour la gestion et le fonctionnement de votre cluster.
• Cette ressource est unique et doit toujours exister. Son nom est toujours local.
• Ne supprimez pas la ressource CAVControlPlane. Si elle disparaît et que vous ne pouvez pas la recréer, veuillez contacter le support immédiatement.

Pour afficher le statut de votre control plane, récupérez la ressource Kubernetes CAVControlPlane ou cavcp pour faire court :
$ kubectl get cavcontrolplane
NAME    VERSION   UPDATED   ISO UPLOADED
local   4.19.19   True      True

2. Comment mettre à jour votre cluster

Pour mettre à jour votre cluster, vous devez modifier le champ spec.version de la ressource CAVControlPlane vers la version souhaitée d’OpenShift/Kubernetes.

Instructions étape par étape

a. Localiser la ressource CAVControlPlane

La ressource devrait être nommée local dans votre cluster.

$ kubectl get cavcontrolplane local -o yaml

b. Modifier le champ spec.version

Mettez à jour le champ spec.version avec la version cible. Par exemple, pour passer à la version 4.19.0 :

apiVersion: containers.orange-business.com/v1
kind: CAVControlPlane
metadata:
  name: local
spec:
  version: 4.19.19

Vous pouvez éditer la ressource directement :

$ kubectl edit cavcontrolplane local


Ou appliquer un manifeste :

$ kubectl apply -f updated-cavcontrolplane.yaml

c. L’opérateur détectera le changement

L’opérateur CAV Hypershift orchestrera automatiquement le processus de mise à jour de votre control plane et des node pools.

d. Surveiller le processus de mise à jour

Vous pouvez suivre l’état de la mise à jour en vérifiant les conditions de statut de la ressource :

$ kubectl describe cavcontrolplane local

Recherchez les mises à jour de statut et les conditions indiquant la progression ou la fin de la mise à jour.

Pour plus de détails, décrivez vos ressources OpenShift :

$ kubectl describe clusterversion version
$ kubectl get clusteroperator

3. Dépannage & Support

• Si la ressource CAVControlPlane est manquante et que vous ne pouvez pas la recréer, contactez le support.
• Pour tout problème lors du processus de mise à jour, vérifiez le statut de la ressource pour repérer les messages d’erreur.

4. Avertissements & Bonnes pratiques

• Ne définissez le champ spec.version qu’avec des versions officiellement supportées.
• Surveillez toujours le processus de mise à jour et assurez-vous qu’il se termine avec succès avant d’effectuer d’autres modifications.
• Pendant la mise à jour, chaque nœud redémarrera un par un, ce qui peut temporairement affecter la disponibilité du cluster.