Aktualisieren Sie einen Tanzu Kubernetes-Cluster durch Upgrade der Tanzu Kubernetes-Version-Version.

Sie können ein paralleles Update eines Tanzu Kubernetes-Clusters initiieren, indem Sie ein Upgrade der Tanzu Kubernetes-Version-Version durchführen. Die genaue Vorgehensweise richtet sich nach der Version der verwendeten Tanzu Kubernetes Grid-Dienst-API.
TKGS-API-Version Methode zur Versionsaktualisierung
v1alpha2-API Aktualisieren Sie die TKR NAME-Zeichenfolge in den Eigenschaften spec.topology.controlPlane.tkr.refernece.name und spec.topology.nodePools[*].tkr.reference.name im Cluster-Manifest. Weitere Informationen finden Sie unter Aktualisieren einer Tanzu Kubernetes-Version, nachdem die Cluster-Spezifikation in die TKGS v1alpha2-API konvertiert wurde.
v1alpha1-API Aktualisieren Sie die DISTRIBUTION-Version in den Eigenschaften spec.distribution.version und spec.distribution.fullVersion im Cluster-Manifest. Siehe unten.

Voraussetzungen

Überprüfen Sie, ob die Voraussetzungen für die Aktualisierung von Tanzu Kubernetes-Clustern erfüllt werden. Weitere Informationen hierzu finden Sie unter Update von Tanzu Kubernetes-Clustern.

Diese Aufgabe verwendet den Befehl kubectl edit tanzukubernetescluster/CLUSTER-NAME, um das Cluster-Manifest zu aktualisieren. Mit dem Befehl kubectl edit wird das Cluster-Manifest in dem durch die KUBE_EDITOR- oder EDITOR-Umgebungsvariablen definierten Texteditor geöffnet. Wenn Sie die Datei speichern, wird der Cluster mit den Änderungen aktualisiert. Weitere Informationen hierzu finden Sie unter Angeben eines Standardtexteditors für Kubectl.

Prozedur

  1. Authentifizieren Sie sich beim Supervisor-Cluster. Weitere Informationen hierzu finden Sie unter Herstellen einer Verbindung mit dem Supervisor-Cluster als vCenter Single Sign-On-Benutzer. 
    kubectl vsphere login --server=IP-ADDRESS --vsphere-username USERNAME
  2. Ändern Sie den Kontext in den vSphere-Namespace, in dem der Tanzu Kubernetes-Zielcluster bereitgestellt wird. 
    kubectl config use-context SUPERVISOR-NAMESPACE
  3. Rufen Sie den Zielcluster und die Version von Tanzu Kubernetes ab. 
    kubectl get tanzukubernetescluster
    Das Ergebnis bei Verwendung der TKGS-v1alpha2-API lautet beispielsweise: 
    kubectl get tanzukubernetescluster
NAMESPACE        NAME            CONTROL PLANE   WORKER   TKR NAME                             AGE    READY   TKR COMPATIBLE   UPDATES AVAILABLE
tkgs-cluster-1   test-cluster    3               3        v1.21.2---vmware.1-tkg.1.ee25d55     38h    True    True             [1.21.2+vmware.1-tkg.1.ee25d55]
    Das Ergebnis bei Verwendung der TKGS-v1alpha1-API lautet beispielsweise: 
    kubectl get tanzukubernetescluster
NAME             CONTROL PLANE   WORKER   DISTRIBUTION                     AGE   PHASE
tkgs-cluster-1   3               3        v1.19.16+vmware.1-tkg.1.df910e2  19h   running
  4. Listen Sie die verfügbaren Tanzu Kubernetes-Versionen auf. 
    kubectl get tanzukubernetesreleases
  5. Führen Sie den folgenden Befehl aus, um das Cluster-Manifest zu bearbeiten. 
    kubectl edit tanzukubernetescluster/CLUSTER-NAME
  6. Bearbeiten Sie das Manifest, indem Sie Tanzu Kubernetes-Version aktualisieren. Die genaue Vorgehensweise richtet sich nach der Version der verwendeten TKGS-API.
    Wenn Sie die TKGS-v1alpha2-API verwenden, aktualisieren Sie die TKR NAME-Zeichenfolge. Weitere Informationen finden Sie unter Aktualisieren einer Tanzu Kubernetes-Version, nachdem die Cluster-Spezifikation in die TKGS v1alpha2-API konvertiert wurde.
    Wenn Sie die TKGS-v1alpha1-API verwenden, aktualisieren Sie das Manifest beispielsweise von: 
    spec:
  distribution:
    fullVersion: v1.19.16+vmware.1-tkg.1.df910e2
    version: v1.19.16
    auf beispielsweise: 
    spec:
  distribution:
    fullVersion: null
    version: v1.20.12
    Hinweis: Wenn Sie die TKGS-v1alpha1-API verwenden, können Sie die vollqualifizierte Version angeben oder eine Kurzschreibung der Version verwenden, z. B. version: v1.20.12 (wird zum neuesten mit dieser Patchversion übereinstimmenden Image aufgelöst) oder version: v1.20 (wird zur neuesten übereinstimmenden Patchversion aufgelöst). Die aufgelöste Version wird als fullVersion im Cluster-Manifest angezeigt. Um ein Upgrade der Version mithilfe einer Kurzschreibung durchzuführen, müssen Sie die fullVersion deaktivieren oder auf null setzen, um einen potenziellen Versionskonflikt während der Erkennung zu vermeiden.
  7. Speichern Sie die Änderungen an der Manifestdatei.
    Wenn Sie die Datei speichern, wendet kubectl die Änderungen auf den Cluster an. Im Hintergrund stellt der VM-Dienst auf dem Supervisor Cluster den neuen Worker-Knoten bereit.
  8. Vergewissern Sie sich, dass kubectl berichtet, dass die Manifest-Bearbeitungen erfolgreich aufgezeichnet wurden. 
    kubectl edit tanzukubernetescluster/tkgs-cluster-1
tanzukubernetescluster.run.tanzu.vmware.com/tkgs-cluster-1 edited
    Hinweis: Wenn Sie einen Fehler erhalten oder kubectl nicht meldet, dass das Cluster-Manifest erfolgreich bearbeitet wurde, sollten Sie überprüfen, ob Sie Ihren Standardtexteditor mithilfe der Umgebungsvariable KUBE_EDITOR richtig konfiguriert haben. Weitere Informationen hierzu finden Sie unter Angeben eines Standardtexteditors für Kubectl.
  9. Überprüfen Sie, ob der Cluster aktualisiert wird. 
    kubectl get tanzukubernetescluster
NAME             CONTROL PLANE   WORKER   DISTRIBUTION                     AGE   PHASE
tkgs-cluster-1   3               3        v1.20.12+vmware.1-tkg.1.b9a42f3  21h   updating
  10. Überprüfen Sie, ob der Cluster aktualisiert wurde. 
    kubectl get tanzukubernetescluster
NAME             CONTROL PLANE   WORKER   DISTRIBUTION                     AGE   PHASE
tkgs-cluster-1   3               3        v1.20.12+vmware.1-tkg.1.b9a42f3   22h   running