使用 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-managerworkspace-manager,他们的角色将会在升级之后变更为 platform-regular。增加了平台级内置角色 platform-self-provisioner。关于平台角色的具体描述,请参见创建用户

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

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

应用 ks-installer

运行以下命令升级集群:

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

启用可插拔组件

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