跳到主要内容

升级到 KubeBlocks v0.9.2

本文档将介绍如何从不同版本升级至 KubeBlocks v0.9.2。

备注

  • 升级前，请查看当前 KubeBlocks 的版本，并根据不同版本，执行升级操作。 执行 helm -n kb-system list | grep kubeblocks 或 kbcli version。

  • 如需升级到其他版本，可参考以下操作指南：

    建议安装最新版本，以体验全新功能及更优性能。

兼容性说明​

KubeBlocks v0.9.2 可以兼容 KubeBlocks v0.8 的 API，但不保证兼容 v0.8 之前版本的 API，如果您正在使用 KubeBlocks v0.7 或者更老版本的引擎（版本号为 0.7.x, 0.6.x），请务必参考 v0.8 升级文档将 KubeBlocks 升级至 v0.8 并将所有引擎升级至 0.8，以确保升级至 v0.9 版本后服务的可用性。

如果您是从 v0.8 升级到 v0.9，需要打开 webhook，以确保可用性。

从 v0.9.x 升级​

  1. 查看引擎，确认引擎是否已添加 "helm.sh/resource-policy": "keep" 注解。

    KubeBlocks 对默认安装的引擎做了精简。添加 "helm.sh/resource-policy": "keep" 注解，以避免升级时删除已经在使用的引擎资源。

    查看引擎中是否添加了 "helm.sh/resource-policy": "keep"。

    kubectl get addon -o json | jq '.items[] | {name: .metadata.name, resource_policy: .metadata.annotations["helm.sh/resource-policy"]}'

    如果没有该注解，可以手动执行以下命令，为引擎添加注解。可以把 -l app.kubernetes.io/name=kubeblocks 替换为您所需的过滤条件。

    kubectl annotate addons.extensions.kubeblocks.io -l app.kubernetes.io/name=kubeblocks helm.sh/resource-policy=keep

  2. 安装 CRD。

    为避免 KubeBlocks Helm Chart 过大，0.8 版本将 CRD 从 Helm Chart 中移除了，升级前需要先安装 CRD。

    kubectl replace -f https://github.com/apecloud/kubeblocks/releases/download/v0.9.2/kubeblocks_crds.yaml

  3. 升级 KubeBlocks。

    helm -n kb-system upgrade kubeblocks kubeblocks/kubeblocks --version 0.9.2 --set crd.enabled=false

    KubeBlocks v0.9.0/v0.9.1 到 v0.9.2 的升级不涉及 API 变更，可通过设置 --set crd.enabled=false 跳过 API 升级任务。

    注意

    为避免影响已有的数据库集群，升级 KubeBlocks 至 v0.9.2 时，默认不会升级已经安装的引擎版本，如果要升级引擎版本至 KubeBlocks v0.9.2 内置引擎的版本，可以执行如下命令，这可能导致已有集群发生重启，影响可用性，请务必谨慎操作。

    helm -n kb-system upgrade kubeblocks kubeblocks/kubeblocks --version 0.9.2 \
      --set upgradeAddons=true \
      --set crd.enabled=false

从 v0.8.x 升级​

  1. 查看引擎，确认引擎是否已添加 "helm.sh/resource-policy": "keep" 注解。

    KubeBlocks 对默认安装的引擎做了精简。添加 "helm.sh/resource-policy": "keep" 注解可以避免升级时删除已经在使用的引擎资源。

    查看引擎中是否添加了 "helm.sh/resource-policy": "keep"。

    kubectl get addon -o json | jq '.items[] | {name: .metadata.name, resource_policy: .metadata.annotations["helm.sh/resource-policy"]}'

    如果没有该注解，可以手动执行以下命令，为引擎添加注解。可以将 -l app.kubernetes.io/name=kubeblocks 替换为您所需的过滤条件。

    kubectl annotate addons.extensions.kubeblocks.io -l app.kubernetes.io/name=kubeblocks helm.sh/resource-policy=keep

  2. 删除不兼容的 OpsDefinition。

    kubectl delete opsdefinitions.apps.kubeblocks.io kafka-quota kafka-topic kafka-user-acl switchover

  3. 安装 CRD。

    为避免 KubeBlocks Helm Chart 过大，0.8 版本将 CRD 从 Helm Chart 中移除了，变更了 StorageProvider 的 group。升级前，需要先安装 StorageProvider CRD。

    如果网络较慢，建议先下载 CRD YAML 文件到本地，再执行操作。

    kubectl create -f https://github.com/apecloud/kubeblocks/releases/download/v0.9.2/dataprotection.kubeblocks.io_storageproviders.yaml

  4. 升级 KubeBlocks。

    请关注以下选项：

    • 设置 admissionWebhooks.enabled=true 将启动 webhook，用于 ConfigConstraint API 多版本转换。
    • 设置 admissionWebhooks.ignoreReplicasCheck=true 默认只有在 3 副本部署 KubeBlocks 时才可开启 webhook。若只部署单副本 KubeBlocks，可配置该变量跳过检查。
    • 如果您当前运行的 KubeBlocks 使用的镜像仓库是以 infracreate-registry开头，升级时请显式设置镜像仓库。具体可参考 FAQ 中镜像仓库章节
    helm repo add kubeblocks https://apecloud.github.io/helm-charts

    helm repo update kubeblocks

    helm -n kb-system upgrade kubeblocks kubeblocks/kubeblocks --version 0.9.2 \
      --set admissionWebhooks.enabled=true \
      --set admissionWebhooks.ignoreReplicasCheck=true
    注意

    为避免影响已有的数据库集群，升级 KubeBlocks 至 v0.9.2 时，默认不会升级已经安装的引擎版本，如果要升级引擎版本至 KubeBlocks v0.9.2 内置引擎的版本，可以执行如下命令，这可能导致已有集群发生重启，影响可用性，请务必谨慎操作。

    helm -n kb-system upgrade kubeblocks kubeblocks/kubeblocks --version 0.9.2 \
      --set upgradeAddons=true \
      --set admissionWebhooks.enabled=true \
      --set admissionWebhooks.ignoreReplicasCheck=true

升级引擎​

如果您在上述步骤中，没有将 upgradeAddons 指定为 true，或者您想要使用的引擎不在默认列表中，但您想要使用 v0.9.2 API，可使用如下方式升级引擎。

备注

  • 如果要升级的引擎是 mysql，需要先升级引擎并重启集群。否则使用 KubeBlocks v0.8.x 创建的集群将无法在 v0.9.2 中正常运行。

  • 如果您想要升级 clickhouse/milvus/elasticsearch/llm，您需要先升级 KubeBlocks，再升级引擎，否在将无法在 v0.9.2 中正常使用。

# 添加 Helm 仓库
helm repo add kubeblocks-addons https://apecloud.github.io/helm-charts

# 如果无法访问 Github 或者访问速度过慢，可使用以下仓库地址
helm repo add kubeblocks-addons https://jihulab.com/api/v4/projects/150246/packages/helm/stable

# 更新 Helm 仓库
helm repo update

# 检索可用的引擎版本
helm search repo kubeblocks-addons/{addon-name} --versions --devel 

# 更新引擎版本
helm upgrade -i {addon-release-name} kubeblocks-addons/{addon-name} --version x.y.z -n kb-system

FAQ​

可查看 FAQ，了解并解决升级 KubeBlocks 过程中的常见问题。如果您还遇到了其他问题，可以提交 issue 或者在 GitHub 讨论区提交您的问题。