KubeBlocks
BlogsKubeBlocks Cloud
⌘K
​

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
Known Issues

References

API Reference

Cluster
Operations
Parameters
Dataprotection
Add-On
Terminology
Addons Management
Install kbcli
Snapshot Controller
Create a test Kubernetes cluster
Kubernetes and Operator 101
KubeBlocks Options and Roles
Install MinIO

Upgrade KubeBlocks

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

Release Notes

Release v1.0

v1.0.1
v1.0.0

Release v0.9

v0.9.5
v0.9.4
v0.9.3
v0.9.2
v0.9.1
v0.9.0
  1. Before You Begin
    1. Verify Your Current Version
    2. Choose Your Upgrade Path
  2. Upgrade from KubeBlocks v1.0.x
  3. Getting Help

Upgrade to KubeBlocks v1.0.x

This guide walks you through upgrading KubeBlocks to version 1.0.x.

Before You Begin

Verify Your Current Version

First, check which version of KubeBlocks you're currently running:

# Using helm
helm -n kb-system list | grep kubeblocks

# Using kbcli
kbcli version

Choose Your Upgrade Path

Select the appropriate upgrade path based on your current version:

Current VersionTarget: v1.0.xUpgrade Path
v1.0.x✅ Direct upgradeFollow Upgrade from KubeBlocks v1.0.x
v0.9.x❌ Not supportedN/A

Upgrade from KubeBlocks v1.0.x

This section covers upgrading between v1.0.x versions (for example, from v1.0.0 to v1.0.1). Since these are patch releases within the same major version, the upgrade process is straightforward.

NOTE

Version Placeholder:

Throughout this section, replace v1.0.1 with your target version number (e.g., v1.0.1).

Step 1: Update Custom Resource Definitions (CRDs)

KubeBlocks separates CRDs from the Helm chart to reduce chart size. Start by updating the CRDs:

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

Step 2: Upgrade KubeBlocks Core

First, update your Helm repository to get the latest chart information:

helm repo add kubeblocks https://apecloud.github.io/helm-charts
helm repo update kubeblocks

Then upgrade KubeBlocks to the target version:

helm -n kb-system upgrade kubeblocks kubeblocks/kubeblocks --version v1.0.1

Step 3: (Optional) Upgrade Addons

NOTE

We are glad to announce that since KubeBlocks 1.0.0, each ComponentDefinition CR has its own version (usually the same as its Addon version), existing Clusters will not be affected by the Addon upgrade.

But it is still recommended to test upgrade Addons in a non-production environment first.

To upgrade Addons to the versions bundled with the new KubeBlocks version:

helm -n kb-system upgrade kubeblocks kubeblocks/kubeblocks --version v1.0.1  --set upgradeAddons=true

Or you want to upgrade specific Addons follow the steps in Upgrade Addons

Step 1: Update kbcli

Download and install the matching version of kbcli:

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

Step 2: Upgrade KubeBlocks Core

Perform the core upgrade without updating Addons:

kbcli kb upgrade --version v1.0.1

Step 3: (Optional) Upgrade Addons

NOTE

We are glad to announce that since KubeBlocks 1.0.0, each ComponentDefinition CR has its own version (usually the same as its Addon version), existing Clusters will not be affected by the Addon upgrade.

But it is still recommended to test upgrade Addons in a non-production environment first.

To upgrade Addons to the versions bundled with the new KubeBlocks version:

kbcli kb upgrade --version v1.0.1 --set upgradeAddons=true

Or you want to upgrade specific Addons follow the steps in Upgrade Addons

Getting Help

If you encounter issues during the upgrade process:

  • Check the logs: Review upgrade logs using kubectl -n kb-system logs deployment/kubeblocks
  • Community Support: Visit the KubeBlocks GitHub Issues for known issues and community help

© 2025 ApeCloud PTE. Ltd.