升级集群Kubernetes版本
更新时间:2026-11-17
概述
本文档介绍如何在容器引擎 CCE 升级集群的 Kubernetes 版本。升级过程包含升级前置检查、升级集群控制面以及通过节点池升级节点。
升级须知
注意: 升级属于不可逆操作,请谨慎操作。
- 仅支持向上升级 Kubernetes 版本,不支持连续跨大版本升级(如 1.16 跳过 1.18 直接升级到 1.20),且当集群内节点 Kubernetes 版本和集群控制面次要版本一致时,才可以升级到下一版本。
- 升级前强烈建议您先仔细阅读 CCE Kubernetes版本更新说明 了解待升级版本的版本解读、废弃 API 等信息,避免因高版本的功能变更导致业务功能不兼容。
- 升级完成集群控制面后,请尽快完成全部节点升级,且升级过程中不建议对集群进行任何操作,具体请见升级节点组。
- 升级过程中,可能会有升级失败的情况。为了您的数据安全,强烈建议您先打快照再升级。
- 升级过程中,集群上的应用不会中断。如果应用强依赖 API Server,可能会有短暂影响。
使用说明
- 集群升级功能目前为白名单开放,若需升级集群请提工单。
- 集群升级不支持升级游离节点,如果您的集群中存在游离节点,即未被节点组管理的Worker节点,可以参考添加外部已有节点将游离节点加入节点组中进行升级。
前提条件
- 已登录容器引擎 CCE 控制台,并具备目标集群的管理权限。
- 当前账号下已存在待升级的标准独立集群或托管集群。
- 目标集群当前版本满足向上升级条件。
操作步骤
升级集群控制面
- 登录容器引擎控制台。
- 在左侧导航栏,选择集群列表。
- 在“集群列表”页面单击目标集群,进入集群管理页面。
- 在集群管理页面左侧导航栏中选择运维与管理 > 集群升级。
- 在集群升级页面根据页面提示是否存在可升级的集群版本。
- 若存在可升级的集群版本确认后单击【立即升级】进行集群升级。

- 在集群升级说明弹框中勾选【我已阅读并同意升级集群】进入控制面升级页面。

- 在升级配置页面再次确认升级对象,若升级独立集群,则需要配置集群 Master 节点的 root 密码,请确认密码输入正确,否则会导致集群升级失败,单击【下一步】进入集群升级前置检查环节。

- 控制面升级依赖前置检查结果,请根据实际的检查结果进行处理。只有检查通过(检查结果中无异常项)才能进行控制面升级,若存在异常项请根据修复建议修复后重新检查通过后再执行。
- 若检查通过单击【下一步】进入集群控制面升级环节,直至集群控制面任务全部执行完成。

注意:
- 控制面升级不支持取消升级和暂停升级,请合理安排升级时间。
升级节点组
控制面升级完成后,请尽快在业务低峰期完成节点组升级,包括节点 kubelet 和容器运行时升级。
产品上提供两个操作入口,您可以通过节点组上的【升级】操作来升级节点,也可以直接【集群升级】功能模块进行升级,两个操作提供相同的升级能力,具体可见升级节点组,本文介绍通过【集群升级】功能模块进行升级。
- 登录容器引擎控制台。
- 在左侧导航栏,选择集群列表。
- 在“集群列表”页面单击目标集群,进入集群管理页面。
- 在集群管理页面左侧导航栏中选择运维与管理 > 集群升级。
- 在集群升级页面根据页面提示是否存在可升级的节点池。

- 选择目标节点组单击【升级】操作系统弹出节点组升级弹框,按照弹框中的内容完成升级配置,具体见升级节点组。
- 完成配置后单击【前置检查】,在前置检查全部通过后开始节点升级。
-
在升级过程中,您可以进行如下操作。
- 暂停:暂停升级。单击【暂停】,暂停升级后,升级中的节点将继续升级直至完成,已完成升级的节点不支持版本回退。
- 继续:继续升级。单击【继续】,节点组将继续执行剩余节点的升级。
- 取消:取消升级。单击【取消】,节点组将取消后续节点的升级,升级中的节点将继续升级直至完成。已完成升级的节点的不支持版本回退。
升级后验证
节点组全部完成升级后,建议检查如下内容:
- 对节点升级成功,且在节点详情页面查看 kubelet 和 containerd 版本时已更新至新版本。
- 对 Pod 调度正常。
- 对业务应用运行正常。
评价此篇文章
