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.

Migration von VMware vSphere In-tree zu Out-of-tree

Kubernetes entfernt sich von der Pflege von Cloud-Anbietern in-tree. VMware vSphere hat einen Out-of-tree-Cloud-Anbieter, der durch die Installation des vSphere-Cloud-Anbieters und der Cloud-Speicher-Plugins verwendet werden kann.

Diese Seite behandelt, wie man vom in-tree vSphere-Cloud-Anbieter zu Out-of-tree migriert und die bestehenden VMs nach der Migration verwaltet.

Es folgen die Schritte, die in der offiziellen vSphere-Migrationsdokumentation bereitgestellt werden, und es werden die Schritte beschrieben, die in Rancher durchzuführen sind.

Einschränkung des Cloud-Config-Formats

Bestehende Volumes, die mit dem folgenden Cloud-Config-Format bereitgestellt wurden, werden aufgrund eines bestehenden Fehlers in der vSphere Cloud Storage-Schnittstelle (CSI) nicht migriert.

Wenn die Cloud-Config dieses Format für den Datenspeicher- und Ressourcenpool-Pfad hat, kann der vSphere CSI-Treiber es nicht erkennen:

default-datastore: </datacenter>/datastore/<default-datastore-name>
resourcepool-path: "</datacenter>/host/<cluster-name>/Resources/<resource-pool-name>"

Volumes, die mit dem in-tree-Anbieter im folgenden Format bereitgestellt wurden, werden korrekt migriert:

default-datastore: <default-datastore-name>
resourcepool-path: "<cluster-name>/Resources/<resource-pool-name>"

Upstream-Fehler: https://github.com/kubernetes-sigs/vsphere-csi-driver/issues/628

Rancher-Problem, das diesen Fehler verfolgt: https://github.com/rancher/rancher/issues/31105

Voraussetzungen

  • Die vSphere CSI-Migration erfordert vSphere 7.0u1. Um bestehende in-tree vSphere-Volumes verwalten zu können, aktualisieren Sie vSphere auf 7.0u1.

  • Die Kubernetes-Version muss 1.19 oder höher sein.

Migration

1. Installieren Sie das CPI-Plugin

Bevor Sie CPI installieren, müssen Sie alle Knoten mit node.cloudprovider.kubernetes.io/uninitialized=true:NoSchedule tainten.

Dies kann durch Ausführen der folgenden Befehle erfolgen:

curl -O https://raw.githubusercontent.com/rancher/helm3-charts/56b622f519728378abeddfe95074f1b87ab73b1e/charts/vsphere-cpi/taints.sh

oder:

wget https://raw.githubusercontent.com/rancher/helm3-charts/56b622f519728378abeddfe95074f1b87ab73b1e/charts/vsphere-cpi/taints.sh
chmod +x taints.sh
./taints.sh <path to kubeconfig if running the command outside the cluster>

Sobald alle Knoten durch das Ausführen des Skripts getaintet wurden, starten Sie das Helm vSphere CPI Chart.

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Gehen Sie zu dem Cluster, in dem das vSphere CPI Chart installiert werden soll, und klicken Sie auf Entdecken.

  3. Klicken Sie auf Apps  Charts.

  4. Klicken Sie auf vSphere CPI.

  5. Klicken Sie auf Installieren.

  6. Füllen Sie die erforderlichen vCenter-Details aus und klicken Sie auf Installieren.

vSphere CPI initialisiert alle Knoten mit ProviderID, die vom vSphere CSI-Treiber benötigt wird.

Überprüfen Sie, ob alle Knoten mit der ProviderID mit dem folgenden Befehl initialisiert sind:

kubectl describe nodes | grep "ProviderID"

2. Installieren Sie den CSI-Treiber

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Gehen Sie zu dem Cluster, in dem das vSphere CSI Chart installiert werden soll, und klicken Sie auf Entdecken.

  3. Klicken Sie auf Apps  Charts.

  4. Klicken Sie auf vSphere CSI.

  5. Klicken Sie auf Installieren.

  6. Füllen Sie die erforderlichen vCenter-Details aus und klicken Sie auf Installieren.

  7. Aktivieren Sie Helm-Optionen vor der Installation anpassen und klicken Sie auf Weiter.

  8. Aktivieren Sie im Tab Funktionen CSI-Migration.

  9. Optional können Sie zum Tab Speicher gehen und einen Datenspeicher einrichten. Dieses Chart erstellt eine StorageClass mit dem csi.vsphere.vmware.com als Provisioner. Sie können die URL des Datenspeichers angeben, die für die CSI-Volumenbereitstellung verwendet werden soll, während Sie diese StorageClass erstellen. Die Datenspeicher-URL kann im vSphere-Client gefunden werden, indem Sie den Datenspeicher auswählen und zum Tab Zusammenfassung gehen. Füllen Sie die Details für die StorageClass aus.

  10. Klicken Sie auf Installieren.

3. Bearbeiten Sie den Cluster, um die CSI-Migrationsfunktionsflags zu aktivieren.

  1. Während Sie den Cluster bearbeiten, wählen Sie, wenn die Kubernetes-Version kleiner als 1.19 ist, die Kubernetes-Version 1.19 oder höher aus dem Dropdown-Menü Kubernetes-Version aus.

  2. Um die Funktionsflags zu aktivieren, klicken Sie auf "Als YAML bearbeiten" und fügen Sie Folgendes unter kube-controller und kubelet hinzu:

       extra_args:
     feature-gates: "CSIMigration=true,CSIMigrationvSphere=true"

4. Entleeren Sie die Arbeitsknoten.

Die Worker-Knoten müssen während des Upgrades entleert werden, bevor die Argumente des Kubelets und des Kube-Controller-Managers geändert werden.

  1. Klicken Sie auf ☰ > Clusterverwaltung.

  2. Gehen Sie zu dem Cluster, in dem Sie die Worker-Knoten entleeren möchten, und klicken Sie auf ⋮ > Konfiguration bearbeiten.

  3. Im Abschnitt Erweiterte Optionen setzen Sie das Feld Maximale nicht verfügbare Worker-Knoten auf 1.

  4. Um die Knoten während des Upgrades zu entleeren, wählen Sie Knoten entleeren  Ja aus.

  5. Setzen Sie Force und Delete Local Data auf true.

  6. Klicken Sie auf Speichern, um den Cluster zu aktualisieren.