## 背景信息在 Kubernetes 集群中，kube\-apiserver 启动时会自动生成一个自签名证书。在部分较老的 Kubernetes 版本中，该自签证书的有效时间仅为 **一年**。因此，当证书过期后，会导致 kube\-apiserver 不可用。 :::tip 更多详情，请参见 [社区文档](https://github.com/kubernetes/kubernetes/issues/86552)。 ::: 为了解决上述问题，保障您的集群正常工作，火山引擎提供了专用的集群补丁版本，对证书进行重新签发。为了帮助您以最小成本获得最佳体验，我们强烈建议您自助升级至最新的补丁版本。 * 升级完成后，apiserver 自签证书有效期为 **99 ** 年。 * 升级完全向后兼容，不会引入破坏性变更。 * 只需要在火山控制台做简单的操作即可完成。 * 升级过程对运行中的工作负载以及控制面（apiserver、etcd 等）无影响。 * 升级过程中 apiserver 会滚动重启，长连接会有秒级闪断，重试即可解决。 ## 版本说明请根据您集群的当前版本，选择对应的补丁版本进行升级。 |**当前版本** |**补丁版本** | |---|---| |v1.20.15\-vke.xx |v1.20.15\-vke.36 及以上 | |v1.24.xx\-vke.xx |v1.24.17\-vke.17 及以上 | |v1.26.xx\-vke.xx |v1.26.15\-vke.32 及以上 | ## 升级步骤 1. 登录 [容器服务控制台](https://console.volcengine.com/vke)。 2. 单击左侧导航栏中的 **集群**。 3. 在集群列表页面，单击目标集群名称，进入集群控制台页面。 4. 在左侧导航栏中选择 **总览**，在 **概览** 页签中找到 **Kubernetes 版本** 项目，将鼠标悬停在 **可升级** 标签上。 5. 在弹出的对话框内单击 **升级**，即可升级当前集群版本。本文以 v1.26 版本升级为例。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_133566dfca87b9b144f318b03d9adccc.png =909x) 6. 在 **升级目标版本** 中选择 **补丁版本 v1.26.15\-vke.32**，阅读 **升级检查警告** 并勾选确认框后，单击 **确定升级**，系统会对集群发起升级前检查流程。 :::warning * 请注意一定要选择补丁版本！ * 升级补丁版本不会影响正在运行的业务，但为了保障业务运行安全，建议选择业务低峰期升级。 ::: ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_786d2a534fa78f4a777239f75101399e.png =829x) 7. 在集群管理页面的左侧导航栏中，单击 **集群升级**，并选择 **Kubernetes 升级检查** 页签，关注升级前检查是否通过。 * 若升级前检查通过，集群将自动升级。 * 若升级前检查失败，请单击右侧的 **查看详情**，并按照系统提示处理检查失败项。处理完成后重新进行 **控制面升级检查**，保证 **检查状态** 显示 **通过** 后进行升级操作。各个升级检查项的说明和修复建议，请参见 [集群升级检查项](https://www.volcengine.com/docs/6460/1729372)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_eba578b274e6cf9b929840dd80b36ef7.png =831x) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e3bbab8e3e8ee0b9439524bf92b1fd5b.png =833x) :::tip 更多集群升级时的操作和注意事项，请参见 [升级集群](https://www.volcengine.com/docs/6460/475375)。 :::