集群升级

集群升级路径

CCE 集群基于社区Kubernetes版本迭代演进，版本号由社区Kubernetes版本和CCE补丁版本两部分构成，因此提供两类集群升级路径。

• Kubernetes版本升级：

  Kubernetes版本号	支持升级到的Kubernetes版本号
  v1.13及以下	不支持
  v1.15	v1.19
  v1.17	v1.19
  v1.19	v1.21、v1.23
  v1.21	v1.23
  v1.23	v1.25、v1.27、v1.28
  v1.25	v1.27、v1.28
  v1.27	v1.28
  v1.28	v1.29、v1.31
  v1.29	v1.30、v1.31
  v1.30	v1.31
  v1.31	v1.32、v1.34
  v1.32	v1.33、v1.34
  v1.33	v1.34
  v1.34	v1.35

  

  • 当前Kubernetes版本的维护情况请参见CCE集群版本生命周期表。
  • 已停止维护的版本无法一步直接升级到最新版本，需要进行连续多次升级，例如v1.15 -> v1.19 -> v1.23 -> v1.27/v1.28。
  • 补丁版本需要升级至最新补丁后方可进行Kubernetes版本升级，控制台将根据当前集群版本自动为您生成最佳升级路径。
• 补丁版本升级

  1.19及以上版本的CCE集群采取了补丁版本管理策略，旨在不进行大版本升级的情况下，为在维集群提供新的特性、Bugfix和漏洞修复。

  新的补丁版本发布以后您可在任意补丁版本一次直升到最新补丁版本，补丁版本发布记录请参见CCE补丁版本发布记录。

集群升级流程

集群升级流程包括升级前检查、备份、升级和升级后验证几个步骤，下面介绍集群升级过程中的相关流程。

图1 集群升级流程

在确定集群的目标版本后，请您仔细阅读升级注意事项，避免升级时出现功能不兼容的问题。

1. 升级前检查

   升级集群前，CCE会对您的集群进行必要的检查，包括集群状态、插件状态、节点状态、工作负载兼容性等多方面进行检查，确保集群满足升级的条件，检查项目请参考升级前检查项。如果出现检查异常项，请参考控制台中的提示进行修复。

2. 备份

   通过硬盘快照的方式帮您备份集群控制节点，以保存CCE组件镜像、组件配置、Etcd数据等关键数据。建议您在升级前进行备份。如果在升级过程中出现不可预期的情况，可以基于备份为您快速恢复集群。

   备份方式	备份对象	备份方式	备份时间	回滚时间	说明
   etcd数据备份	etcd数据	升级流程中自动备份	1-5min	2h	必选备份，升级过程中自动进行，用户无需关注
   CBR整机备份	控制节点磁盘，包括组件镜像、配置、日志以及etcd数据	通过页面一键备份（手动触发）	20min-2h（受当前区域云备份任务排队情况影响）	20min	该功能逐步由EVS快照备份替代
   EVS快照备份	控制节点磁盘，包括组件镜像、配置、日志以及etcd数据	通过页面一键备份（手动触发）	1-5min	20min	该功能上线中 对于已上线的区域，EVS快照备份将替代CBR整机备份

3. 配置与升级

   执行升级前，需要对升级参数进行配置，我们已为您提供了默认配置，您也可以根据需要进行配置，升级参数配置完成后，将进入正式升级流程，对插件、控制节点、用户节点依次进行升级。

   

   在升级控制节点之前，系统会自动保存节点池的弹性伸缩配置并关闭弹性伸缩功能。待控制节点升级完成后，系统将自动恢复节点池的弹性伸缩功能。因此，在升级控制节点过程中无法弹性伸缩节点，升级完控制节点之后即可恢复节点弹性扩容能力，但节点缩容能力需要在整个升级流程结束后恢复。

   • 插件升级配置：此处列出了您的集群中已安装的插件。在集群升级过程中系统会自动升级已选择的插件，以兼容升级后的集群版本，您可以单击插件右侧的“配置”重新定义插件参数。
     

     插件右侧如有标记，表示当前插件不能同时兼容集群升级起始和目标版本，在集群版本升级完成后将为您升级该插件 ，该插件在集群升级过程中可能无法正常使用。

   • 节点升级配置
     • 每批最大升级节点数：您可以设置每批升级的最大节点数量。

       升级时节点会依次进行分批升级。例如，第一批升级1个节点，第二批升级4个节点，后续每批升级节点数以4的幂数增加，直到达到您设置的每批最大升级节点数。默认每批最大升级节点数为20，最高可配置为120。

     • 节点优先级配置：您可以自行定义节点升级的优先级顺序。如不设置该优先级，系统将根据默认策略生成优先级顺序执行升级。
       • 添加节点池优先级：自定义节点池升级的优先级顺序。如不设置，默认策略为节点数量少的节点池优先升级。
       • 添加节点优先级：自定义节点池内节点升级的优先级顺序。如不设置，默认策略为负载较轻（根据节点Pod数量、节点资源请求率、节点PV数量等维度计算负载情况）的节点优先升级。
     • 节点升级批次应用范围：节点升级批次配置可应用于整个集群范围或节点池范围，您可以自定义选择，默认为集群。
       • 节点升级批次配置应用到整个集群：表示升级过程中集群内的所有节点分批次进行升级，不区分节点池。例如，第一批升级1个节点，第二批升级4个节点，后续每批升级节点数以4的幂数增加，直到达到您设置的每批最大升级节点数。
       • 节点升级批次配置应用范围为节点池：表示每个节点池内的节点将独立按上述规则分批次升级，即每个节点池的第一批升级1个节点，第二批升级4个节点，后续每批升级节点数同样以4的幂次递增，直至达到每批最大升级节点数。升级下一个节点池时，从1开始重新计算每批的升级节点数。
   • 集群证书配置
     • 更新CCE集群证书：您可以根据当前集群证书的有效期，选择是否在集群升级过程中同步更新CCE集群证书，更新后证书有效期为5年。
       

       当集群“概览 > 连接信息”中开启了“OpenID Connect 提供商”功能时，若曾获取过CCE集群签名公钥，您需要在集群升级完成后重新获取，否则会导致OIDC身份认证失效。

     • 更新自有证书：若您在创建集群时指定了自有证书，则可选择是否更新自有证书。您可以根据提示上传CA根证书、客户端证书、客户端证书私钥，完成证书的自动更新。
4. 升级后验证

   升级完成后，会自动为集群执行集群状态检查、节点状态检查等，您需要手动进行业务验证、新建节点验证、新建Pod验证等，确保升级后集群功能正常。详情请参见升级后验证。

升级方式

相关文档

• 关于节点OS升级的内容，请参考升级操作系统。
• 集群升级过程中，如果插件升级失败，请参考CCE集群升级时，升级集群插件失败如何排查解决进行解决。
• 集群升级过程中，如果ELB Ingress与ELB配置不一致，请参考ELB Ingress与ELB配置不一致如何处理进行解决。