跳到主要内容

升级到 KubeBlocks v0.8

本文档介绍如何从低版本 KubeBlocks 升级至 KubeBlocks 0.8 版本。

备注

在升级前，请先执行 kbcli version 查看正在使用的 KubeBlocks 版本，并根据不同版本，执行升级操作。

从 v0.6 版本升级​

如果当前使用的是 KubeBlocks v0.6 版本，请先将 KubeBlocks 升级至 v0.7.2 版本，操作如下：

  1. 下载 kbcli v0.7.2 版本。

    curl -fsSL https://kubeblocks.io/installer/install_cli.sh | bash -s 0.7.2

  2. 升级至 KubeBlocks v0.7.2。

    kbcli kb upgrade --version 0.7.2

从 v0.7 版本升级​

  1. 设置 keepAddons。

    KubeBlocks v0.8 精简了默认安装的引擎，将 addon 从 KubeBlocks operator 分离到了 KubeBlocks Addons 代码仓库中，例如 greptime，influxdb，neon，oracle-mysql，orioledb，tdengine，mariadb，nebula，risingwave，starrocks，tidb，zookeeper。为避免升级时将已经在使用的 addon 资源删除，请先执行如下命令。

  • 查看当前 KubeBlocks 版本。

    helm -n kb-system list | grep kubeblocks

  • 设置 keepAddons 参数为 true。

    helm repo add kubeblocks https://apecloud.github.io/helm-charts
    helm repo update kubeblocks
    helm -n kb-system upgrade kubeblocks kubeblocks/kubeblocks --version {VERSION} --set keepAddons=true

    请将以上 {VERSION} 替换为当前 KubeBlocks 的版本，比如 0.7.2。

  • 查看 addon。

    执行如下命令，确保 addon annotations 中添加了 "helm.sh/resource-policy": "keep"。

    kubectl get addon -o json | jq '.items[] | {name: .metadata.name, annotations: .metadata.annotations}'

  1. 安装 CRD。

    为避免 KubeBlocks 的 Helm chart 过大，v0.8 版本将 CRD 从 Helm chart 中移除了，升级前需要先安装 CRD。

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

  2. 升级 KubeBlocks。

    helm -n kb-system upgrade kubeblocks kubeblocks/kubeblocks --version 0.8.1 --set dataProtection.image.datasafed.tag=0.1.0
    备注

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


    helm -n kb-system upgrade kubeblocks kubeblocks/kubeblocks --version 0.8.1 --set upgradeAddons=true