Upgrade von Tanzu Kubernetes Grid

Zum Aktualisieren von Tanzu Kubernetes Grid (TKG) laden Sie die neue Version der Tanzu CLI auf die Maschine herunter, die Sie als Bootstrap-Maschine verwenden, und installieren Sie sie. Abhängig davon, ob Sie zuvor in vSphere, Amazon Web Services (AWS) oder Azure bereitgestellte Cluster aktualisieren, müssen Sie auch Basisimage-Vorlagen und VMs herunterladen und installieren.

Hinweis

Im TKG-Upgrade-Pfad folgt v2.1 unmittelbar auf v1.6. TKG 2.0 ist keine herunterladbare Version, sondern bezieht sich stattdessen auf die Verwendung der TKG-Version, die in einen vSphere with Tanzu Supervisor in vSphere 8 eingebettet ist.

Nach der Installation der neuen Versionen der Komponenten verwenden Sie die CLI-Befehle tanzu mc upgrade und tanzu cluster upgrade, um Verwaltungs- und Arbeitslastcluster zu aktualisieren.

In den nächsten Abschnitten werden die allgemeinen Schritte beschrieben, die für das Upgrade von Tanzu Kubernetes Grid erforderlich sind. In diesem Verfahren wird davon ausgegangen, dass Sie ein Upgrade auf Tanzu Kubernetes Grid v2.1 durchführen.

Bestimmte Schritte sind nur dann erforderlich, wenn Sie ein kleineres Upgrade von Tanzu Kubernetes Grid v1.6.x auf v2.1.x durchführen. Sie sind nicht notwendig, wenn Sie ein Patch-Upgrade von Tanzu Kubernetes Grid v2.1.x auf v2.1.y durchführen.

Voraussetzungen

Stellen Sie vor dem Upgrade auf TKG v2.1.x sicher, dass Ihre aktuelle Bereitstellung TKG v1.6.x oder eine frühere v2.1-Version ist. Um ein Upgrade auf TKG v2.1.x von Versionen vor v1.6 durchzuführen, müssen Sie zuerst mit v1.6.x der Tanzu CLI ein Upgrade auf v1.6.x durchführen.

Wichtig

Die Versionen der Tanzu CLI, die mit TKG 2.x und mit dem vSphere with Tanzu Supervisor in vSphere 8 kompatibel sind, sind nicht mit dem Supervisor-Cluster in vSphere 7 kompatibel. Um die Tanzu CLI mit einem vSphere with Tanzu Supervisor-Cluster auf vSphere 7 zu verwenden, verwenden Sie die Tanzu CLI-Version von TKG v1.6. Um die Versionen von Tanzu CLI zu verwenden, die mit TKG 2.x mit Supervisor kompatibel sind, führen Sie ein Upgrade auf vSphere 8 durch. Sie können einen eigenständigen TKG 2.x-Verwaltungscluster auf vSphere 7 bereitstellen, wenn der vSphere with Tanzu Supervisor-Cluster nicht vorhanden ist. Informationen zur Kompatibilität zwischen der Tanzu CLI und VMware-Produkten finden Sie in der Tanzu CLI-Dokumentation.

Herunterladen und Installieren der neuen Version der Tanzu CLI

Dieser Schritt muss sowohl für Haupt-Upgrades von v1.6.x auf v2.1.x als auch für Patch-Upgrades von v2.1.x auf v2.1.y durchgeführt werden.

Führen Sie die folgenden Schritte aus, um die neue Version der Tanzu CLI herunterzuladen und zu installieren.

1. Löschen Sie die Datei ~/.config/tanzu/tkg/compatibility/tkg-compatibility.yaml.

   Wenn Sie diese Datei nicht löschen, verwendet die neue Version der Tanzu CLI weiterhin die Stückliste (BoM) für die vorherige Version. Durch Löschen dieser Datei wird die Tanzu CLI dazu veranlasst, die aktualisierte Stückliste abzurufen. Sie müssen diesen Schritt sowohl beim Upgrade von 1.6.x auf 2.1.x als auch beim Upgrade von 2.1.x auf 2.1.y durchführen.

