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.

Im TKG-Upgrade-Pfad folgt v2.4 unmittelbar auf v2.3.

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. Bei diesem Verfahren wird davon ausgegangen, dass Sie ein Upgrade auf Tanzu Kubernetes Grid v2.4.0 durchführen.

Einige Schritte sind nur erforderlich, wenn Sie ein kleineres Upgrade von Tanzu Kubernetes Grid v2.3.x auf v2.4.x durchführen und nicht erforderlich sind, wenn Sie ein Patch-Upgrade von Tanzu Kubernetes Grid v2.4.x auf v2.4.y durchführen.

Wichtig
Tanzu Kubernetes Grid v2.4.x ist die letzte Version von TKG, die das Upgrade vorhandener eigenständiger TKG-Verwaltungscluster und TKG-Arbeitslastcluster auf AWS und Azure unterstützt. Die Möglichkeit, eigenständige TKG-Verwaltungscluster und TKG-Arbeitslastcluster auf AWS und Azure zu aktualisieren, wird in version Tanzu Kubernetes Grid v2.5 entfernt.

Ab sofort empfiehlt VMware die Verwendung von Tanzu Mission Control zur Erstellung nativer AWS EKS- und Azure AKS-Cluster. Das Upgrade vorhandener eigenständiger TKG-Verwaltungscluster und TKG-Arbeitslastcluster auf AWS und Azure wird jedoch für alle TKG-Versionen bis einschließlich TKG v2.4.x vollständig unterstützt.

Weitere Informationen finden Sie unter Veraltete TKG-Verwaltungs- und -Arbeitslastcluster in AWS und Azure in den Versionshinweisen zu VMware Tanzu Kubernetes Grid v2.4.

Voraussetzungen

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

Überprüfen Ihrer TKG-Version

Wenn Sie nicht sicher sind, welche Version von TKG in Ihrem Verwaltungscluster ausgeführt wird, können Sie die Version aus dem Verwaltungsclusterobjekt extrahieren.

Führen Sie den Befehl tanzu context use aus, um eine interaktive Liste der Verwaltungscluster anzuzeigen, die für das Upgrade verfügbar sind.
```
tanzu context use
```
Wählen Sie den Verwaltungscluster aus, den Sie überprüfen möchten.
Rufen Sie die Admin-Anmeldedaten des Clusters ab. Der Tanzu CLI-Alias mc ist die Abkürzung für management-cluster.
```
tanzu mc kubeconfig get --admin
```
Verbinden Sie kubectl mit dem Verwaltungscluster.
```
kubectl config use-context MGMT-CLUSTER-NAME-admin@MGMT-CLUSTER-NAME.
```
Sie können den genauen Befehl, einschließlich des Namens des Verwaltungsclusterkontexts, aus der Ausgabe des Befehls tanzu mc kubeconfig get --admin kopieren, den Sie im vorherigen Schritt ausgeführt haben.
Führen Sie den Befehl kubectl get cluster aus, um die TKG-Version zu extrahieren.
```
kubectl get cluster MGMT-CLUSTER-NAME -n tkg-system -o yaml | grep TKGVERSION
```
Die Ausgabe zeigt die Version von TKG an, die in Ihrem Verwaltungscluster ausgeführt wird, wie z. B.:
```
TKGVERSION: v2.3.0
```

Herunterladen und Installieren der neuen Version der Tanzu CLI

Dieser Schritt ist sowohl für größere Upgrades von v2.3.x auf v2.4.x als auch für patchen von v2.4.x auf v2.4.y erforderlich.

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

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 2.3.x auf 2.4.x als auch beim Upgrade von 2.4.x auf 2.4.y durchführen.
Befolgen Sie die Anweisungen unter Installieren der Tanzu CLI und Kubernetes-CLI 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. Wenn einer Ihrer eigenständigen Verwaltungscluster für die Verwendung eines LDAP-Identitätsanbieters konfiguriert ist, führen Sie die Schritte unter (nur LDAP) Aktualisieren der LDAP-Einstellungen aus, nachdem Sie Tanzu CLI installiert haben und bevor Sie Ihre CLI-Plug-Ins auf Tanzu Kubernetes Grid v2.4 aktualisieren.
Führen Sie tanzu version nach der Installation der Tanzu CLI aus, um sicherzustellen, dass die korrekte Version der Tanzu CLI ordnungsgemäß installiert wurde. Eine Liste der CLI-Versionen, die mit Tanzu Kubernetes Grid v2.4 kompatibel sind, finden Sie unter Produkt-Interoperabilitätsmatrix.
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 ist sowohl für größere Upgrades von v2.3.x auf v2.4.x als auch für patchen von v2.4.x auf v2.4.y erforderlich.

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.

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

