在 Google Cloud 外升級 Kf

本文說明如何升級現有 Kf 安裝項目及其依附元件。

在升級程序中，請確保 Kf 安裝作業使用最新版本的 Kf 運算子：

  • 確認目前的 Kf 版本可以升級至 Kf v2.11.30。
  • 升級至 Kf v2.11.30。
  • 升級依附元件 (如有需要)。

事前準備

你需要：

  • 已安裝 Kf 的現有叢集。
  • 可存取已安裝 gcloud、kf 和 kubectl 的電腦。

升級前的準備工作

連線至目標叢集

gcloud container hub memberships get-credentials CLUSTER_NAME \
 --zone CLUSTER_ZONE \
 --project CLUSTER_PROJECT_ID

確認目前的 Kf CLI 和伺服器版本相符

執行 kf debug，並確認 Kf CLI 和 Kf 伺服器版本相符。

  • CLI 版本會列在 Kf Client 下方。
  • Kf 伺服器版本會列在 kf["app.kubernetes.io/version"] 下方。
$ kf debug
...
Version:
  Kf Client:                        v2.11.29
  Server version:                   v1.31.1-gke.2105000
  kf["app.kubernetes.io/version"]:  v2.11.29
...

如果 Kf 用戶端和 Kf 伺服器值「不」相符，但伺服器版本為 v2.10.x，請先安裝 Kf v2.11.30 CLI，再繼續操作。

如果 Kf 伺服器值舊於 v2.10.x，您必須先逐步升級至 Kf v2.10.x，才能繼續操作。

請先確認 Kf 正常運作，再升級

執行 kf doctor，檢查叢集狀態。請先確保所有測試都通過，再繼續操作。

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

如果看到任何 FAIL 或 Error: environment failed checks 訊息，請按照 kf doctor 輸出內容中的指引操作，或參閱疑難排解指南解決問題，然後重試指令，直到成功為止。

升級運算子

Kf 運算子會為您執行升級。

  1. 套用運算子 YAML：

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

升級 Kf 依附元件

  1. 升級 Tekton：

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

  2. 升級至 Cloud Service Mesh v1.23.3-asm.1+config1：

    1. 按照 Cloud Service Mesh 升級指南中的步驟操作。

升級至 Kf v2.11.30 CLI

  1. 安裝 CLI：

    Linux

    這項指令會為系統上的所有使用者安裝 Kf CLI。按照「Cloud Shell」分頁中的操作說明，為自己安裝。

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

    Mac

    這項指令會為系統上的所有使用者安裝 kf。

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

    Cloud Shell

    如果您使用 bash，這個指令會在 Cloud Shell 執行個體上安裝 kf。如果是其他殼層，可能需要修改指令。

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

    Windows

    這會將 kf 下載到目前的目錄。如要從目前目錄以外的任何位置呼叫，請將其新增至路徑。

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

  2. 驗證 Kf CLI 和 Kf 伺服器版本是否相符：

    • CLI 版本會列在 Kf Client 下方。
    • Kf 伺服器版本會列在 kf["app.kubernetes.io/version"] 下方。
    $ kf debug
...
Version:
  Kf Client:                        v2.11.30
  Server version:                   v1.31.1-gke.2105000
  kf["app.kubernetes.io/version"]:  v2.11.30
...

確認 Kf 升級成功

  1. 執行 doctor，確保新安裝的版本運作正常：

    kf doctor --retries=20

    這項指令會多次執行叢集檢查。新的控制器啟動時，有幾次嘗試失敗是正常現象。

    如果指令失敗並顯示「Error: environment failed checks」訊息，請按照 doctor 輸出內容中的指引解決問題，然後重試指令，直到成功為止。

如果驗證步驟通過，叢集就已成功升級！如有任何問題，請參閱支援頁面瞭解相關指引。