Dieses Dokument wurde mithilfe automatisierter maschineller Übersetzungstechnologie übersetzt. Wir bemühen uns um korrekte Übersetzungen, übernehmen jedoch keine Gewähr für die Vollständigkeit, Richtigkeit oder Zuverlässigkeit der übersetzten Inhalte. Im Falle von Abweichungen ist die englische Originalversion maßgebend und stellt den verbindlichen Text dar.

Migrationsleitfaden

Kontext

Ab Rancher v2.13 wird SUSE® Rancher Prime Cluster API als Teil von Rancher installiert, wodurch die Notwendigkeit einer separaten Implementierung entfällt. Vor dem Upgrade auf Rancher v2.13 müssen die Benutzer diesen Leitfaden befolgen, um einen reibungslosen Upgrade-Prozess sicherzustellen.

Migration

Befolgen Sie die folgenden Schritte der Reihe nach, bevor Sie auf Rancher v2.13 upgraden:

  1. Stellen Sie sicher, dass Sie SUSE® Rancher Prime Cluster API auf v0.24.3 upgraden. Dieser Schritt ist wichtig, da alle Patch-Versionen für v0.24 den Cluster auf das Upgrade auf Rancher v2.13 vorbereiten.

  2. Deinstallieren Sie SUSE® Rancher Prime Cluster API. Dies ist notwendig, da SUSE® Rancher Prime Cluster API ab Rancher v2.13 kein optionales Addon mehr ist, sondern ein Bestandteil des Rancher-Systems. Daher installiert Rancher es in einem anderen Namespace als zuvor, und die zuvor installierte Version muss daher zuerst manuell deinstalliert werden. Die Deinstallation von v0.24.3 von SUSE® Rancher Prime Cluster API entfernt den Kernel-CAPI-Anbieter selbst, behält jedoch die Kernel-CAPI-CRDs. Während der Migration wird der Kernel-CAPI-Controller nicht im Verwaltungs-Cluster ausgeführt, aber alle Downstream-CAPI-Cluster sollten weiterhin wie gewohnt laufen und nicht betroffen sein.

  3. Führen Sie die folgenden kubectl-Befehle aus:

    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"}]'

Diese Befehle werden die capiprovider und clusterctlconfig CRDs patchen, sodass sie von SUSE® Rancher Prime Cluster API übernommen werden, wenn sie als Teil von Rancher v2.13 installiert werden.

Bitte beachten Sie, dass die oben beschriebene Migration für Benutzer, die SUSE® Rancher Prime Cluster API Versionen ≤ v0.24.3 verwenden, notwendig ist. Neue Benutzer, die Rancher v2.13 installieren, müssen keine Migration durchführen.