更新無狀態工作負載

本文說明如何更新在 Google Distributed Cloud (GDC) 實體隔離 Kubernetes 叢集中執行的現有無狀態工作負載。隨著應用程式根據資源用量和設定最佳化作業演進，您必須更新 Kubernetes 叢集中的基礎 Pod 規格，以反映這些工作負載變更。

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

事前準備

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

要求 IAM 角色

您必須具備特定角色，才能取得更新無狀態工作負載所需的權限。您需要的角色取決於您是在機構範圍的共用叢集，還是專案範圍的標準叢集中工作。詳情請參閱「Kubernetes 叢集設定」。

共用叢集角色

如要在共用叢集中建立、刪除、編輯或查看工作負載，請要求專案 IAM 管理員授予您「命名空間管理員」 (namespace-admin) 角色。這個角色會繫結至專案命名空間。

標準叢集角色

如要在標準叢集中建立、刪除、編輯或查看工作負載，請要求專案 IAM 管理員授予您「叢集開發人員」 (cluster-developer) 角色。這個角色會繫結至專案命名空間。

準備環境

如要使用 API 對 Kubernetes 叢集執行指令，請確認您具備下列資源：

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

  • 登入並產生 Kubernetes 叢集的 kubeconfig 檔案。

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

更新部署作業

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

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    apply -f DEPLOYMENT_FILE

更改下列內容：

  • KUBERNETES_CLUSTER_KUBECONFIG：執行部署作業的叢集 kubeconfig 檔案。

  • NAMESPACE：命名空間。如果是共用叢集，這必須是專案命名空間。如果是標準叢集，則可以是任何命名空間。

  • DEPLOYMENT_FILE：要更新的 Deployment 資訊清單檔案名稱。

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

您也可以透過其他方式更新部署作業中的資源。

更新容器映像檔

如要變更 Deployment 物件的圖片，請執行：

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    set image deployment DEPLOYMENT_NAME \
    IMAGE=IMAGE:TAG

更改下列內容：

  • KUBERNETES_CLUSTER_KUBECONFIG：執行部署作業的叢集 kubeconfig 檔案。

  • NAMESPACE：命名空間。如果是共用叢集，這必須是專案命名空間。如果是標準叢集，則可以是任何命名空間。

  • DEPLOYMENT_NAME：包含圖片的 Deployment 物件名稱。

  • IMAGE：容器映像檔的名稱。

  • TAG：要更新的容器映像檔標記。

更新 Deployment 的映像檔有助於變更選取器欄位或資源，例如要求或限制。

舉例來說，如要更新名為 nginx 的 Deployment 物件，使其使用版本 1.9.1，請執行下列指令：

kubectl --kubeconfig /tmp/kubeconfig.yaml -n my-namespace \
    set image deployment nginx nginx=nginx:1.9.1

復原更新內容

如要復原更新 (例如 Deployment 變得不穩定時)，請使用 kubectl CLI。系統會保留 Deployment 物件的發布記錄，因此您可以隨時復原。

如要將正在進行或已完成的更新復原到先前修訂版本，請執行下列指令：

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    -n NAMESPACE \
    rollout undo deployment DEPLOYMENT_NAME

更改下列內容：

  • KUBERNETES_CLUSTER_KUBECONFIG：執行部署作業的叢集 kubeconfig 檔案。

  • NAMESPACE：命名空間。如果是共用叢集，這必須是專案命名空間。如果是標準叢集，則可以是任何命名空間。

  • DEPLOYMENT_NAME：要復原的 Deployment 物件名稱。

如要復原到特定修訂版本，請執行：

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    -n NAMESPACE \
    rollout undo deployment DEPLOYMENT_NAME \
    --to-revision=REVISION_NUMBER

更改下列內容：

  • KUBERNETES_CLUSTER_KUBECONFIG：執行部署作業的叢集 kubeconfig 檔案。

  • NAMESPACE：命名空間。如果是共用叢集，這必須是專案命名空間。如果是標準叢集，則可以是任何命名空間。

  • DEPLOYMENT_NAME：要復原的 Deployment 物件名稱。

  • REVISION_NUMBER：定義要復原的修訂版本 (整數)，例如 3。

後續步驟