使用 KubeKey 升级
对于 KubeSphere 和 Kubernetes 都由 KubeKey 部署的用户,推荐使用 KubeKey 升级。如果您的 Kubernetes 集群由云厂商托管或自行配置,请参考使用 ks-installer 升级。
本教程演示如何使用 KubeKey 升级集群。
准备工作
- 您需要有一个运行 KubeSphere v3.1.x 的集群。如果您的 KubeSphere 是 v3.0.0 或更早的版本,请先升级至 v3.1.x。
- 请仔细阅读 3.2.1 版本说明。
- 提前备份所有重要的组件。
- 确定您的升级方案。本文档中提供 All-in-One 集群和多节点集群的两种升级场景。
下载 KubeKey
升级集群前执行以下命令下载 KubeKey。
从 GitHub 发布页面下载 KubeKey 或直接使用以下命令。
curl -sfL https://get-kk.kubesphere.io | VERSION=v2.0.0 sh -
先执行以下命令以确保您从正确的区域下载 KubeKey。
export KKZONE=cn
执行以下命令下载 KubeKey。
curl -sfL https://get-kk.kubesphere.io | VERSION=v2.0.0 sh -
备注
export KKZONE=cn
命令。备注
为 kk
添加可执行权限:
chmod +x kk
升级 KubeSphere 和 Kubernetes
单节点集群 (All-in-One) 和多节点集群的升级步骤不同。
信息
All-in-One 集群
运行以下命令使用 KubeKey 将您的单节点集群升级至 KubeSphere 3.2.1 和 Kubernetes v1.21.5:
./kk upgrade --with-kubernetes v1.21.5 --with-kubesphere v3.2.1
要将 Kubernetes 升级至特定版本,请在 --with-kubernetes
标志后明确指定版本号。以下是可用版本:
- v1.19.x
- v1.20.x
- v1.21.x
- v1.22.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.2.1 和 Kubernetes v1.21.5:
./kk upgrade --with-kubernetes v1.21.5 --with-kubesphere v3.2.1 -f sample.yaml
要将 Kubernetes 升级至特定版本,请在 --with-kubernetes
标志后明确指定版本号。以下是可用版本:
- v1.19.x
- v1.20.x
- v1.21.x
- v1.22.x(实验性支持)
备注
反馈
这篇文章对您有帮助吗?
通过邮件接收 KubeSphere 最新的技术博客与产品更新的通知
感谢您的反馈。如果您有关于如何使用 KubeSphere 的具体问题,请在 Slack 上提问。如果您想报告问题或提出改进建议,请在 GitHub 存储库中打开问题。