使用 KubeKey 升级

对于 KubeSphere 和 Kubernetes 都是通过 KubeSphere Installer 部署的用户，推荐使用 KubeKey 升级。如果你的 Kubernetes 是由云供应商托管或自行配置的，请参阅使用 ks-installer 升级。

视频演示

警告

如果你的 KubeSphere 是 v2.1.0 或更早的版本，请先升级至 v2.1.1。

从 GitHub Release Page 下载 KubeKey 或直接使用以下命令。

curl -sfL https://get-kk.kubesphere.io | VERSION=v1.0.1 sh -

先执行以下命令以确保您从正确的区域下载 KubeKey。

export KKZONE=cn

执行以下命令下载 KubeKey。

curl -sfL https://get-kk.kubesphere.io | VERSION=v1.0.1 sh -

备注

在您下载 KubeKey 后，如果您将其传至新的机器，且访问 Googleapis 同样受限，在您执行以下步骤之前请务必再次执行 export KKZONE=cn 命令。

备注

执行以上命令会下载最新版 KubeKey (v1.0.1)，您可以修改命令中的版本号下载指定版本。

为 kk 添加可执行权限：

chmod +x kk

警告

在 v3.0.0 版本中，KubeSphere 重构了其许多组件，例如 Fluent Bit Operator 和 IAM。如果你对这些组件有自定义修改，请先备份。

对于单节点集群（all-in-one）和多节点集群，升级步骤是不同的。

信息

使用 Kubernetes 升级将导致 helm 从 v2 升级到 v3。如果您想继续使用 helm2，请先备份它： cp /usr/local/bin/helm /usr/local/bin/helm2。
当升级 Kubernetes 时，KubeKey 将从一个小版本升级到下一个小版本，直到目标版本。例如，你需要从 1.16 升级至 1.18，会先升级到 1.17 然后在升级到 1.18，而不是直接从 1.16 升级到 1.18。

使用下面的命令将你单节点集群（all-in-one）升级至 KubeSphere v3.0.0 和 Kubernetes v1.17.9（默认）：

./kk upgrade --with-kubernetes v1.17.9 --with-kubesphere v3.0.0

如果要将 Kubernetes 升级至特定版本，可以通过 --with-kubernetes 指定版本号，以下是可用版本:

这个命令会根据你的集群来创建一个 config-sample.yaml 配置文件。

./kk create config --from-cluster

备注

假设你的 kubeconfig 在 ~/.kube/config 目录，你可以通过 --kubeconfig 指定它的位置。

根据你的集群信息修改 config-sample.yaml 文件，请确保以下字段被正确修改。

备注

你可以参阅 config-example.yaml 中的集群部分获取更多的信息。

使用下面的命令将你的集群升级至 KubeSphere v3.0.0 和 Kubernetes v1.17.9（默认）：

./kk upgrade --with-kubernetes v1.17.9 --with-kubesphere v3.0.0 -f config-sample.yaml

如果要将 Kubernetes 升级至特定版本，可以通过 --with-kubernetes 指定版本号，以下是可用版本：