更新有狀態工作負載

本文說明如何更新在 Google Distributed Cloud (GDC) 氣隙 Kubernetes 叢集中執行的現有有狀態工作負載。隨著應用程式根據資源用量和設定最佳化作業演進,您必須更新 Kubernetes 叢集中的基礎 Pod 規格,才能反映這些工作負載變更。如要進一步瞭解如何規劃有狀態工作負載的更新,請參閱 Kubernetes 說明文件中的更新策略

本文適用於應用程式運算子群組中的開發人員,負責為所屬機構更新應用程式工作負載。詳情請參閱 GDC air-gapped 說明文件適用對象

事前準備

如要完成本文中的工作,您必須具備下列資源和角色:

  • 如要對 Kubernetes 叢集執行指令,請確認您具備下列資源:

    • 找出 Kubernetes 叢集名稱,或向平台管理員群組成員詢問叢集名稱。

    • 如果沒有 Kubernetes 叢集的 kubeconfig 檔案,請登入並產生該檔案。

    • 請使用 Kubernetes 叢集的 kubeconfig 路徑,替換這些操作說明中的 KUBERNETES_CLUSTER_KUBECONFIG

  • 如要取得在共用叢集中更新有狀態工作負載的必要權限,請要求貴機構的 IAM 管理員在專案命名空間中,授予您命名空間管理員角色 (namespace-admin)。

  • 如要取得在標準叢集中更新有狀態工作負載的必要權限,請要求組織 IAM 管理員在標準叢集中授予叢集開發人員角色 (cluster-developer)。

更新 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_NAMEStatefulSet物件的名稱。

後續步驟