Upgrade von Kf in Google Cloud ausführen

In diesem Dokument wird beschrieben, wie Sie eine bestehende Kf-Installation und deren Abhängigkeiten aktualisieren.

Mit dem Upgrade sorgen Sie u. a. dafür, dass für Ihre Kf-Installation die neueste Version des Kf-Operators verwendet wird:

Bestätigen Sie, dass Ihre aktuelle Kf-Version auf Kf v2.6.1 aktualisiert werden kann.
Führen Sie ein Upgrade auf Kf v2.6.1 durch.
Aktualisieren Sie die Abhängigkeiten (falls erforderlich).

Hinweis

Folgendes wird benötigt:

Einen vorhandenen Cluster, auf dem Kf installiert ist.
Zugriff auf einen Computer, auf dem gcloud, kf und kubectl installiert sind.

Vorbereitung auf das Upgrade

Mit Ihrem Ziel-Cluster verbinden

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

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

Führen Sie kf debug aus und prüfen Sie, ob die Kf-Kommandozeile 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.5.4
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.5.4
...

Wenn die Werte von Kf-Client und Kf-Server nicht übereinstimmen, die Serverversion aber v2.5.x ist, installieren Sie die Kf v2.6.1-Befehlszeile, bevor Sie fortfahren.

Wenn der Kf-Serverwert älter als v2.5.x ist, müssen Sie zuerst ein Upgrade auf Kf v2.5.x durchführen, um fortzufahren.

Kf auf Fehlerfreiheit vor dem Upgrade 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.

Wenden Sie die Operator-YAML-Datei an:

Hinweis: Dieser Vorgang beginnt sofort und kann nicht rückgängig gemacht werden.
```
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.6.1/operator.yaml"
```

Upgrade von Kf-Abhängigkeiten

Aktualisieren Sie Tekton:

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

Führen Sie ein Upgrade auf das neueste Anthos Service Mesh durch:
1. Folgen Sie der Anleitung im Upgrade-Leitfaden für Anthos Service Mesh.

Aktualisieren Sie Config Connector.
1. Laden Sie die erforderliche TAR-Datei für Config Connector-Operator herunter:
  
  Hinweis: Erstellen Sie eine Kopie des Installationspakets, da Sie dieses benötigen, um Config Connector zu deinstallieren.
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 v2.6.1-Befehlszeile ausführen

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.
```
gsutil cp gs://kf-releases/v2.6.1/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.
```
gsutil cp gs://kf-releases/v2.6.1/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
```
Cloud Shell
Durch diesen 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
gsutil cp gs://kf-releases/v2.6.1/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 es dem Pfad hinzu, wenn Sie es von außerhalb des aktuellen Verzeichnisses aufrufen möchten.
```
gsutil cp gs://kf-releases/v2.6.1/kf-windows.exe kf.exe
```
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.6.1
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.6.1
...
```

Erfolgreiche Aktualisierung von Kf prüfen

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 war.

Wenn die Verifizierung ausgeführt wurde, wurde der Cluster erfolgreich aktualisiert. Wenn Sie Probleme haben, lesen Sie die Supportseite.