本页面介绍了如何更新在 Google Distributed Cloud (GDC) 气隙 Kubernetes 集群中运行的现有有状态工作负载。随着应用根据资源使用情况和配置优化不断发展,您必须更新 Kubernetes 集群中的底层 Pod 规范,以反映这些工作负载变化。如需详细了解如何规划有状态工作负载的更新,请参阅 Kubernetes 文档中的更新策略。
本页面适用于应用运维人员群组中的开发者,他们负责为其组织更新应用工作负载。如需了解详情,请参阅 GDC 气隙环境文档的受众群体。
准备工作
如需针对 Kubernetes 集群运行命令,请确保您拥有以下资源:
找到 Kubernetes 集群名称,或向平台管理员询问集群名称。
登录并生成 Kubernetes 集群的 kubeconfig 文件(如果您还没有)。
使用 Kubernetes 集群的 kubeconfig 路径替换这些说明中的
KUBERNETES_CLUSTER_KUBECONFIG
。
如需获得更新有状态工作负载所需的权限,请让您的组织 IAM 管理员为您授予项目命名空间中的命名空间管理员角色 (namespace-admin
)。
更新 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
对象的名称。