使用 ks-installer 升级

对于 Kubernetes 集群不是通过 KubeKey 部署而是由云厂商托管或自行搭建的用户，推荐使用 ks-installer 升级。本教程仅用于升级 KubeSphere。集群运维员应负责提前升级 Kubernetes。

准备工作

• 您需要有一个运行 KubeSphere v3.2.x 的集群。如果您的 KubeSphere 是 v3.1.0 或更早的版本，请先升级至 v3.2.x。
• 请仔细阅读 3.4.0 版本说明。
• 提前备份所有重要的组件。
• KubeSphere 3.4 支持的 Kubernetes 版本：v1.20.x、v1.21.x、* v1.22.x、* v1.23.x、* v1.24.x、* v1.25.x 和 * v1.26.x。带星号的版本可能出现边缘节点部分功能不可用的情况。因此，如需使用边缘节点，推荐安装 v1.21.x。

重要提示

KubeSphere 3.4 对内置角色和自定义角色的授权项做了一些调整。在您升级到 KubeSphere 3.4 时，请注意以下几点：

• 内置角色调整：移除了平台级内置角色 users-manager(用户管理员)和 workspace-manager（企业空间管理员），如果已有用户绑定了 users-manager 或 workspace-manager，他们的角色将会在升级之后变更为 platform-regular。增加了平台级内置角色 platform-self-provisioner。关于平台角色的具体描述，请参见创建用户。

• 自定义角色授权项调整：

  • 移除平台层级自定义角色授权项：用户管理，角色管理，企业空间管理。
  • 移除企业空间层级自定义角色授权项：成员管理，角色管理，用户组管理。
  • 移除命名空间层级自定义角色授权项：成员管理，角色管理。
  • 升级到 KubeSphere 3.4 后，自定义角色会被保留，但是其包含的已被移除的授权项会被删除。

应用 ks-installer

运行以下命令升级集群：

kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.4.0/kubesphere-installer.yaml  --force

启用可插拔组件

您可以在升级后启用 KubeSphere 3.4 的可插拔组件以体验该容器平台的更多功能。