升級節點集區

gkectl

1. 在下列預留位置變數中定義來源版本和目標版本。所有版本都必須是完整版本號碼，格式為 x.y.z-gke.N，例如 1.16.11-gke.25。

   版本	說明
   SOURCE_VERSION	目前的叢集版本。
   TARGET_VERSION	選取目標版本。從目標次要版本中選取 建議修補程式。

2. 將管理員工作站升級至目標版本。等待系統顯示升級成功訊息。

3. 將對應的 OS 映像檔匯入 vSphere：

   gkectl prepare \
     --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz \
     --kubeconfig ADMIN_CLUSTER_KUBECONFIG
   

   將 ADMIN_CLUSTER_KUBECONFIG 替換為管理員叢集 kubeconfig 檔案的路徑。

4. 在使用者叢集設定檔中進行下列變更：

   • 將 gkeOnPremVersion 欄位設為目標版本 TARGET_VERSION。

   • 針對要升級的每個節點集區，將 nodePools.nodePool[i].gkeOnPremVersion 欄位設為空字串。

     • 在 1.28 以上版本中，您可以將 nodePools.nodePool[i].updateStrategy.rollingUpdate.maxSurge 欄位 設為大於 1 的整數值，加快節點集區升級速度。使用 maxSurge 升級節點時，升級多個節點所需的時間，與升級單一節點的時間相同。

   • 針對每個不想升級的節點集區，請將 nodePools.nodePool[i].gkeOnPremVersion 設為來源版本 SOURCE_VERSION。

   以下範例顯示使用者叢集設定檔的一部分。這項設定指定控制層和 pool-1 將升級至 TARGET_VERSION，但 pool-2 會維持在 SOURCE_VERSION。

   gkeOnPremVersion: TARGET_VERSION
   ...
   nodePools:
   - name: pool-1
     gkeOnPremVersion: ""
     ...
   - name: pool-2
     gkeOnPremVersion: SOURCE_VERSION
     ...
   

5. 升級控制層和所選節點集區：

   gkectl upgrade cluster \
     --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
     --config USER_CLUSTER_CONFIG_FILE
   

   將 USER_CLUSTER_CONFIG 替換為使用者叢集設定檔的路徑。

升級其他節點集區

以前述範例為例，假設 pool-1 一切運作正常，現在您想升級 pool-2。

1. 在使用者叢集設定檔的 pool-2 下，將 gkeOnPremVersion 設為空字串：

   gkeOnPremVersion: TARGET_VERSION
   ...
   nodePools:
   - name: pool-1
     gkeOnPremVersion: ""
     ...
   - name: pool-2
     gkeOnPremVersion: ""
     ...
   

2. 執行 gkectl update cluster 來套用變更：

   gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
     --config USER_CLUSTER_CONFIG
   

gcloud CLI

升級使用者叢集時，需要對管理員叢集進行一些變更。gcloud container vmware clusters upgrade 指令會自動執行下列操作：

• 向 GKE On-Prem API 註冊管理員叢集 (如果尚未註冊)。

• 下載並將一組元件部署至管理員叢集。元件版本與您指定的升級版本相符。管理員叢集可透過這些元件管理該版本的使用者叢集。

升級控制層

請按照下列步驟升級使用者叢集的控制層。

1. 更新 Google Cloud CLI 元件：

   gcloud components update
   

2. 變更叢集的升級政策：

   gcloud container vmware clusters update USER_CLUSTER_NAME \
     --project=PROJECT_ID \
     --location=REGION \
     --upgrade-policy control-plane-only=True
   

   更改下列內容：

   • USER_CLUSTER_NAME：要升級的使用者叢集名稱。

   • PROJECT_ID：機群主專案的 ID，使用者叢集是該專案的成員。這是您在建立叢集時指定的專案。如果您使用 gkectl 建立叢集，這個 ID 就是叢集設定檔中 gkeConnect.projectID 欄位的專案 ID。

   • REGION：GKE On-Prem API 執行及儲存中繼資料的 Google Cloud 區域。如果您是使用 GKE On-Prem API 用戶端建立叢集，這個地區就是您建立叢集時選取的地區。如果您使用 gkectl 建立叢集，這個區域就是您在 GKE On-Prem API 中註冊叢集時指定的區域。

