容器服务
容器服务
文档指南
请输入
- 文档首页
容器服务容器服务 VKE用户指南集群升级集群集群升级操作
复制全文
下载 pdf集群升级操作
文档反馈
问问助手容器服务（VKE）支持升级集群版本。本文主要介绍升级集群 Kubernetes 版本的相关说明及操作。
升级流程
升级须知
升级集群包括 控制面升级 和 节点升级，每部分中均包括 升级检查 和 升级执行 两个阶段。触发升级前，请仔细阅读本文描述的 升级策略、控制面升级注意事项、节点升级注意事项 内容。
升级策略
容器服务保障最近三个 Kubernetes 次要版本的稳定运行，过期版本的集群可能存在运行不稳定、升级失败等风险，但不影响已有业务的使用，建议您及时升级集群版本。更多内容请参见：
控制面升级注意事项
- Kubernetes 次要版本升级可能涉及到 Kubernetes 资源版本变更。升级前请确认您的应用是否使用了已废弃资源。如果您在应用的 Chart 中使用了已废弃资源，则需要更新应用 Chart 中的资源到新版本，再将新的 Chart 更新到集群中。详细的资源变更与弃用说明，请参见 Kubernetes 版本发布记录。
- 集群控制面（Master）升级 Kubernetes 版本过程中，集群上的应用不会中断。如果应用强依赖于 API Server 可能会有短暂影响。
- 集群控制面升级需要花费 5～10 分钟，在此期间您将无法操作您的集群。
- 升级集群控制面流程中，系统会自动执行升级前置检查。因此升级前，建议独立执行升级前置检查，并确保所有检查项已通过，可顺利进行升级操作。
- 升级前置检查，仅对当前正在运行的资源进行废弃 API 检查。
- 集群控制面升级不支持回滚，请谨慎进行。
- 如果集群中使用了自定义操作系统镜像，由于该类型镜像非容器服务官方严格验证，因此我们将无法保证集群能够升级成功。
- 仅当节点 Kubernetes 版本与控制面 Kubernetes 版本一致时，控制面才可继续升级到下一个可升级版本。
- 同一集群连续升级 Kubernetes 次要版本时，建议版本升级间隔时间大于 24 小时，确保集群的稳定运行。例如当集群控制面从 Kubernetes v1.20 升级至 v1.24，并稳定运行 24 小时后，再将该集群升级至 v1.26 版本。
- 升级 Kubernetes 次要版本后可能存在参数不兼容的情况，因此次要版本升级不会保留您集群维度自定义 Kubelet 等参数，需要升级后重新设置以保证新增节点使用期望的自定义配置。相关操作说明，请参见 自定义集群 Kubelet 参数。
- VPC-CNI 网络模型的集群控制面从 Kubernetes v1.20 升级至 v1.24 版本时，需要手动获取 EndpointSlices 资源。详细操作和说明，请参见本文下方 附录。
- Kubernetes 社区在 v1.29 之后的版本中， 更新了 kube-proxy 的conntrack_max参数值配置方式，将基于 kube-proxy 的配置和节点的 CPU Core 数量来计算和更新conntrack_max参数值，详情请参见 #120448。在 Kubernetes v1.28（含）之前版本的 VKE 集群中，kube-proxy 不会覆盖集群管理员手动设定的conntrack_max参数值。将集群升级至 v1.30 后，kube-proxy 可能会基于其新逻辑自动调低conntrack_max参数值。因此请在升级集群前将conntrack_max等配置设置到 kube-proxy 的 ConfigMap 中，以避免被覆盖。具体操作，请参见 FAQ。
节点升级注意事项
- 节点 Kubernetes 升级会影响正在运行的业务，升级过程中可能造成 Pod Prober、Lifecycle Hook 失败，也可能会出现 Pod 原地重启情况。因此在升级前，应检查集群状态是否健康、是否处于业务低峰期，从而判断是否开始进行节点升级。
- 升级节点 Kubernetes 版本流程中，系统会自动执行升级前置检查。因此升级前，建议独立执行升级前置检查，并确保所有检查项已通过，可顺利进行升级操作。
- 节点 Kubernetes 升级不支持回滚，请谨慎进行。
- 如果您在节点上修改过 kubelet、containerd 参数配置，则在升级节点过程中仅保留兼容参数，会移除不兼容参数，在升级节点完成后，需要您再次检查。
- 将节点升级至 v1.28 及以上版本时，系统会将 kubelet 参数的默认值更新到最新。详情请参见 配置节点池 Kubelet 参数。
- 节点要升级的目标 Kubernetes 版本不能超过当前控制面 Kubernetes 版本。
前提条件
- 目标集群的 Kubernetes 版本，显示 可升级，即不是最新的容器服务发布 Kubernetes 版本。详细信息，请参见 Kubernetes 版本发布记录。
-
- 目标集群的 状态 必须为 运行中。
- 请确保目标集群业务处于低峰期。
控制面升级
步骤一：升级检查
进行控制面升级前，请先进行升级检查，确保前置解决所有可能影响集群升级的问题。
- 登录容器服务控制台。
- 在左侧导航栏中，选择 集群，单击目标集群名称，进入集群管理页面。
- 在左侧导航栏中，选择 集群升级，进入集群升级页面。
- 选择 Kubernetes 升级检查 页签，单击 控制面升级检查，并选择升级的目标版本。单击 确定，进行控制面升级前置检查。
-
- 检查完成后，按照 检查状态 列下的显示，进行下一步操作：
- 通过：可进行升级操作。
- 失败：单击右侧的 查看详情，并按照系统提示处理检查失败项。处理完成后重新进行 控制面升级检查，保证 检查状态 显示 通过 后进行升级操作。各个升级检查项的说明和修复建议，请参见 集群升级检查项。
说明
- 升级集群时，系统会分析集群审计日志以评估升级风险。若您已确认并处理相关告警，在执行升级时可忽略告警。具体检查项名称如下：
- 【重要】审计日志移除 k8s API 检查
- 【重要】VPC-CNI 兼容性检查
- 审计日志废弃 k8s API 检查
- Kubernetes v1.36 及以上版本集群不再支持 containerd 1.x 版本节点和节点配置，升级控制面版本前须先升级节点容器运行时版本，并更新相关节点池的容器运行时配置。操作详情请参见 管理节点池。
- Kubernetes v1.36 及以上版本集群不再支持 cgroup v1 版本节点，升级控制面版本前须先滚动升级节点到 cgroup v2 版本。操作详情请参见 升级节点。
步骤二：升级控制面
- 在集群升级页面中，选择 Kubernetes 升级 页签，单击 控制面升级。
- 在弹出的 控制面 Kubernetes 升级 对话框中，确认升级信息。
- 参数说明图例升级须知请仔细阅读并确认每条 升级须知。
升级目标版本选择可升级的目标版本：- 补丁版本：显示在当前 Kubernetes 次要版本（例如 v1.24）基础上可升级的 VKE 补丁版本。
- 次要版本：显示可升级的 Kubernetes 次要版本，例如 v1.24 可升级至 v1.26。
升级检查告警升级过程中，系统会再次自动进行升级前置检查，确保您的集群可以顺利进行 Kubernetes 升级。若您的前置检查项中存在 检查结果 为 警告 的检测项时，在您评估确认不影响业务情况下，可勾选 升级检查告警 忽略告警项，直接执行 Kubernetes 升级操作。
- 单击 确定升级，开始进行控制面升级。
- 升级过程中，可单击右侧 操作 列下的 查看详情，查看控制面 Kubernetes 升级进度。
-
- 查看升级结果。状态 显示为 通过，表示已完成控制面升级。
-
- （可选）若升级失败，请按照界面提示重新操作。若有更多问题，可提交 工单申请 获取技术支持。
节点升级
注意
- 控制面 Kubernetes 版本与节点 Kubernetes 版本一致时，需要先完成控制面升级操作后，才可进行节点的升级操作。升级前置检查无约束，均可以进行。
- 控制面 Kubernetes 版本比节点 Kubernetes 版本高时，节点可升级至与控制面 Kubernetes 版本相同的版本。
步骤一：升级检查
- 登录容器服务控制台。
- 在左侧导航栏中，选择 集群，单击目标集群名称，进入集群管理页面。
- 在左侧导航栏中，选择 集群升级，进入集群升级页面。
- 选择 Kubernetes 升级检查 页签，单击 节点升级检查，并在弹出的配置页面中配置升级参数。
-
- 参数描述基本信息升级方式节点的升级方式。支持如下两种升级方式：
- 原地升级：在原节点上更新替换所需的组件。原地升级不会重装操作系统，也不会重新初始化节点，原节点的数据不受影响。
- 重装升级：节点重装操作系统，重新初始化节点，清空系统盘和容器盘数据（/var/lib/containerd和/var/lib/kubelet目录）。
升级内容配置节点的 Kubernetes 版本和容器运行时升级内容：- Kubernetes 版本：选择要升级的目标 Kubernetes 版本（补丁版本或次要版本）。版本说明，请参见 Kubernetes 版本发布记录。
- 容器运行时：选择容器运行时版本。
说明节点升级维度节点升级维度选择升级检查节点池/节点选择升级检查节点池/节点- 节点升级维度 为 节点 时：支持选择集群下的 全部节点 或者 部分节点 进行节点升级检查。
- 节点升级维度 为 节点池 时：支持选择集群下某一个节点池，对该节点池内的全部节点进行节点升级检查。
升级配置操作系统升级方式 选择 重装升级 后显示该参数。选择节点使用的系统镜像：- 公共镜像：火山引擎官方提供的正版版权镜像，包含基础操作系统和火山引擎提供的初始化组件，安全稳定性高且所有用户均可使用。
- VKE 支持的公共镜像及其关联的规格族参见：容器服务支持的公共镜像。
- 自定义镜像：用户自行制作并上传的镜像，除操作系统外，还可以预装公共应用或私有应用，具有更高的定制化性，适用于需要重新部署复杂初始化系统或多次部署同样配置的场景。
- VKE 支持使用自定义镜像作为节点操作系统，更多详细介绍参见：操作系统镜像概述。
- 共享镜像：其他火山引擎账户共享的镜像，可使用共享镜像快速部署与其他用户已创建节点相同的软件环境，也可以将自己创建或上传的自定义镜像共享给其他火山引擎账户使用。
注意- 自定义镜像和共享镜像仅支持基于 VKE 基础镜像制作的镜像，请根据需求确认是否需要 GPU 版本。
- 自定义镜像会根据节点池项目进行数据过滤。
- 单击 确定，开始进行升级检查。
- 检查完成后，按照 检查状态 列下的显示，进行下一步操作：
- 通过：可进行升级操作。
- 失败 或 警告：单击右侧的 查看详情，并按照系统提示处理检查失败项。处理完成后重新进行 节点升级检查，保证 检查状态 显示 通过 后进行升级操作。各个升级检查项的说明和修复建议，请参见 集群升级检查项。
说明
若您评估确认升级前置检查项中 检查结果 为 警告 的检测项不影响您的业务，也可忽略该项，直接执行 Kubernetes 升级操作。
步骤二：升级节点
- 在集群升级页面，选择 Kubernetes 升级 页签，单击 节点升级。
- 在系统弹出的提示框中仔细阅读每条 升级须知，确认升级注意事项后单击 确定升级。
- 在 节点升级 页面，配置升级信息。
- 参数说明图例基本信息
升级方式节点的升级方式。支持如下两种升级方式：- 原地升级：在原节点上更新替换所需的组件。原地升级不会重装操作系统，也不会重新初始化节点，原节点的数据不受影响。
- 重装升级：节点重装操作系统，重新初始化节点，清空系统盘和容器盘数据（/var/lib/containerd和/var/lib/kubelet目录）。
说明Kubernetes v1.36 及以上版本不再支持 cgroup v1 节点。如果集群中存在 cgroup v1 节点，请选择 重装升级，以完成节点 cgroup v1 到 cgroup v2 的迁移。升级内容配置节点的 Kubernetes 版本和容器运行时升级内容：- Kubernetes 版本：可升级的 Kubernetes 版本（补丁版本或次要版本）。版本说明，请参见 Kubernetes 版本发布记录。
- 容器运行时：可升级的容器运行时及其版本。
说明节点升级维度节点升级维度选择升级节点池/节点选择升级节点池/节点- 节点升级维度 为 节点 时：支持选择集群下的 全部节点 或者 部分节点 进行节点升级检查。
- 节点升级维度 为 节点池 时：支持选择集群下某一个节点池，对该节点池内的全部节点进行节点升级检查。
升级配置操作系统升级方式 选择 重装升级 后显示该参数。选择节点使用的系统镜像：- 公共镜像：火山引擎官方提供的正版版权镜像，包含基础操作系统和火山引擎提供的初始化组件，安全稳定性高且所有用户均可使用。
- VKE 支持的公共镜像及其关联的规格族参见：容器服务支持的公共镜像。
- 自定义镜像：用户自行制作并上传的镜像，除操作系统外，还可以预装公共应用或私有应用，具有更高的定制化性，适用于需要重新部署复杂初始化系统或多次部署同样配置的场景。
- VKE 支持使用自定义镜像作为节点操作系统，更多详细介绍参见：操作系统镜像概述。
- 共享镜像：其他火山引擎账户共享的镜像，可使用共享镜像快速部署与其他用户已创建节点相同的软件环境，也可以将自己创建或上传的自定义镜像共享给其他火山引擎账户使用。
注意- 自定义镜像和共享镜像仅支持基于 VKE 基础镜像制作的镜像，请根据需求确认是否需要 GPU 版本。
- 自定义镜像会根据节点池项目进行数据过滤。
最大并发数节点池升级时最大并发更新的节点数。最大失败数允许失败的最大节点数。当失败节点百分比不超过该设置时，继续升级，超过该值时停止升级。自动暂停策略节点按 最大并发数 分批次升级过程中，每批次之间的自动暂停策略：- 不暂停：升级连续进行，不设置人工卡点，不同批次之间是否需要时间间隔，由 每批次间隔时间 配置项确定。适用于测试环境、已充分验证过升级流程、追求升级效率等场景。
- 首批暂停：第一批节点升级完成后自动暂停，需人工确认后， 才推进后续批次。
- 每批次暂停：每批节点升级完成后均自动暂停，需人工确认后，才推进下一批次。
每批次间隔时间当 自动暂停策略 选择 不暂停 时显示该参数，表示连续升级时，不同升级批次之间的暂停时间间隔。- 不设置：不设置间隔时间，升级连续进行，一批接一批，直到所有节点升级完成，中途不自动暂停。
- 设置间隔时间：配置每批升级之间的时间间隔，一批升级完成后，系统会自动暂停该时间，然后进行下一批。
升级检查告警升级检查告警升级过程中，系统会再次自动进行升级前置检查，确保您的集群可以顺利进行 Kubernetes 升级。若您的前置检查项中存在 检查结果 为 警告 的检测项时，在您评估确认不影响业务情况下，可勾选 我已悉知升级前置检查结果 忽略告警项，直接执行 Kubernetes 升级操作。
- 单击 确定，开始进行节点升级。
- 升级过程中，可单击右侧 操作 列下的 查看详情，查看并管理节点 Kubernetes 升级进度。
-
- 查看升级结果。状态 显示为 通过，表示已完成 Kubernetes 升级。
-
- （可选）若升级失败，请按照界面提示重新操作。若有更多问题，可提交 工单申请 获取技术支持。
升级后检查
升级完成后，请在集群的 总览 页面核验集群 Kubernetes 版本、节点 Kubernetes 版本、集群运行状态，同时检查您集群内的其他业务是否正常。若业务异常，请查看相关事件和日志信息以进一步处理。您也可以提交 工单申请 获取技术支持。
附录
VPC-CNI 网络模型集群中，当集群控制面从 Kubernetes v1.20 升级至 v1.24 后，需要重启属于 vpc-cni 组件的 Cello DaemonSet，以获取新版本 EndpointSlices 资源。详细操作如下：
- 通过 kubectl 连接已升级的集群。详细操作，请参见 连接集群。
- 执行如下命令，重启从属于 vpc-cni 组件的 Cello DaemonSet。
-
最近更新时间：2026.11.02 21:16:07
这个页面对您有帮助吗？
有用
有用
无用
无用