升级集群Kubernetes版本
更新时间：2026-04-09
概述
本文档介绍如何在容器引擎 CCE 控制台升级集群的 Kubernetes 版本。升级过程包含升级前置检查、升级 Master 以及升级 Worker，集群会展示待升级节点数。
升级须知
注意： 升级属于不可逆操作，请谨慎操作。
- 仅支持向上升级 Kubernetes 版本，不支持连续跨大版本升级（如 1.16 跳过 1.18 直接升级到 1.20），且当集群内 Worker 版本和 Master 大版本一致时，才可以升级到下一版本。
- 升级前强烈建议您先仔细阅读 CCE Kubernetes版本更新说明 了解待升级版本的版本解读、废弃 API 等信息，避免因高版本的功能变更导致业务功能不兼容。
- 升级完成 Master 后，请尽快完成全部 Worker 版本升级，且升级过程中不建议对集群进行任何操作。
- 升级过程中，可能会有升级失败的情况。为了您的数据安全，强烈建议您先打快照再升级。
- 升级过程中，集群上的应用不会中断。如果应用强依赖 API Server，可能会有短暂影响。
前提条件
- 已登录容器引擎 CCE 控制台，并具备目标集群的管理权限。
- 当前账号下已存在待升级的标准独立集群或托管集群。
- 目标集群当前版本满足向上升级条件。
操作步骤
升级 Master Kubernetes 版本
-
导航路径如下：
容器引擎 CCE -> 集群列表 -> 更多 -> 升级 Master Kubernetes 版本
-
在升级页面完成以下配置。
配置项 参数 必选/可选 必填 配置说明 说明 升级须知 升级须知 必选 是 升级前强烈建议您仔细阅读升级须知并勾选后再进行升级。 勾选升级须知后，才可继续后续操作。 Master 配置 Master 配置 必选 是 请输入 Master 节点对应的 root密码，托管集群不需要输入。标准独立集群需要输入对应的 root密码；托管集群无需输入。可升级版本 可升级版本 必选 是 默认显示当前支持升级的大、小版本。 仅支持升级到当前可选范围内的版本。 - 点击 【下一步】 后，进入前置检查页面。只有检查项全部通过后，才可以继续升级。
- 点击 【升级】 后，开始升级 Master Kubernetes 版本。
- 在集群列表中查看目标集群状态，点击 【查看进度】 查看升级进度。
-
如有需要，可执行 【暂停升级】 或 【取消升级】 操作。通常情况下不建议暂停或取消。
说明：
- 暂停升级： 您可以在集群升级任意阶段对升级任务进行暂停操作。暂停升级后，当前正在执行的任务会继续执行直至完成，还未执行的任务不会再执行。
- 取消升级： 您可以在暂停升级之后取消本次升级。取消升级后，当前正在执行的任务会继续执行直至完成，还未执行的任务不会再执行。
升级 Worker Kubernetes 版本
-
导航路径如下：
容器引擎 CCE -> 集群列表 -> 更多 -> 升级 Worker Kubernetes 版本
-
在升级页面完成以下配置。
配置项 参数 必选/可选 必填 配置说明 说明 升级须知 升级须知 必选 是 升级前强烈建议您仔细阅读升级须知并勾选后再进行升级。 勾选升级须知后，才可继续后续操作。 选择节点 选择节点 必选 是 选择将要升级的节点，支持分批多次升级。 可根据业务情况分批升级节点。 可升级版本 可升级版本 必选 是 默认显示当前支持升级的大、小版本。 仅支持升级到当前可选范围内的版本。 升级方式 升级方式 必选 是 当前仅支持原地滚动升级，无需重装操作系统，直接升级节点。 升级方式固定为原地滚动升级。 节点驱逐 节点驱逐 必选 是 默认开启，开启后升级前会将节点上的 Pod 全部驱逐，建议开启。 建议保持开启，以降低升级过程中的业务影响。 升级并发数 升级并发数 必选 是 输入范围为 1～20，升级时会根据并发数同时升级多个节点。 可根据业务可承受范围调整升级速度。 Pod 不可用占比 Pod 不可用占比 必选 是 升级过程中，Pod 不可用数与集群总数占比超过设置数值时，将自动暂停升级任务，默认为 20%。 建议根据业务可用性要求合理设置。 - 点击 【升级】 后，开始升级 Worker Kubernetes 版本。
- 在集群列表中查看目标集群状态，点击 【查看进度】 查看升级进度。
-
如有需要，可执行 【暂停升级】 或 【取消升级】 操作。通常情况下不建议暂停或取消。
说明：
- 暂停升级： 您可以在集群升级任意阶段对升级任务进行暂停操作。暂停升级后，当前正在执行的任务会继续执行直至完成，还未执行的任务不会再执行。
- 取消升级： 您可以在暂停升级之后取消本次升级。取消升级后，当前正在执行的任务会继续执行直至完成，还未执行的任务不会再执行。
评价此篇文章