本文說明如何更新在 Google Distributed Cloud (GDC) 氣隙 Kubernetes 叢集中執行的現有有狀態工作負載。隨著應用程式根據資源用量和設定最佳化作業演進，您必須更新 Kubernetes 叢集中的基礎 Pod 規格，才能反映這些工作負載變更。如要進一步瞭解如何規劃有狀態工作負載的更新，請參閱 Kubernetes 說明文件中的更新策略。
本文適用於應用程式運算子群組中的開發人員，負責為所屬機構更新應用程式工作負載。詳情請參閱 GDC air-gapped 說明文件適用對象。
事前準備
如要完成本文中的工作，您必須要求必要的權限並準備環境。
要求 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物件的名稱。