更新有狀態工作負載

本文說明如何更新在 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 物件的名稱。

後續步驟