本文說明如何更新在 Google Distributed Cloud (GDC) 實體隔離 Kubernetes 叢集中執行的現有有狀態工作負載。隨著應用程式根據資源用量和設定最佳化調整而演進,您必須更新 Kubernetes 叢集中的基礎 Pod 規格,以反映這些工作負載變更。如要進一步瞭解如何規劃有狀態工作負載的更新,請參閱 Kubernetes 說明文件的更新策略。
本文適用於應用程式營運商群組中的開發人員,他們負責更新組織的應用程式工作負載。詳情請參閱「GDC 實體隔離方案說明文件的目標對象」。
事前準備
如要完成本文件中的工作,您必須要求必要權限並準備環境。
要求 IAM 角色
您必須具備特定角色,才能取得更新有狀態工作負載所需的權限。所需角色取決於您是在組織範圍的共用叢集,還是專案範圍的標準叢集內工作。詳情請參閱「Kubernetes 叢集設定」。
共用叢集角色
如要在共用叢集中建立、刪除、編輯或查看工作負載,請要求 IAM 專案管理員授予您命名空間管理員 (namespace-admin) 角色。這個角色會繫結至專案命名空間。
標準叢集角色
如要在標準叢集中建立、刪除、編輯或查看工作負載,請要求 IAM 專案管理員授予您叢集開發人員 (cluster-developer) 角色。這個角色會繫結至專案命名空間。
準備環境
如要使用 API 對 Kubernetes 叢集執行指令,請確認您具備下列資源:
找出 Kubernetes 叢集名稱,或向平台管理員群組成員詢問叢集名稱。
登入並產生 Kubernetes 叢集的 kubeconfig 檔案。
請使用 Kubernetes 叢集的 kubeconfig 路徑,取代這些操作說明中的
KUBERNETES_CLUSTER_KUBECONFIG。
更新 StatefulSet 資源
如要更新 StatefulSet,請套用新的或更新後的資訊清單檔案。在調度資源或指定新版應用程式時,這項功能可用於對 StatefulSet 進行各種變更。
如要更新 StatefulSet 物件,請執行下列指令:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
apply -f STATEFULSET_FILE
更改下列內容:
KUBERNETES_CLUSTER_KUBECONFIG:執行有狀態工作負載的叢集 kubeconfig 檔案。NAMESPACE:命名空間。如果是共用叢集,則必須是專案命名空間。如果是標準叢集,則可以是任何命名空間。STATEFULSET_FILE:更新後的StatefulSet資訊清單檔案名稱。
kubectl apply 指令會將資訊清單檔案套用至資源。如果指定的資源不存在,則這個指令會建立該資源。
檢查 StatefulSet 資源更新推出作業
您可以查看 StatefulSet 物件的更新推出狀態和記錄詳細資訊。您也可以復原 StatefulSet 物件的推出作業。
檢查推出作業
如要檢查 StatefulSet 資源的推出作業,請執行下列指令:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
rollout status statefulset STATEFULSET_NAME
KUBERNETES_CLUSTER_KUBECONFIG:執行有狀態工作負載的叢集 kubeconfig 檔案。NAMESPACE:命名空間。如果是共用叢集,則必須是專案命名空間。如果是標準叢集,則可以是任何命名空間。STATEFULSET_NAME:更新後的StatefulSet物件名稱。
取得推出記錄
如要查看 StatefulSet 資源的推出記錄,請執行下列指令:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
rollout history statefulset STATEFULSET_NAME
KUBERNETES_CLUSTER_KUBECONFIG:執行有狀態工作負載的叢集 kubeconfig 檔案。NAMESPACE:命名空間。如果是共用叢集,則必須是專案命名空間。如果是標準叢集,則可以是任何命名空間。STATEFULSET_NAME:更新後的StatefulSet物件名稱。
復原推出作業
如要復原推出作業,請執行下列指令:
kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
rollout undo statefulset STATEFULSET_NAME
更改下列內容:
KUBERNETES_CLUSTER_KUBECONFIG:執行有狀態工作負載的叢集 kubeconfig 檔案。NAMESPACE:命名空間。如果是共用叢集,則必須是專案命名空間。如果是標準叢集,則可以是任何命名空間。STATEFULSET_NAME:StatefulSet物件的名稱。