使用 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 已包含在 Kube AI Hub 离线安装包中。解压离线包后，根据您的架构选择对应的二进制文件：
# x86_64 架构
mv kk-x86 kk
# ARM64 架构
mv kk-arm kk
chmod +x kk
备注
升级 Kube AI Hub 和 Kubernetes
单节点集群 (All-in-One) 和多节点集群的升级步骤不同。
信息
All-in-One 集群
运行以下命令使用 KubeKey 将您的单节点集群升级至 Kube AI Hub 3.4 和 Kubernetes v1.34.4：
./kk upgrade --with-kubernetes v1.34.4 --with-kubesphere v3.4.1
要将 Kubernetes 升级至特定版本，请在 --with-kubernetes 标志后明确指定版本号。以下是可用版本：v1.28.x、v1.29.x、v1.30.x、v1.31.x、v1.32.x、v1.33.x 和 v1.34.x（建议 v1.34.x）。
多节点集群
步骤 1：使用 KubeKey 生成配置文件
运行以下命令会基于您的集群创建一个 sample.yaml 配置文件。
./kk create config --from-cluster
备注
~/.kube/config。您可以通过 --kubeconfig 标志进行修改。步骤 2：修改配置文件模板
根据您的集群配置修改 sample.yaml 文件，请确保正确修改以下字段。
hosts：您主机的基本信息（主机名和 IP 地址）以及使用 SSH 连接至主机的信息。roleGroups.etcd：etcd 节点。controlPlaneEndpoint：负载均衡器地址（可选）。registry：镜像服务信息（可选）。
备注
步骤 3：升级集群
运行以下命令，将您的集群升级至 Kube AI Hub 3.4 和 Kubernetes v1.34.4：
./kk upgrade --with-kubernetes v1.34.4 --with-kubesphere v3.4.1 -f sample.yaml
要将 Kubernetes 升级至特定版本，请在 --with-kubernetes 标志后明确指定版本号。以下是可用版本：v1.28.x、v1.29.x、v1.30.x、v1.31.x、v1.32.x、v1.33.x 和 v1.34.x（建议 v1.34.x）。
备注
上一篇