2. Befolgen Sie die Anweisungen unter Installieren der Tanzu CLI und anderer Tools für die Verwendung mit eigenständigen Verwaltungsclustern, um die Tanzu CLI und kubectl herunterzuladen und auf der Maschine zu installieren, auf der Sie derzeit die tanzu-Befehle ausführen.

3. Führen Sie tanzu version nach der Installation der Tanzu CLI aus, um sicherzustellen, dass die korrekte Version der Tanzu CLI ordnungsgemäß installiert wurde. Tanzu Kubernetes Grid v2.1.1 verwendet Tanzu CLI v0.28.1, basierend auf dem Tanzu Framework v0.28.1.
4. Führen Sie nach der Installation von kubectl den Befehl kubectl version aus, um sicherzustellen, dass die korrekte Version von kubectl ordnungsgemäß installiert wurde.

Informationen zu verfügbaren Tanzu CLI-Befehlen und -Optionen finden Sie in der Befehlsreferenz für die Tanzu CLI.

Vorbereitungen für das Upgrade von Clustern

Abhängig davon, ob Sie Cluster in vSphere, AWS oder Azure bereitgestellt haben, müssen Sie vor der Aktualisierung von Verwaltungs- und Arbeitslastclustern vorbereitende Schritte durchführen. Dieser Schritt muss sowohl für Haupt-Upgrades von v1.6.x auf v2.1.x als auch für Patch-Upgrades von v2.1.x auf v2.1.y durchgeführt werden.

vSphere

Bevor Sie eine Tanzu Kubernetes Grid-Bereitstellung auf vSphere aktualisieren können, müssen Sie neue Versionen der Basisimage-Vorlagen in vSphere importieren, die in den aktualisierten Verwaltungs- und Arbeitslastclustern ausgeführt werden. VMware veröffentlicht für jede unterstützte Betriebssystem- und Kubernetes-Version Basisimage-Vorlagen im OVA-Format. Nach dem Importieren der OVAs müssen Sie die resultierenden VMs in VM-Vorlagen konvertieren.

In diesem Verfahren wird davon ausgegangen, dass Sie ein Upgrade auf Tanzu Kubernetes Grid v2.1.x durchführen.

1. Öffnen Sie die Download-Seite von Tanzu Kubernetes Grid und melden Sie sich mit Ihren Anmeldedaten für VMware Customer Connect an.

2. Laden Sie die aktuellen Tanzu Kubernetes Grid-OVAs für die Betriebssystem- und Kubernetes-Versionszeilen herunter, die in Ihren Verwaltungs- und Arbeitslastclustern ausgeführt werden.

   Für Photon v3-Images:

   • Kubernetes v1.24.10: Photon v3 Kubernetes v1.24.10 OVA
   • Kubernetes v1.23.16: Photon v3 Kubernetes v1.23.16 OVA
   • Kubernetes v1.22.17: Photon v3 Kubernetes v1.22.17 OVA

   Für Ubuntu 20.04-Images:

   • Kubernetes v1.24.10: Ubuntu 2004 Kubernetes v1.24.10 OVA
   • Kubernetes v1.23.16: Ubuntu 2004 Kubernetes v1.23.16 OVA
   • Kubernetes v1.22.17: Ubuntu 2004 Kubernetes v1.22.17 OVA

   Wichtig

   Stellen Sie sicher, dass Sie die neuesten OVA-Basisimage-Vorlagen, wenn Sicherheits-Patch-Versionen vorhanden sind. Aktualisierte Basisimage-Vorlagen, die Sicherheits-Patches enthalten, finden Sie auf der Produktdownloadseite von Tanzu Kubernetes Grid.

