更新有状态工作负载

本文档介绍了如何更新在 Google Distributed Cloud (GDC) 空气隔离 Kubernetes 集群中运行的现有有状态工作负载。随着应用根据资源使用情况和配置优化不断发展,您必须更新 Kubernetes 集群中的底层 Pod 规范,以反映这些工作负载变化。如需详细了解如何规划有状态工作负载的更新,请参阅 Kubernetes 文档中的更新策略

本文档适用于应用运维人员群组中的开发者,他们负责为其组织更新应用工作负载。如需了解详情,请参阅 GDC 气隙环境文档的受众群体

准备工作

如需完成本文档中的任务,您必须请求必要的权限并准备好环境。

申请 IAM 角色

您必须拥有特定角色才能获得更新有状态工作负载所需的权限。您需要的角色取决于您是在组织范围的共享集群中工作,还是在项目范围的标准集群中工作。如需了解详情,请参阅 Kubernetes 集群配置

共享集群角色

如需在共享集群中创建、删除、修改或查看工作负载,请让项目 IAM 管理员为您授予 Namespace Admin (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_NAMEStatefulSet 对象的名称。

后续步骤