使用 KubeKey 升级

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

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

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

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

    执行以下命令下载 KubeKey。

    备注

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

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

    为 kk 添加可执行权限：

    1. chmod +x kk

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

    信息

    当升级 Kubernetes 时，KubeKey 将从一个小版本升级到下一个小版本，直到目标版本。例如，您会发现升级过程先从 1.16 先升级到 1.17 然后再升级到 1.18，而不是直接从 1.16 升级到 1.18。

    运行以下命令使用 KubeKey 将您的单节点集群升级至 KubeSphere 3.2.0 和 Kubernetes v1.21.5：

    要将 Kubernetes 升级至特定版本，请在 --with-kubernetes 标志后明确指定版本号。以下是可用版本：

    • v1.19.x
    • v1.20.x
    • v1.21.x

    多节点集群

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

    1. ./kk create config --from-cluster

    备注

    假设您的 kubeconfig 位于 ~/.kube/config。您可以通过 --kubeconfig 标志进行修改。

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

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

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

    备注

    有关更多信息，请参见，或参考完整配置文件中的 Cluster 部分获取更多信息。

    步骤 3：升级集群

    运行以下命令，将您的集群升级至 KubeSphere 3.2.0 和 Kubernetes v1.21.5：

    要将 Kubernetes 升级至特定版本，请在 标志后明确指定版本号。以下是可用版本：

    • v1.19.x
    • v1.20.x
    • v1.21.x

    若要使用 KubeSphere 3.2.0 的部分新功能，您需要在升级后启用对应的可插拔组件。