KubeBlocks
BlogsKubeBlocks Cloud

Getting Started

Introduction
Supported addons
Installation

Concepts and Features

Concepts

Backup and Restore

Introduction

Backup

Configure BackupRepo
Configure BackupPolicy
Scheduled backup
On-demand backup

Restore

Restore from backup set
Point-in-Time Recovery

In Place Update

Introduction
Enable in-place update

Instance Template

Introduction
Apply instance template

Trouble Shooting

FAQs

References

API Reference

Cluster
Operations
Parameters
Dataprotection
Add-On
Terminology
Install Addons
Install kbcli
Create a test Kubernetes cluster
Kubernetes and Operator 101

Upgrade KubeBlocks

Upgrade to v0.8
Upgrade to v0.9.0
Upgrade to v0.9.x

Release Notes

v1.0.0-cn
v1.0.0
v0.9.3
v0.9.2
v0.9.1
v0.9.0
  1. Upgrade from KubeBlocks v0.7
  2. Upgrade from KubeBlocks v0.6

Upgrade to KubeBlocks v0.8

In this tutorial, you will learn how to upgrade to KubeBlocks v0.8.

NOTE

Execute helm -n kb-system list | grep kubeblocks or kbcli version to check the current KubeBlocks version you are running, and then upgrade it.

Upgrade from KubeBlocks v0.7

  1. Set keepAddons.

    KubeBlocks v0.8 streamlines the default installed engines and separates the addons from KubeBlocks operators to KubeBlocks-Addons repo, such as greptime, influxdb, neon, oracle-mysql, orioledb, tdengine, mariadb, nebula, risingwave, starrocks, tidb, and zookeeper. To avoid deleting addon resources that are already in use during the upgrade, execute the following commands:

  • Check the current KubeBlocks version.

    helm -n kb-system list | grep kubeblocks

  • Set the value of keepAddons as 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

    Replace {VERSION} with your current KubeBlocks version, such as 0.7.2.

  • Check addons.

    Execute the following command to ensure that the addon annotations contain "helm.sh/resource-policy": "keep".

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

  1. Install CRD.

    To reduce the size of Helm chart, KubeBlocks v0.8 removes CRD from the Helm chart. Before upgrading, you need to install CRD.

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

  2. Upgrade KubeBlocks.

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

To avoid affecting existing database clusters, when upgrading to KubeBlocks v0.8, the versions of already-installed addons will not be upgraded by default. If you want to upgrade the addons to the versions built into KubeBlocks v0.8, execute the following command. Note that this may restart existing clusters and affect availability. Please proceed with caution.

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

  1. Download kbcli v0.8.

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

  2. Upgrade KubeBlocks.

    kbcli kb upgrade --version 0.8.1 --set dataProtection.image.datasafed.tag=0.1.0

    kbcli will automatically add the annotation "helm.sh/resource-policy": "keep" to ensure that existing addons are not deleted during the upgrade.

Upgrade from KubeBlocks v0.6

If you are currently running KubeBlocks v0.6, please upgrade to v0.7.2 first.

  1. Download kbcli v0.7.2.

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

  2. Upgrade to KubeBlocks v0.7.2.

    kbcli kb upgrade --version 0.7.2

© 2025 ApeCloud PTE. Ltd.