3. Klicken Sie im vSphere Client mit der rechten Maustaste auf ein Objekt in der vCenter Server-Bestandsliste und wählen Sie OVF-Vorlage bereitstellen (Deploy OVF template) aus.
4. Wählen Sie Lokale Datei (Local file) aus, klicken Sie auf die Schaltfläche zum Hochladen von Dateien und navigieren Sie zu einer heruntergeladenen OVA-Datei auf Ihrem lokalen Computer.

5. Folgen Sie den Eingabeaufforderungen des Installationsprogramms, um eine VM aus der OVA bereitzustellen.

   • Appliance-Name akzeptieren oder ändern.
   • Zieldatencenter oder Zielordner auswählen.
   • Zielhost, Cluster oder Ressourcenpool auswählen.
   • Endbenutzer-Lizenzvereinbarungen (EULA) akzeptieren.
   • Festplattenformat und Zieldatenspeicher auswählen.
   • Netzwerk auswählen, mit dem die VM eine Verbindung herstellen soll.
6. Klicken Sie auf Fertigstellen (Finish), um die VM bereitzustellen.
7. Wenn die OVA-Bereitstellung abgeschlossen ist, klicken Sie mit der rechten Maustaste auf die VM und wählen Sie Vorlage (Template) > In Vorlage konvertieren (Convert to Template) aus.
8. Klicken Sie in der Ansicht VMs und Vorlagen (VMs and Templates) mit der rechten Maustaste auf die neue Vorlage, wählen Sie Berechtigung hinzufügen (Add Permission) aus und weisen Sie Ihren Tanzu Kubernetes Grid-Benutzer, wie z. B. tkg-user, zur Vorlage mit der Rolle „Tanzu Kubernetes Grid“ zu, wie z. B. TKG. Sie haben diesen Benutzer und diese Rolle in Vorbereitung der Bereitstellung von Verwaltungsclustern für vSphere erstellt.

Wiederholen Sie den Vorgang für jede Kubernetes-Version, für die Sie die OVA-Datei heruntergeladen haben.

Kompatibilität mit VMware Cloud on AWS-SDDC

Wenn Sie in VMware Cloud on AWS bereitgestellte Arbeitslastcluster aktualisieren, stellen Sie sicher, dass die Version des zugrunde liegenden SDDC (Software-Defined Datacenter), die in Ihrer vorhandenen Bereitstellung verwendet wird, mit der Version von Tanzu Kubernetes Grid kompatibel ist, auf die Sie ein Upgrade durchführen.

Zur Anzeige der Version eines SDDC wählen Sie Details anzeigen (View Details) auf der SDDC-Kachel in der VMware Cloud-Konsole aus und klicken Sie auf den Bereich Support.

Informationen zum Überprüfen der Kompatibilität mit Tanzu Kubernetes Grid finden Sie in der VMware-Produkt-Interoperabilitätmatrix.

AWS

Für Haupt-Upgrades von v1.6.x auf v2.1.x oder Patch-Upgrades von v2.1.x auf v2.1.y sind keine besonderen Aktionen notwendig.

Amazon Linux 2-AMIs (Amazon-Maschinen-Images), die die unterstützten Kubernetes-Versionen enthalten, sind für alle AWS-Benutzer in allen unterstützten AWS-Regionen öffentlich verfügbar. Tanzu Kubernetes Grid verwendet automatisch das entsprechende AMI für die Kubernetes-Version, die Sie während des Upgrades angeben.

Azure

Vor dem Upgrade einer Tanzu Kubernetes Grid-Bereitstellung in Azure müssen Sie die Bedingungen für das neue VM-Standard-Image und für jedes nicht standardmäßige VM-Image akzeptieren, das Sie für Ihre Cluster-VMs verwenden möchten. Sie müssen diese Bedingungen einmal pro Abonnement akzeptieren.

So akzeptieren Sie die Bedingungen:

1. Listen Sie alle verfügbaren VM-Images für Tanzu Kubernetes Grid im Azure Marketplace auf:

   az vm image list --publisher vmware-inc --offer tkg-capi --all
   