3. 升級叢集的控制層：

   gcloud container vmware clusters upgrade USER_CLUSTER_NAME \
     --project=PROJECT_ID \
     --location=REGION \
     --version=TARGET_VERSION
   

   將 TARGET_VERSION 替換為要升級的版本。從目標次要版本中選取「建議修補程式」。

   指令輸出內容如下所示：

   Waiting for operation [projects/example-project-12345/locations/us-west1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.
   

   在範例輸出內容中，字串 operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179 是長時間執行的作業的 OPERATION_ID。您可以在另一個終端機視窗中執行下列指令，瞭解作業狀態：

   gcloud container vmware operations describe OPERATION_ID \
     --project=PROJECT_ID \
     --location=REGION
   

升級節點集區

使用者叢集的控制層升級後，請按照下列步驟升級節點集區：

1. 取得使用者叢集中的節點集區清單：

   gcloud container vmware node-pools list
     --cluster=USER_CLUSTER_NAME  \
     --project=PROJECT_ID \
     --location=REGION
   

2. 針對要升級的每個節點集區，執行下列指令：

   gcloud container vmware node-pools update NODE_POOL_NAME \
     --cluster=USER_CLUSTER_NAME  \
     --project=PROJECT_ID \
     --location=REGION \
     --version=TARGET_VERSION
   

Terraform

1. 更新 Google Cloud CLI 元件：

   gcloud components update
   

2. 如果尚未註冊，請在 GKE On-Prem API 中註冊管理員叢集。叢集註冊 GKE On-Prem API 後，就不必再次執行這個步驟。

3. 下載新版元件，並部署至管理叢集：

   gcloud vmware admin-clusters update ADMIN_CLUSTER_NAME \
     --project=PROJECT_ID \
     --location=REGION \
     --required-platform-version=TARGET_VERSION
   

   更改下列內容：

   • USER_CLUSTER_NAME：要升級的使用者叢集名稱。

   • PROJECT_ID：機群主專案的 ID，使用者叢集是該專案的成員。這是您在建立叢集時指定的專案。如果您使用 gkectl 建立叢集，這個 ID 就是叢集設定檔中 gkeConnect.projectID 欄位的專案 ID。

   • REGION：GKE On-Prem API 執行及儲存中繼資料的 Google Cloud 區域。如果您是使用 GKE On-Prem API 用戶端建立叢集，這個地區就是您建立叢集時選取的地區。如果您使用 gkectl 建立叢集，這個區域就是您在 GKE On-Prem API 中註冊叢集時指定的區域。

   • TARGET_VERSION：要升級的版本。從目標次要版本中選取建議修補程式。

   這項指令會將您在 --required-platform-version 中指定的元件版本下載至管理員叢集，然後部署元件。管理員叢集可透過這些元件管理該版本的使用者叢集。

4. 在用於建立使用者叢集的 main.tf 檔案中，將叢集資源中的 on_prem_version 變更為新版本。

5. 在叢集資源中新增下列項目，確保只有控制層會升級：

   upgrade_policy {
     control_plane_only = true
   }
   

6. 初始化並建立 Terraform 方案：

   terraform init
   

   Terraform 會安裝任何需要的程式庫，例如 Google Cloud供應商。

7. 檢查設定並視需要進行變更：

   terraform plan
   

8. 套用 Terraform 方案，建立使用者叢集：

   terraform apply
   

升級節點集區

使用者叢集的控制層升級後，請按照下列步驟升級節點集區：

1. 在要升級的每個節點集區的資源中，於 main.tf 新增下列項目：

   on_prem_version = "TARGET_VERSION"
   

   例如：

   resource "google_gkeonprem_vmware_node_pool" "nodepool-basic" {
   name = "my-nodepool"
   location = "us-west1"
   vmware_cluster = google_gkeonprem_vmware_cluster.default-basic.name
   config {
     replicas = 3
     image_type = "ubuntu_containerd"
     enable_load_balancer = true
   }
   on_prem_version = "1.16.0-gke.0"
   }
   

2. 初始化並建立 Terraform 方案：

   terraform init
   

3. 檢查設定並視需要進行變更：

   terraform plan
   

4. 套用 Terraform 方案，建立使用者叢集：

   terraform apply