更新無狀態工作負載

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

本文適用於應用程式營運商群組中的開發人員，他們負責更新組織的應用程式工作負載。詳情請參閱「GDC 實體隔離方案說明文件的目標對象」。

事前準備

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

要求 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：執行 Deployment 的叢集 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：執行 Deployment 的叢集 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

復原更新內容

如要復原更新 (例如部署作業不穩定時)，請使用 kubectl CLI。系統會保留 Deployment 物件的推出記錄，方便您隨時復原。

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

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

更改下列內容：

  • KUBERNETES_CLUSTER_KUBECONFIG：執行 Deployment 的叢集 kubeconfig 檔案。

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

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

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

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

更改下列內容：

  • KUBERNETES_CLUSTER_KUBECONFIG：執行 Deployment 的叢集 kubeconfig 檔案。

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

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

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

後續步驟