更新有狀態工作負載

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

本頁面適用於應用程式運算子群組中的開發人員，負責更新所屬機構的應用程式工作負載。

事前準備

如要完成本文中的工作，您必須要求必要的權限並準備環境。

要求 IAM 角色

如要在 Kubernetes 叢集中建立、刪除、編輯或查看具狀態工作負載，請要求機構身分與存取權管理員授予您命名空間管理員 (namespace-admin) 角色。這個角色會繫結至專案命名空間。

準備環境

如要針對預先設定的 Bare Metal Kubernetes 叢集執行指令，請確認您擁有下列資源：

  1. 找出 Kubernetes 叢集名稱，或詢問平台管理員叢集名稱。

  2. 如果沒有 Kubernetes 叢集的 kubeconfig 檔案，請登入並產生該檔案。

  3. 請使用 Kubernetes 叢集的 kubeconfig 路徑，替換這些操作說明中的 CLUSTER_KUBECONFIG。

更新 StatefulSet 資源

如要更新 StatefulSet，請套用新的或更新過的資訊清單檔案。這項功能適用於對 StatefulSet 進行各種變更，例如資源調度或指定應用程式的新版本。

如要更新 StatefulSet 物件，請執行：

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    apply -f STATEFULSET_FILE

更改下列內容：

  • CLUSTER_KUBECONFIG：執行有狀態工作負載的 Kubernetes 叢集 kubeconfig 檔案。

  • NAMESPACE：專案命名空間。

  • STATEFULSET_FILE：更新後的StatefulSet資訊清單檔案名稱。

kubectl apply 指令會將資訊清單檔案套用至資源。如果指定的資源不存在，則這個指令會建立該資源。

檢查 StatefulSet 資源更新發布作業

您可以查看 StatefulSet 物件的更新發布狀態和記錄等詳細資訊。您也可以復原 StatefulSet 物件的推出作業。

檢查推出作業

如要檢查 StatefulSet 資源的發布作業，請執行下列指令：

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    rollout status statefulset STATEFULSET_NAME

  • CLUSTER_KUBECONFIG：執行有狀態工作負載的 Kubernetes 叢集 kubeconfig 檔案。

  • NAMESPACE：專案命名空間。

  • STATEFULSET_NAME：更新後 StatefulSet 物件的名稱。

取得推出記錄

如要查看 StatefulSet 資源的發布記錄，請執行：

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    rollout history statefulset STATEFULSET_NAME

  • CLUSTER_KUBECONFIG：執行有狀態工作負載的 Kubernetes 叢集 kubeconfig 檔案。

  • NAMESPACE：專案命名空間。

  • STATEFULSET_NAME：更新後 StatefulSet 物件的名稱。

復原推出作業

如要復原發布作業，請執行：

kubectl --kubeconfig CLUSTER_KUBECONFIG -n NAMESPACE \
    rollout undo statefulset STATEFULSET_NAME

更改下列內容：

  • CLUSTER_KUBECONFIG：執行有狀態工作負載的 Kubernetes 叢集 kubeconfig 檔案。

  • NAMESPACE：專案命名空間。

  • STATEFULSET_NAME：StatefulSet物件的名稱。