2. Akzeptieren Sie die Bedingungen für das neue VM-Standard-Image:

   az vm image terms accept --urn publisher:offer:sku:version
   

   Beispiel: Zum Akzeptieren der Bedingungen für das VM-Standard-Image in Tanzu Kubernetes Grid v2.1.x führen Sie k8s-1dot24dot10-ubuntu-2004 aus:

   az vm image terms accept --urn vmware-inc:tkg-capi:k8s-1dot24dot10-ubuntu-2004:2021.05.17
   

3. Wenn Sie für einen der Arbeitslastcluster ein Upgrade auf eine nicht standardmäßige Kubernetes-Version, wie z. B. v1.23.16 oder v1.22.17, durchführen möchten, akzeptieren Sie die Bedingungen für jede nicht standardmäßige Version, die Sie für Ihre Cluster-VMs verwenden möchten.

Upgrade eigenständiger Verwaltungscluster

Dieser Schritt ist nur für TKG mit einem eigenständigen Verwaltungscluster erforderlich. Wenn Sie TKG mit einem vSphere with Tanzu-Supervisor ausführen, aktualisieren Sie den Supervisor als Teil von vSphere sowie die Kubernetes-Version des Supervisors, indem Sie die zugehörigen TKrs upgraden.

Dieser Schritt muss sowohl für Haupt-Upgrades von v1.6.x auf v2.1.x als auch für Patch-Upgrades von v2.1.x auf v2.1.y durchgeführt werden.

Für ein Upgrade von Tanzu Kubernetes Grid müssen Sie alle Verwaltungscluster in Ihrer Bereitstellung aktualisieren. Sie können ein Upgrade von Arbeitslastclustern erst nach einem Upgrade der Verwaltungscluster durchführen, die sie verwalten.

Befolgen Sie die Schritte unter Upgrade eigenständiger Verwaltungscluster, um ein Upgrade Ihrer Verwaltungscluster durchzuführen.

Upgrade von Arbeitslastclustern

Dieser Schritt muss sowohl für Haupt-Upgrades von v1.6.x auf v2.1.x als auch für Patch-Upgrades von v2.1.x auf v2.1.y durchgeführt werden.

Befolgen Sie die Schritte unter Upgrade von Arbeitslastclustern, um ein Upgrade der Arbeitslastcluster durchzuführen, auf denen die Arbeitslasten ausgeführt werden.

Vorgänge nach dem Upgrade

Nach dem Upgrade der Cluster müssen weitere Schritte zum Abschließen des Upgrade-Vorgangs durchgeführt werden.

Synchronisieren von Paketversionen älter als n-2

Einige Pakete, die standardmäßig im Verwaltungscluster installiert werden, wie z. B. cert-manager, können als CLI-verwaltete Pakete in Arbeitslastclustern und den Clustern der gemeinsam genutzten Dienste installiert werden. Wenn der Verwaltungscluster auf die aktuelle Tanzu Kubernetes Grid-Version aktualisiert wird, werden die zugehörigen Standardpakete automatisch aktualisiert.

Sie können verschiedene Versionen der CLI-verwalteten Pakete in unterschiedlichen Arbeitslastclustern ausführen. In einem Arbeitslastcluster können Sie entweder die aktuelle unterstützte Version eines CLI-verwalteten Pakets oder die Versionen des Pakets in den letzten beiden zuvor installierten Versionen von Tanzu Kubernetes Grid ausführen. Wenn beispielsweise die neueste Paketversion von cert-manager v1.10.1 ist Ihre beiden vorherigen Tanzu Kubernetes Grid-Installationen cert-manager v1.7.2 und v1.5.3 ausgeführt haben, können Sie die cert-manager-Versionen v1.10.1, v1.7.2 und v1.5.3 in Arbeitslastclustern ausführen.

