使用 KubeKey 升级

对于 Kube AI Hub 和 Kubernetes 都由 KubeKey 部署的用户，推荐使用 KubeKey 升级。如果您的 Kubernetes 集群由云厂商托管或自行配置，请参考使用 ks-installer 升级。

本教程演示如何使用 KubeKey 升级集群。

准备工作

• 您需要有一个运行 Kube AI Hub v3.3.x 的集群。如果您的 Kube AI Hub 是 v3.2.x 或更早的版本，请先升级至 v3.3.x。
• 请仔细阅读 3.4.1 版本说明。
• 提前备份所有重要的组件。
• 确定您的升级方案。本文档中提供 All-in-One 集群和多节点集群的两种升级场景。

重要提示

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

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

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

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

下载 KubeKey

升级集群前执行以下命令下载 KubeKey。

curl -sfL https://get-kk.kubesphere.io | VERSION=v3.0.13 sh -

export KKZONE=cn

curl -sfL https://get-kk.kubesphere.io | VERSION=v3.0.13 sh -

为 kk 添加可执行权限：

chmod +x kk

升级 Kube AI Hub 和 Kubernetes

单节点集群 (All-in-One) 和多节点集群的升级步骤不同。

All-in-One 集群

运行以下命令使用 KubeKey 将您的单节点集群升级至 Kube AI Hub 3.4 和 Kubernetes v1.22.12：

./kk upgrade --with-kubernetes v1.22.12 --with-kubesphere v3.4.1

要将 Kubernetes 升级至特定版本，请在 --with-kubernetes 标志后明确指定版本号。以下是可用版本：v1.20.x、v1.21.x、v1.22.x、v1.23.x、* v1.24.x、* v1.25.x 和 * v1.26.x。带星号的版本可能出现边缘节点部分功能不可用的情况。因此，如需使用边缘节点，推荐安装 v1.23.x。

多节点集群

步骤 1：使用 KubeKey 生成配置文件

运行以下命令会基于您的集群创建一个 sample.yaml 配置文件。

./kk create config --from-cluster

步骤 2：修改配置文件模板

根据您的集群配置修改 sample.yaml 文件，请确保正确修改以下字段。

• hosts：您主机的基本信息（主机名和 IP 地址）以及使用 SSH 连接至主机的信息。
• roleGroups.etcd：etcd 节点。
• controlPlaneEndpoint：负载均衡器地址（可选）。
• registry：镜像服务信息（可选）。

步骤 3：升级集群

运行以下命令，将您的集群升级至 Kube AI Hub 3.4 和 Kubernetes v1.22.12：

./kk upgrade --with-kubernetes v1.22.12 --with-kubesphere v3.4.1 -f sample.yaml

要将 Kubernetes 升级至特定版本，请在 --with-kubernetes 标志后明确指定版本号。以下是可用版本：v1.20.x、v1.21.x、v1.22.x、v1.23.x、* v1.24.x、* v1.25.x 和 * v1.26.x。带星号的版本可能出现边缘节点部分功能不可用的情况。因此，如需使用边缘节点，推荐安装 v1.23.x。