Upgrade von Anthos-Cluster on Bare Metal ausführen

Upgrade von Anthos-Cluster on Bare Metal ausführen

Wenn Sie eine neue Version von bmctl installieren, können Sie Ihre vorhandenen Cluster aktualisieren, die mit einer früheren Version erstellt wurden. Durch das Upgrade eines Clusters auf die neueste Anthos-Cluster auf Bare-Metal-Version erhalten Sie zusätzliche Features und Fehlerkorrekturen für Ihren Cluster. Außerdem wird so dafür gesorgt, dass Ihr Cluster unterstützt wird. Mit dem Befehl bmctl upgrade cluster können Sie Administrator-, Hybrid-, Standalone- oder Nutzercluster upgraden.

Preflight-Prüfungen werden vor einem Clusterupgrade durchgeführt, um den Clusterstatus und den Knotenstatus zu validieren.

Die folgenden Beispiele zeigen den Upgradeprozess von der ursprünglichen Version 1.6.0 zu Anthos-Cluster on Bare-Metal 1.6.1.

Auf dieselbe Weise können Sie ein Upgrade von 1.6.1 auf 1.6.2 durchführen. Das Überspringen von Upgrades (1.6.0 bis 1.6.2) wird ebenfalls unterstützt.

Administrator-, Standalone- oder Hybrid-Cluster mit Anthos-Cluster on Bare Metal aktualisieren

Wenn Sie eine neue Version von bmctl herunterladen und installieren, können Sie Ihre Administrator-, Hybrid- und eigenständigen Cluster aktualisieren, die mit einer früheren Version erstellt wurden. Bei einer bestimmten Version von bmctl können Cluster nur auf die gleiche Version aktualisiert werden.

Laden Sie zuerst die neueste Version von bmctl herunter. Ändern Sie dann die entsprechenden Cluster-Konfigurationsdateien und geben Sie den Befehl bmctl upgrade cluster aus, um das Upgrade abzuschließen.

  1. Laden Sie die neueste bmctl-Datei aus dem Cloud Storage-Bucket herunter: 
    gsutil cp gs://anthos-baremetal-release/bmctl/1.6.2/linux-amd64/bmctl bmctl
chmod a+x bmctl
  2. Ändern Sie die YAML-Datei für die Clusterkonfiguration, um die "Anthos-Cluster on Bare Metal"-Version von 1.6.1 auf 1.6.2 zu ändern. Das folgende Beispiel zeigt ein Beispiel für eine Administratorclusterkonfiguration:
    3. ---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: cluster1
  namespace: cluster-cluster1
spec:
  # Cluster type. This can be:
  #   1) admin:  to create an admin cluster. This can later be used to create user clusters.
  #   2) user:   to create a user cluster. Requires an existing admin cluster.
  #   3) hybrid: to create a hybrid cluster that runs admin cluster components and user workloads.
  #   4) standalone: to create a cluster that manages itself, runs user workloads, but does not manage other clusters.
  type: admin
  # Anthos cluster version.
  # Change the following line from 1.6.0 to 1.6.1, shown below
  anthosBareMetalVersion: 1.6.1
  3. Verwenden Sie den Befehl bmctl upgrade cluster, um das Upgrade abzuschließen, wobei CLUSTER_NAME der Name des Clusters ist und ADMIN_KUBECONFIG den Pfad der Datei „kubeconfig“ Ihres Administratorclusters angibt: 
    4. bmctl upgrade cluster -c CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG

Upgrade für Nutzercluster durchführen

Sobald Sie einen Administrator-, Hybrid- oder Standalone-Cluster aktualisiert haben, können Sie den von ihm verwalteten Nutzercluster aktualisieren.

Ändern Sie zuerst die entsprechende Konfiguration des Nutzerclusters. Führen Sie dann den Befehl kubectl apply aus, um die überarbeitete Konfigurationsdatei anzuwenden und das Upgrade abzuschließen.

  1. Ändern Sie die YAML-Datei für die Nutzerclusterkonfiguration, um die "Anthos-Cluster on Bare Metal"-Version von 1.6.0 auf 1.6.1 zu ändern.
    2. ---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: cluster1
  namespace: cluster-cluster1
spec:
  # Cluster type. This can be:
  #   1) admin:  to create an admin cluster. This can later be used to create user clusters.
  #   2) user:   to create a user cluster. Requires an existing admin cluster.
  #   3) hybrid: to create a hybrid cluster that runs admin cluster components and user workloads.
  #   4) standalone: to create a cluster that manages itself, runs user workloads, but does not manage other clusters.
  type: user
  # Anthos cluster version.
  # Change the following line from 1.6.0 to 1.6.1, shown below
  anthosBareMetalVersion: 1.6.1
  2. Führen Sie den Befehl „kubectl“ aus, um die überarbeitete Nutzerclusterkonfiguration anzuwenden und den Cluster zu erstellen:
    3.   kubectl --kubeconfig ADMIN_KUBECONFIG apply -f USER_CLUSTER_CONFIG
    ADMIN_KUBECONFIG gibt den Pfad zur Datei "kubeconfig" des Administratorclusters an und USER_CLUSTER_CONFIG gibt den Pfad zur YAML-Datei des Nutzerclusters an, die Sie im vorherigen Abschnitt bearbeitet haben. Für einen Administratorcluster mit dem Namen admin und eine Nutzerclusterkonfiguration mit dem Namen user1 wäre der Befehl beispielsweise: 
    kubectl --kubeconfig bmctl-workspace/admin/admin-kubeconfig apply /
  -f bmctl-workspace/user1/user1.yaml

Upgrade des Nutzerclusters prüfen

Prüfen Sie die Nutzerclusterversion nach einem Upgrade mit dem Befehl kubectl get, um die Version zurückzugeben.

Wenn Sie beispielsweise prüfen möchten, ob die Clusterversion nach Version 1.6.1 nach dem Upgrade auf Version 1.6.0 liegt, führen Sie folgenden Befehl aus:

kubectl get cluster.baremetal.cluster.gke.io -n cluster-USER_CLUSTER_NAME \
  -o jsonpath='{.status.anthosBareMetalVersion}' --kubeconfig ADMIN_KUBECONFIG

Dabei gilt:

  • ADMIN_KUBECONFIG gibt den Pfad zur Datei „kubeconfig“ des Administratorclusters an.
  • USER_CLUSTER_NAME ist der Name Ihres Nutzerclusters.

Wenn das Upgrade erfolgreich war, gibt der Befehl die aktualisierte Versionsnummer zurück. Die Aktualisierung kann bis zu 30 Minuten dauern.