Für alle Arbeitslastcluster, auf denen Paketversionen ausgeführt werden, die n-2 Tanzu Kubernetes Grid-Versionen älter als die Paketversionen im Verwaltungscluster sind, müssen Sie zunächst das Paket-Repository (siehe Aktualisieren eines Paket-Repositorys) und dann das Paket in den Arbeitslastclustern aktualisieren (siehe Aktualisieren eines Pakets). Wenn Sie kein Upgrade der Paketversion durchführen, können Sie die Paketkonfiguration nicht aktualisieren, da das Paket-Repository unter Umständen keine Version des Pakets enthält, die älter als n-2 ist.

Anbieterspezifische Vorgänge nach dem Upgrade

Je nachdem, ob Ihre Cluster auf vSphere, AWS oder Azure ausgeführt werden, müssen Sie nach der Aktualisierung der Cluster bestimmte Vorgänge durchführen.

vSphere

Aktualisieren der NSX Advanced Load Balancer-Konfiguration nach einem Tanzu Kubernetes Grid-Upgrade

Wenn NSX ALB in Ihrer TKG v1.6-Installation nicht aktiviert war, finden Sie Informationen zur Installation von NSX ALB unter Installieren und Konfigurieren von NSX Advanced Load Balancer.

Wenn NSX ALB in Ihrer TKG v1.6-Installation aktiviert war, finden Sie weitere Informationen zu den in dieser Version unterstützten Avi-Controller-Versionen unter Versionshinweise zu Tanzu Kubernetes Grid v2.1. Führen Sie gegebenenfalls ein Upgrade des Avi-Controllers auf eine kompatible Version durch. Informationen zum Upgraden des Avi-Controllers finden Sie unter Flexible Upgrades for Avi Vantage.

AWS

Installieren des CSI-Treibers von AWS nach einem Tanzu Kubernetes Grid-Upgrade

Wenn der CSI-Treiber von AWS EBS noch nicht im Cluster installiert wurde, führen Sie diese Schritte zum Installieren des Treibers nach dem Upgrade Ihrer Tanzu Kubernetes Grid-Installation auf v2.1+ durch.

1. Erteilen Sie Berechtigungen für den CSI-Treiber von AWS EBS:

   export AWS_REGION={YOUR_AWS_REGION}
   tanzu mc permissions aws set
   

