Upgrade von Kf in Google Cloud ausführen

Sorgen Sie im Rahmen des Upgrades dafür, dass für Ihre Kf-Installation die aktuelle Version des Kf-Operators verwendet wird:

• Prüfen Sie, ob Ihre aktuelle Kf-Version auf Kf v2.11.28 aktualisiert werden kann.
• Führen Sie ein Upgrade auf Kf v2.11.28 aus.
• Aktualisieren Sie die Abhängigkeiten (falls erforderlich).

Hinweis

Folgendes wird benötigt:

• Ein vorhandener Cluster, auf dem Kf installiert ist
• Zugriff auf einen Computer, auf dem gcloud, kf und kubectl installiert sind

Vorbereitung auf das Upgrade

Mit Ihrem Zielcluster verbinden

gcloud container clusters get-credentials CLUSTER_NAME \
 --zone CLUSTER_ZONE \
 --project CLUSTER_PROJECT_ID

Prüfen, ob die aktuelle Kf-Befehlszeile und die Serverversionen übereinstimmen

Führen Sie kf debug aus und prüfen Sie, ob die Kf-Befehlszeile und die Kf-Serverversionen übereinstimmen.

• Die CLI-Version ist unter Kf Client aufgeführt.
• Die Kf-Serverversion ist unter kf["app.kubernetes.io/version"] aufgeführt.

$ kf debug
...
Version:
  Kf Client:                        v2.11.27
  Server version:                   v1.31.1-gke.2105000
  kf["app.kubernetes.io/version"]:  v2.11.27
...

Wenn die Werte des Kf-Clients und des Kf-Servers nicht übereinstimmen, die Serverversion aber v2.10.x ist, installieren Sie die Kf-Befehlszeile v2.11.28, bevor Sie fortfahren.

Wenn der Kf-Serverwert älter als v2.10.x ist, müssen Sie zuerst ein Upgrade auf Kf v2.10.x durchführen, um fortfahren zu können.

Kf vor dem Upgrade auf Fehlerfreiheit prüfen

Führen Sie kf doctor aus, um den Status des Clusters zu prüfen. Sorgen Sie dafür, dass alle Tests bestanden werden, bevor Sie fortfahren.

$ kf doctor
...
=== RUN doctor/user
=== RUN doctor/user/ContainerRegistry
--- PASS: doctor/user
   --- PASS: doctor/user/ContainerRegistry
...

Wenn Sie FAIL- oder Error: environment failed checks-Meldungen sehen, folgen Sie den Anweisungen in der kf doctor-Ausgabe oder lesen Sie die Anleitung zur Fehlerbehebung, um das Problem zu beheben und den Befehl noch einmal auszuführen, bis er erfolgreich ist.

Operator aktualisieren

Der Kf-Operator führt Upgrades für Sie aus.

1. Wenden Sie die Operator-YAML-Datei an:

   kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.11.28/operator.yaml"

Upgrade von Kf-Abhängigkeiten

1. Aktualisieren Sie Tekton:

   kubectl apply -f "https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.68.0/release.yaml"

2. Führen Sie ein Upgrade auf Cloud Service Mesh Version 1.23.3-asm.1 + Config1 durch:

   1. Folgen Sie der Anleitung im Upgrade-Leitfaden für Cloud Service Mesh.

1. Config Connector aktualisieren/installieren:

   Bei einem Upgrade von Kf v2.11: Führen Sie die Schritte unter „Config Connector installieren“ in Kf installieren aus.

   Bei einem Upgrade von Kf v2.7:

   1. Laden Sie die erforderliche TAR-Datei für den Config Connector-Operator herunter:

   2. Extrahieren Sie die TAR-Datei.

      tar zxvf release-bundle.tar.gz

   3. Installieren Sie den Config Connector-Operator in Ihrem Cluster:

      kubectl apply -f operator-system/configconnector-operator.yaml

Upgrade auf die Kf-Befehlszeile v2.11.28

1. Installieren Sie die Befehlszeile:

   Linux

   Mit diesem Befehl wird die Kf-Befehlszeile für alle Nutzer im System installiert. Folgen Sie der Anleitung auf dem Cloud Shell-Tab, um Kf nur für die eigene Nutzung zu installieren.

   gcloud storage cp gs://kf-releases/v2.11.28/kf-linux /tmp/kf
   chmod a+x /tmp/kf
   sudo mv /tmp/kf /usr/local/bin/kf

   Mac

   Mit diesem Befehl wird kf für alle Nutzer im System installiert.

   gcloud storage cp gs://kf-releases/v2.11.28/kf-darwin /tmp/kf
   chmod a+x /tmp/kf
   sudo mv /tmp/kf /usr/local/bin/kf

   Cloud Shell

   Mit diesem Befehl wird kf auf Ihrer Cloud Shell-Instanz installiert, wenn Sie bash verwenden. Für andere Shells muss die Anleitung möglicherweise geändert werden.

   mkdir -p ~/bin
   gcloud storage cp gs://kf-releases/v2.11.28/kf-linux ~/bin/kf
   chmod a+x ~/bin/kf
   echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
   source ~/.bashrc

   Windows

   Dadurch wird kf in das aktuelle Verzeichnis heruntergeladen. Fügen Sie dies dem Pfad hinzu, wenn Sie es von außerhalb des aktuellen Verzeichnisses aufrufen möchten.

   gcloud storage cp gs://kf-releases/v2.11.28/kf-windows.exe kf.exe

2. Prüfen Sie, ob die Kf-Befehlszeile und die Kf-Serverversionen übereinstimmen:

   • Die CLI-Version ist unter Kf Client aufgeführt.
   • Die Kf-Serverversion ist unter kf["app.kubernetes.io/version"] aufgeführt.

   $ kf debug
   ...
   Version:
     Kf Client:                        v2.11.28
     Server version:                   v1.31.1-gke.2105000
     kf["app.kubernetes.io/version"]:  v2.11.28
   ...
   

Erfolgreiche Aktualisierung von Kf prüfen

1. Führen Sie doctor aus, um sicherzustellen, dass die neu installierte Version fehlerfrei ist:

   kf doctor --retries=20

   Der Befehl führt Clusterprüfungen mehrmals aus. Es ist ganz normal, dass einige Versuche fehlschlagen, während die neuen Controller gestartet werden.

   Wenn der Befehl mit der Meldung Error: environment failed checks fehlschlägt, befolgen Sie die Anweisungen in der Ausgabe doctor, um das Problem zu beheben, und wiederholen Sie den Befehl, bis der Vorgang erfolgreich ist.

Wenn die Verifizierung bestanden wurde, wurde der Cluster erfolgreich aktualisiert. Wenn Sie Probleme haben, finden Sie weitere Informationen auf der Seite Support.