使用 KubeKey 升级
对于 KubeSphere 和 Kubernetes 都由 KubeKey 部署的用户,推荐使用 KubeKey 升级。如果您的 Kubernetes 集群由云厂商托管或自行配置,请参考使用 ks-installer 升级。
本教程演示如何使用 KubeKey 升级集群。
准备工作
- 您需要有一个运行 KubeSphere v3.2.x 的集群。如果您的 KubeSphere 是 v3.1.0 或更早的版本,请先升级至 v3.2.x。
- 请仔细阅读 3.3.2 版本说明。
- 提前备份所有重要的组件。
- 确定您的升级方案。本文档中提供 All-in-One 集群和多节点集群的两种升级场景。
重要提示
KubeSphere 3.3.1 对内置角色和自定义角色的授权项做了一些调整。在您升级到 KubeSphere 3.3.1 时,请注意以下几点:
内置角色调整:移除了平台级内置角色
users-manager
(用户管理员)和workspace-manager
(企业空间管理员),如果已有用户绑定了users-manager
或workspace-manager
,他们的角色将会在升级之后变更为platform-regular
。增加了平台级内置角色platform-self-provisioner
。关于平台角色的具体描述,请参见创建用户。自定义角色授权项调整:
- 移除平台层级自定义角色授权项:用户管理,角色管理,企业空间管理。
- 移除企业空间层级自定义角色授权项:成员管理,角色管理,用户组管理。
- 移除命名空间层级自定义角色授权项:成员管理,角色管理。
- 升级到 KubeSphere 3.3.1 后,自定义角色会被保留,但是其包含的已被移除的授权项会被删除。
下载 KubeKey
升级集群前执行以下命令下载 KubeKey。
从 GitHub 发布页面下载 KubeKey 或直接使用以下命令。
curl -sfL https://get-kk.kubesphere.io | VERSION=v3.0.7 sh -
先执行以下命令以确保您从正确的区域下载 KubeKey。
export KKZONE=cn
执行以下命令下载 KubeKey。
curl -sfL https://get-kk.kubesphere.io | VERSION=v3.0.7 sh -
备注
export KKZONE=cn
命令。备注
为 kk
添加可执行权限:
chmod +x kk
升级 KubeSphere 和 Kubernetes
单节点集群 (All-in-One) 和多节点集群的升级步骤不同。
信息
All-in-One 集群
运行以下命令使用 KubeKey 将您的单节点集群升级至 KubeSphere 3.3 和 Kubernetes v1.22.12:
./kk upgrade --with-kubernetes v1.22.12 --with-kubesphere v3.3.2
要将 Kubernetes 升级至特定版本,请在 --with-kubernetes
标志后明确指定版本号。以下是可用版本:v1.20.x、v1.21.x、* v1.22.x、* v1.23.x 和 * v1.24.x。带星号的版本可能出现边缘节点部分功能不可用的情况。因此,如需使用边缘节点,推荐安装 v1.21.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:升级集群
运行以下命令,将您的集群升级至 KubeSphere 3.3 和 Kubernetes v1.22.12:
./kk upgrade --with-kubernetes v1.22.12 --with-kubesphere v3.3.2 -f sample.yaml
要将 Kubernetes 升级至特定版本,请在 --with-kubernetes
标志后明确指定版本号。以下是可用版本:v1.20.x、v1.21.x、* v1.22.x、* v1.23.x 和 * v1.24.x。带星号的版本可能出现边缘节点部分功能不可用的情况。因此,如需使用边缘节点,推荐安装 v1.21.x。
备注
反馈
这篇文章对您有帮助吗?
通过邮件接收 KubeSphere 最新的技术博客与产品更新的通知
感谢您的反馈。如果您有关于如何使用 KubeSphere 的具体问题,请在 Slack 上提问。如果您想报告问题或提出改进建议,请在 GitHub 存储库中打开问题。