2. Für jeden Arbeitslastcluster, der CSI-Speicher verwendet:

   1. Exportieren Sie die folgenden Umgebungsvariablen und legen Sie das Funktions-Flag fest:

      export _TKG_CLUSTER_FORCE_ROLE="management"
      export FILTER_BY_ADDON_TYPE="csi/aws-ebs-csi-driver"
      export NAMESPACE="tkg-system"
      export DRY_RUN_MODE="legacy"
      tanzu config set features.cluster.allow-legacy-cluster true
      

      Legen Sie NAMESPACE auf den Namespace des Clusters fest, tkg-system im obigen Beispiel.

   2. Erzeugen Sie das Manifest des CSI-Treibers:

      tanzu cl create ${TARGET_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      Dabei ist TARGET_CLUSTER_NAME der Name des Clusters, in dem Sie den CSI-Treiber installieren.

   3. Aktualisieren Sie den Namespace des geheimen Schlüssels in den Metadaten in csi-driver-addon-manifest.yaml mit dem Namespace des Arbeitslastclusters. Verwenden Sie den Befehl kubectl get cluster -A zum Anzeigen des Namespace des Clusters.

   4. Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   5. Setzen Sie die folgenden Umgebungsvariablen und Funktions-Flags zurück:

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

3. Für jeden Verwaltungscluster, der CSI-Speicher verwendet:

   1. Exportieren Sie die folgenden Umgebungsvariablen:

      export _TKG_CLUSTER_FORCE_ROLE="management"
      export FILTER_BY_ADDON_TYPE="csi/aws-ebs-csi-driver"
      export NAMESPACE="tkg-system"
      export DRY_RUN_MODE="legacy"
      tanzu config set features.cluster.allow-legacy-cluster true
      

      Legen Sie NAMESPACE auf den Namespace des Clusters fest, tkg-system im obigen Beispiel.

   2. Erzeugen Sie das Manifest des CSI-Treibers:

      tanzu mc create ${MANAGEMENT_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      Dabei ist MANAGEMENT_CLUSTER_NAME der Name das Verwaltungsclusters.

   3. Aktualisieren Sie den Namespace des geheimen Schlüssels in den Metadaten in csi-driver-addon-manifest.yaml mit dem Namespace des Verwaltungsclusters. Verwenden Sie den Befehl kubectl get cluster -A zum Anzeigen des Namespace des Clusters.

   4. Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   5. Setzen Sie die folgenden Umgebungsvariablen und Funktions-Flags zurück:

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

Azure

Installieren des CSI-Festplattentreibers von Azure nach einem Tanzu Kubernetes Grid-Upgrade

Wenn der CSI-Festplattentreiber von Azure noch nicht im Cluster installiert wurde, führen Sie diese Schritte zum Installieren dieses Treibers nach dem Upgrade Ihrer Tanzu Kubernetes Grid-Installation auf v2.1+ durch.

1. Exportieren Sie die folgenden Umgebungsvariablen und legen Sie das Funktions-Flag fest:

   export _TKG_CLUSTER_FORCE_ROLE="management"
   export FILTER_BY_ADDON_TYPE="csi/azuredisk-csi-driver"
   export NAMESPACE="tkg-system"
   export DRY_RUN_MODE="legacy"
   tanzu config set features.cluster.allow-legacy-cluster true
   

   Legen Sie NAMESPACE auf den Namespace des Clusters fest, tkg-system im obigen Beispiel.

2. Für jeden Arbeitslastcluster, der CSI-Speicher verwendet:

   1. Erzeugen Sie das Manifest des CSI-Treibers:

      tanzu cl create ${TARGET_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      Dabei ist TARGET_CLUSTER_NAME der Name des Clusters, in dem Sie den CSI-Treiber installieren.

   2. Aktualisieren Sie den Namespace des geheimen Schlüssels in den Metadaten in csi-driver-addon-manifest.yaml mit dem Namespace des Arbeitslastclusters. Verwenden Sie den Befehl kubectl get cluster -A zum Anzeigen des Namespace des Clusters.

   3. Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   4. Setzen Sie die folgenden Umgebungsvariablen und Funktions-Flags zurück:

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

3. Für jeden Verwaltungscluster, der CSI-Speicher verwendet:

   1. Exportieren Sie die folgenden Umgebungsvariablen:

      export _TKG_CLUSTER_FORCE_ROLE="management"
      export FILTER_BY_ADDON_TYPE="csi/azuredisk-csi-driver"
      export NAMESPACE="tkg-system"
      export DRY_RUN_MODE="legacy"
      tanzu config set features.cluster.allow-legacy-cluster true
      

      Legen Sie NAMESPACE auf den Namespace des Clusters fest, tkg-system im obigen Beispiel.

   2. Erzeugen Sie das Manifest des CSI-Treibers:

      tanzu mc create ${MANAGEMENT_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      Dabei ist MANAGEMENT_CLUSTER_NAME der Name das Verwaltungsclusters.

   3. Aktualisieren Sie den Namespace des geheimen Schlüssels in den Metadaten in csi-driver-addon-manifest.yaml mit dem Namespace des Verwaltungsclusters. Verwenden Sie den Befehl kubectl get cluster -A zum Anzeigen des Namespace des Clusters.

   4. Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   5. Setzen Sie die folgenden Umgebungsvariablen und Funktions-Flags zurück:

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

Installieren des CSI-Dateitreibers von Azure nach einem Tanzu Kubernetes Grid-Upgrade

Wenn der CSI-Dateitreiber von Azure noch nicht im Cluster installiert wurde, führen Sie diese Schritte zum Installieren dieses Treibers nach dem Upgrade Ihrer Tanzu Kubernetes Grid-Installation auf v2.1+ durch.

1. Exportieren Sie die folgenden Umgebungsvariablen und legen Sie das Funktions-Flag fest:

   export _TKG_CLUSTER_FORCE_ROLE="management"
   export FILTER_BY_ADDON_TYPE="csi/azurefile-csi-driver"
   export NAMESPACE="tkg-system"
   export DRY_RUN_MODE="legacy"
   tanzu config set features.cluster.allow-legacy-cluster true
   

   Legen Sie NAMESPACE auf den Namespace des Clusters fest, tkg-system im obigen Beispiel.

2. Für jeden Arbeitslastcluster, der CSI-Speicher verwendet:

   1. Erzeugen Sie das Manifest des CSI-Treibers:

      tanzu cl create ${TARGET_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      Dabei ist TARGET_CLUSTER_NAME der Name des Clusters, in dem Sie den CSI-Treiber installieren.

   2. Aktualisieren Sie den Namespace des geheimen Schlüssels in den Metadaten in csi-driver-addon-manifest.yaml mit dem Namespace des Arbeitslastclusters. Verwenden Sie den Befehl kubectl get cluster -A zum Anzeigen des Namespace des Clusters.

   3. Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   4. Setzen Sie die folgenden Umgebungsvariablen und Funktions-Flags zurück:

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

3. Für jeden Verwaltungscluster, der CSI-Speicher verwendet:

   1. Exportieren Sie die folgenden Umgebungsvariablen:

      export _TKG_CLUSTER_FORCE_ROLE="management"
      export FILTER_BY_ADDON_TYPE="csi/azurefile-csi-driver"
      export NAMESPACE="tkg-system"
      export DRY_RUN_MODE="legacy"
      tanzu config set features.cluster.allow-legacy-cluster true
      

      Legen Sie NAMESPACE auf den Namespace des Clusters fest, tkg-system im obigen Beispiel.

   2. Erzeugen Sie das Manifest des CSI-Treibers:

      tanzu mc create ${MANAGEMENT_CLUSTER_NAME} --dry-run -f ~/MANAGEMENT_CLUSTER_CREATE_CONFIG.yaml > csi-driver-addon-manifest.yaml
      

      Dabei ist MANAGEMENT_CLUSTER_NAME der Name das Verwaltungsclusters.

   3. Aktualisieren Sie den Namespace des geheimen Schlüssels in den Metadaten in csi-driver-addon-manifest.yaml mit dem Namespace des Verwaltungsclusters. Verwenden Sie den Befehl kubectl get cluster -A zum Anzeigen des Namespace des Clusters.

   4. Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:

      kubectl apply -f csi-driver-addon-manifest.yaml
      

   5. Setzen Sie die folgenden Umgebungsvariablen und Funktions-Flags zurück:

      unset _TKG_CLUSTER_FORCE_ROLE
      unset FILTER_BY_ADDON_TYPE
      unset NAMESPACE
      unset DRY_RUN_MODE
      tanzu config set features.cluster.allow-legacy-cluster false
      

Upgrade des Tools zur Wiederherstellung und Diagnose nach Systemabsturz

Dieser Schritt muss sowohl für Haupt-Upgrades von v1.6.x auf v2.1.x als auch für Patch-Upgrades von v2.1.x auf v2.1.y durchgeführt werden.

Informationen zum Upgrade des Tools zur Wiederherstellung und Diagnose nach Systemabsturz finden Sie unter Installieren oder Aktualisieren der Binärdatei zur Wiederherstellung und Diagnose nach Systemabsturz.

Nächste Schritte

Überprüfen Sie die aktualisierten Verwaltungscluster oder registrieren Sie sie bei Tanzu Mission Control. Weitere Informationen finden Sie unter Überprüfen und Registrieren eines neu bereitgestellten eigenständigen Verwaltungsclusters.