Ce document a été traduit à l'aide d'une technologie de traduction automatique. Bien que nous nous efforcions de fournir des traductions exactes, nous ne fournissons aucune garantie quant à l'exhaustivité, l'exactitude ou la fiabilité du contenu traduit. En cas de divergence, la version originale anglaise prévaut et fait foi.

Guide de migration

Contexte

À partir de Rancher v2.13, SUSE® Rancher Prime Cluster API est installé dans le cadre de Rancher, éliminant ainsi le besoin d’un déploiement séparé. Avant de mettre à niveau vers Rancher v2.13, les utilisateurs doivent suivre ce guide pour garantir un processus de mise à niveau fluide.

Migration

Suivez les étapes ci-dessous dans l’ordre, avant de mettre à niveau vers Rancher v2.13 :

  1. Assurez-vous de mettre à niveau SUSE® Rancher Prime Cluster API vers v0.24.3. Cette étape est importante car tous les correctifs de v0.24 préparent le cluster à la mise à niveau vers Rancher v2.13.

  2. Désinstaller SUSE® Rancher Prime Cluster API. Ceci est nécessaire car à partir de Rancher v2.13, SUSE® Rancher Prime Cluster API n’est plus un addon optionnel mais un composant système de Rancher. En tant que tel, Rancher l’installe dans un espace de noms différent de celui d’avant et donc la version précédemment installée doit être désinstallée manuellement en premier. La désinstallation de v0.24.3 de SUSE® Rancher Prime Cluster API supprime le fournisseur CAPI du noyau lui-même mais conserve les CRD CAPI du noyau. Pendant la migration, le contrôleur CAPI du noyau ne sera pas en cours d’exécution sur le cluster de gestion, mais tous les clusters CAPI en aval devraient continuer à fonctionner normalement et ne pas être affectés.

  3. Exécutez les commandes kubectl suivantes :

    kubectl patch crd capiproviders.turtles-capi.cattle.io --type=json -p='[{"op": "add", "path": "/metadata/annotations/meta.helm.sh~1release-namespace", "value": "cattle-turtles-system"}]'
kubectl patch crd clusterctlconfigs.turtles-capi.cattle.io --type=json -p='[{"op": "add", "path": "/metadata/annotations/meta.helm.sh~1release-namespace", "value": "cattle-turtles-system"}]'

Ces commandes vont appliquer un correctif aux CRD capiprovider et clusterctlconfig afin qu’ils soient adoptés par SUSE® Rancher Prime Cluster API lorsqu’ils sont installés dans le cadre de Rancher v2.13.

Notez que la migration décrite ci-dessus est nécessaire pour les utilisateurs exécutant SUSE® Rancher Prime Cluster API versions ≤ v0.24.3. Les nouveaux utilisateurs qui installent Rancher v2.13 n’ont pas besoin d’effectuer de migration.