更新叢集

gkectl

gkectl update 指令的格式如下：

• gkectl update credentials - 用於更新叢集憑證。

• gkectl update admin - 在管理員叢集設定檔中進行變更後，請執行這項指令。

• gkectl update cluster：在使用者叢集設定檔中進行變更後，請執行這項指令。

管理員叢集範例 (gkectl update admin)

假設您想在管理員叢集中，將 gkeOnPremAPI.enabled 的值從 false 變更為 true，首先，請編輯管理員叢集設定檔，並將值設為 true：

gkeOnPremAPI:
  enabled: true

然後更新管理員叢集：

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG

更改下列內容：

• ADMIN_CLUSTER_KUBECONFIG：管理員叢集 kubeconfig 檔案的路徑

• ADMIN_CLUSTER_CONFIG：管理員叢集設定檔的路徑

使用者叢集範例 (gkectl update cluster)

假設您想在使用者叢集中，將 stackdriver.vSphereDisableResourceMetrics 的值從 false 變更為 true。首先，請編輯使用者叢集設定檔，並將值設為 true：

stackdriver:
  disableVsphereResourceMetrics: true

然後更新使用者叢集：

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG

更改下列內容：

• ADMIN_CLUSTER_KUBECONFIG：管理員叢集 kubeconfig 檔案的路徑

• USER_CLUSTER_CONFIG：使用者叢集設定檔的路徑

使用者叢集範例 (gkectl update credentials)

假設您想變更使用者叢集用於呼叫 vCenter Server 的憑證。

使用者叢集設定檔具有 vCenter.credentials.fileRef.path 欄位，指向憑證設定檔。在憑證設定檔中，更新 username 和 password 的值。例如：

items:
- name: "vcenter-creds"
  username: "new-vcenter-account"
  password: "U$icUKEW#INE"

然後更新憑證：

gkectl update credentials vsphere \
    --config USER_CLUSTER_CONFIG \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

更改下列內容：

• USER_CLUSTER_CONFIG：使用者叢集設定檔的路徑

• ADMIN_CLUSTER_KUBECONFIG：管理員叢集 kubeconfig 檔案的路徑

控制台

1. 在控制台中，前往「Google Kubernetes Engine clusters overview」(Google Kubernetes Engine 叢集總覽) 頁面。

   前往 GKE 叢集

2. 選取 Google Cloud 專案，然後選取要更新的叢集。

3. 在「詳細資料」面板中，按一下「瞭解詳情」。

4. 可在 Google Cloud 控制台中更新的欄位會顯示鉛筆圖示。按一下其中一個鉛筆圖示。在隨即開啟的方塊中，視需要變更欄位值，然後按一下「完成」。

5. 按一下頁面頂端進度列中的「顯示詳細資料」。等待更新完成。

gcloud CLI

執行適用的更新指令。請僅指定要修改的設定標記：

• 管理員叢集： gcloud container vmware admin-clusters update

• 使用者叢集： gcloud container vmware clusters update

• 使用者叢集中的節點集區： gcloud container vmware node-pools update

更新使用者叢集的管理員

每個叢集的 Kubernetes API 伺服器都必須能夠授權收到的要求。如要設定授權，您必須在每個叢集上設定 Kubernetes 角色型存取權控管 (RBAC) 政策。管理員使用者是指在使用者叢集中獲派 cluster-admin 角色的使用者。這個角色會授予使用者叢集的完整管理存取權。

假設 Alice 和 Bob 是 us-west1 地區中，名為 cluster-1 的使用者叢集上唯一的管理員使用者。假設 Alice 想將 Trent 新增為額外的管理員使用者，Alice 可以執行下列指令：

gcloud container vmware clusters update cluster-1 \
    --project example-project-id-12345 \
    --location us-west1 \
    --admin-users alice@example.com \
    --admin-users bob@example.com \
    --admin-users trent@example.com

上述指令會將 Alice 和 Bob 保留在管理員使用者清單中，並將 Trent 新增至管理員使用者清單。請注意，Alice 和 Bob 必須列在指令中，因為指令會以指令中指定的清單，覆寫目前的管理員使用者清單。另請注意，每個 --admin-users 標記只會指定一位使用者。您無法在單一旗標中指定多位使用者。

Terraform

1. 在用於建立叢集或節點集區的 Terraform 設定檔中，變更適用欄位的值。如需詳細的欄位說明，請參閱 Terraform 參考說明文件：

   • google_gkeonprem_vmware_cluster

   • google_gkeonprem_vmware_node_pool

2. 執行 terraform apply 更新設定。

更新使用者叢集的管理員

每個叢集的 Kubernetes API 伺服器都必須能夠授權收到的要求。如要設定授權，您必須在每個叢集上設定 Kubernetes 角色型存取權控管 (RBAC) 政策。管理員使用者是指在使用者叢集中獲派 cluster-admin 角色的使用者。這個角色會授予使用者叢集的完整管理存取權。

假設在特定使用者叢集中，只有 Alice 和 Bob 是管理員使用者。假設 Alice 想新增 Trent 為管理員使用者，Alice 可以如下調整 Terraform 設定，然後執行 terraform apply：

authorization {
  admin_users {
    username = "alice@example.com"
    username = "bob@example.com"
    username = "trent@example.com"
  }
}

上述調整作業會將 Alice 和 Bob 保留在管理員使用者清單中，並將 Trent 新增至管理員使用者清單。請注意，Alice 和 Bob 必須列在新設定中，因為 terraform apply 指令會以設定中指定的清單，覆寫目前管理員使用者的清單。