Öffnen Sie die Download-Seite von Tanzu Kubernetes Grid und melden Sie sich mit Ihren Anmeldedaten für VMware Customer Connect an.
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.27.5: Photon v3 Kubernetes v1.27.5-OVA
- Kubernetes v1.26.8: Photon v3 Kubernetes v1.26.8-OVA
- Kubernetes v1.25.13: Photon v3 Kubernetes v1.25.13-OVA
Für Ubuntu 20.04-Images:
- Kubernetes v1.27.5: Ubuntu 2004 Kubernetes v1.27.5 OVA
- Kubernetes v1.26.8: Ubuntu 2004 Kubernetes v1.26.8 OVA
- Kubernetes v1.25.13: Ubuntu 2004 Kubernetes v1.25.13 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.
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.
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.
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.
Klicken Sie auf Fertigstellen (Finish), um die VM bereitzustellen.
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.
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

Nach der Installation der neuen Version der Tanzu CLI und anderer Tools, aber vor dem Upgrade eines Verwaltungsclusters, müssen Sie die Berechtigungen in Ihrem AWS-Konto zurücksetzen, indem Sie den Befehl tanzu mc permissions aws set ausführen.

tanzu mc permissions aws set

Dieser Schritt ist entweder für Haupt-Upgrades von v2.3.x auf v2.4.x oder für Patches von v2.4.x auf v2.4.y erforderlich. Weitere Informationen zur AWS-Berechtigung, die der Befehl festlegt, finden Sie unter Erforderliche AWS-Berechtigungen.

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:

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
```
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.4.0, k8s-1dot27dot5-ubuntu-2004, führen Sie Folgendes aus:
```
az vm image terms accept --urn vmware-inc:tkg-capi:k8s-1dot27dot5-ubuntu-2004:2021.05.17
```
Wenn Sie einen Ihrer Arbeitslastcluster auf eine nicht standardmäßige Kubernetes-Version wie v1.26.8 oder v1.25.13 aktualisieren 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 ist sowohl für größere Upgrades von v2.3.x auf v2.4.x als auch für patchen von v2.4.x auf v2.4.y erforderlich.

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 ist sowohl für größere Upgrades von v2.3.x auf v2.4.x als auch für patchen von v2.4.x auf v2.4.y erforderlich.

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.11.1 ist und Ihre beiden vorherigen Tanzu Kubernetes Grid-Installationen cert-manager v1.10.1 und v1.7.2 ausgeführt haben, können Sie die cert-manager-Versionen v1.11.1, v1.10.1 und v1.7.2 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.

Wichtig
Wenn Sie Prometheus auf einem Arbeitslastcluster installiert haben und den Arbeitslastcluster auf Kubernetes v1.25 upgraden, müssen Sie Prometheus mindestens auf Version 2.37.0+vmware.3-tkg.1 aktualisieren. Frühere Versionen des Prometheus-Pakets, wie z. B. Version 2.37.0+vmware.1-tkg.1, sind nicht mit Kubernetes 1.25 kompatibel.

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 v2.3-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 v2.3-Installation aktiviert war, finden Sie weitere Informationen zu den in dieser Version unterstützten Avi-Controller-Versionen unter Versionshinweise zu Tanzu Kubernetes Grid v2.4. 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 EBS CSI-Treibers von AWS nach einem Tanzu Kubernetes Grid-Upgrade

TKG v2.2 und höher installieren den EBS CSI-Treibers von AWS automatisch auf neu erstellten Arbeitslastclustern. Um EBS CSI auf AWS jedoch auf Clustern auszuführen, die von v2.1 aktualisiert wurden, muss der Treiber manuell installiert werden. Gehen Sie wie folgt vor, um den EBS CSI-Treiber von AWS manuell auf einem Cluster zu installieren, der mit TKG v2.1 oder früher erstellt wurde und auf dem der EBS CSI-Treiber von AWS noch nie installiert wurde.

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

export AWS_REGION={YOUR_AWS_REGION}
tanzu mc permissions aws set

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
```
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

TKG v2.1 und höher installieren den CSI-Treiber für Azure-Datenträger automatisch auf neu erstellten Arbeitslastclustern. Um den CSI-Treiber für Azure-Datenträger jedoch auf Clustern auszuführen, die von v1.6 aktualisiert wurden, muss der Treiber manuell installiert werden. Gehen Sie wie folgt vor, um den CSI-Treiber für Azure-Datenträger manuell auf einem Cluster zu installieren, der mit TKG v1.6 oder früher erstellt wurde und auf dem der CSI-Treiber für Azure-Datenträger noch nie installiert wurde.

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.

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
```
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 Cluster ihn zuvor noch nicht installiert hat, führen Sie dieses Verfahren aus, um den Azure File CSI-Treiber nach dem Upgrade Ihrer Tanzu Kubernetes Grid-Installation auf v2.4+ zu installieren.

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.

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
```
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 ist sowohl für größere Upgrades von v2.3.x auf v2.4.x als auch für patchen von v2.4.x auf v2.4.y erforderlich.

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.