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.
HinweisIm TKG-Upgrade-Pfad folgt v2.2 unmittelbar auf v2.1.1.
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.2.0 durchführen.
Bestimmte Schritte sind nur dann erforderlich, wenn Sie ein kleineres Upgrade von Tanzu Kubernetes Grid v2.1.x auf v2.2.x durchführen. Sie sind nicht notwendig, wenn Sie ein Patch-Upgrade von Tanzu Kubernetes Grid v2.2.x auf v2.2.y durchführen.
Stellen Sie vor dem Upgrade auf TKG v2.2.x sicher, dass Ihre aktuelle Bereitstellung TKG v2.1.x oder eine frühere v2.2-Version ist. Um ein Upgrade auf TKG v2.2.x von Versionen vor v2.1 durchzuführen, müssen Sie zuerst mit der v2.1.x-Version der Tanzu CLI ein Upgrade auf v2.1.x durchführen.
WichtigDie 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.
Dieser Schritt muss sowohl für Haupt-Upgrades von v2.1.x auf v2.2.x als auch für Patch-Upgrades von v2.2.x auf v2.2.y durchgeführt werden.
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.1.x auf 2.2.x als auch beim Upgrade von 2.2.x auf 2.2.y durchführen.
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.
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.2 verwendet Tanzu CLI v0.29.0, basierend auf dem Tanzu Framework v0.29.0.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.
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 v2.1.x auf v2.2.x als auch für Patch-Upgrades von v2.2.x auf v2.2.y durchgeführt werden.
In diesem Verfahren wird davon ausgegangen, dass Sie ein Upgrade auf Tanzu Kubernetes Grid v2.2.x durchführen.
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:
Für Ubuntu 20.04-Images:
WichtigStellen 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.
Folgen Sie den Eingabeaufforderungen des Installationsprogramms, um eine VM aus der OVA bereitzustellen.
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.
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.
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.2.x, k8s-1dot25dot7-ubuntu-2004
, führen Sie Folgendes aus:
az vm image terms accept --urn vmware-inc:tkg-capi:k8s-1dot25dot7-ubuntu-2004:2021.05.17
Wenn Sie für einen der Arbeitslastcluster ein Upgrade auf eine nicht standardmäßige Kubernetes-Version, wie z. B. v1.24.11 oder v1.23.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.
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 v2.1.x auf v2.2.x als auch für Patch-Upgrades von v2.2.x auf v2.2.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.
Dieser Schritt muss sowohl für Haupt-Upgrades von v2.1.x auf v2.2.x als auch für Patch-Upgrades von v2.2.x auf v2.2.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.
Nach dem Upgrade der Cluster müssen weitere Schritte zum Abschließen des Upgrade-Vorgangs durchgeführt werden.
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.
WichtigWenn Sie Prometheus auf einem Arbeitslastcluster installiert haben und den Arbeitslastcluster auf Kubernetes v1.25 upgraden, müssen Sie Prometheus auf Version
2.37.0+vmware.3-tkg.1
aktualisieren. Frühere Versionen des Prometheus-Pakets, wie z. B. Version2.37.0+vmware.1-tkg.1
, sind nicht mit Kubernetes 1.25 kompatibel.
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.
Wenn NSX ALB in Ihrer TKG v2.1-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.1-Installation aktiviert war, finden Sie weitere Informationen zu den in dieser Version unterstützten Avi-Controller-Versionen unter Versionshinweise zu Tanzu Kubernetes Grid v2.2. 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.
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.2+ durch.
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:
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.
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.
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.
Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:
kubectl apply -f csi-driver-addon-manifest.yaml
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:
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.
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.
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.
Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:
kubectl apply -f csi-driver-addon-manifest.yaml
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
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.2+ durch.
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:
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.
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.
Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:
kubectl apply -f csi-driver-addon-manifest.yaml
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:
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.
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.
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.
Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:
kubectl apply -f csi-driver-addon-manifest.yaml
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.2+ durch.
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:
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.
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.
Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:
kubectl apply -f csi-driver-addon-manifest.yaml
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:
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.
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.
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.
Wenden Sie die Änderungen im Kontext des Verwaltungsclusters an:
kubectl apply -f csi-driver-addon-manifest.yaml
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
Dieser Schritt muss sowohl für Haupt-Upgrades von v2.1.x auf v2.2.x als auch für Patch-Upgrades von v2.2.x auf v2.2.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.
Ü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.