在 Google Cloud 升級 Kf

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

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

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

事前準備

你需要：

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

為升級做好準備

連線至目標叢集

gcloud container clusters 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.7.3
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.7.3
...

如果 Kf 用戶端和 Kf 伺服器值不相符，但伺服器版本為 v2.7.x，請安裝 Kf v2.9.0 CLI，然後再繼續。

如果 Kf 伺服器值舊於 v2.7.x，您必須先逐步升級至 Kf v2.7.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.9.0/operator.yaml"

升級 Kf 依附元件

  1. 升級 Tekton：

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

  2. 升級至 Cloud Service Mesh 1.12 版：

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

  1. 升級/安裝 Config Connector：

    如要從 Kf 2.8 版升級： 請按照「Kf 安裝」中的「安裝 Config Connector」步驟操作。

    如要從 Kf v2.7 升級：

    1. 下載所需的 Config Connector Operator tar 檔案。

    2. 解壓縮 tar 檔案。

      tar zxvf release-bundle.tar.gz

    3. 在叢集上安裝 Config Connector 運算子。

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

升級至 Kf v2.9.0 CLI

  1. 安裝 CLI：

    Linux

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

    gcloud storage cp gs://kf-releases/v2.9.0/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.9.0/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.9.0/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.9.0/kf-windows.exe kf.exe

  2. 確認 Kf CLI 和 Kf 伺服器版本相符：

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

確認 Kf 升級成功

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

    kf doctor --retries=20

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

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

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