升级到 KubeBlocks v0.8

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

备注

在升级前，请先执行 helm -n kb-system list | grep kubeblocks 查看正在使用的 KubeBlocks 版本，并根据不同版本，执行升级操作。

Upgrade from 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

Upgrade from KubeBlocks v0.7

1. 设置 keepAddons。

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

   • 查看当前 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 annotations 中添加了 "helm.sh/resource-policy": "keep"。

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

2. 安装 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

3. 升级 KubeBlocks。

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

备注

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

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