kubeblocks-upgrade

Upgrade the KubeBlocks operator and CRDs using Helm.

3|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/apecloud/kubeblocks-skills --skill kubeblocks-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kubeblocks-upgrade
Source: https://github.com/apecloud/kubeblocks-skills/tree/main/skills/kubeblocks-upgrade
Command: npx skills add https://github.com/apecloud/kubeblocks-skills --skill kubeblocks-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrades the KubeBlocks operator and its CRDs via Helm, ensuring a safe, cluster-friendly upgrade path without interrupting running databases.

Core Features & Use Cases

  • Upgrades the operator using helm upgrade on the kubeblocks chart, including CRD updates.
  • Preserves running clusters during the upgrade and notes post-upgrade addon considerations.
  • Supports major and minor version upgrades with alignment to release notes and required pre-checks.

Quick Start

Run helm upgrade kubeblocks kubeblocks/kubeblocks --version <VERSION> -n kb-system to upgrade the operator.

Frequently Asked Questions about kubeblocks-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade the KubeBlocks operator using Helm without interrupting running database clusters?

To upgrade the KubeBlocks operator without downtime, use the helm upgrade command on the kubeblocks chart to apply new releases and CRD changes. This process preserves running database clusters during the operator upgrade.

What steps are required when performing a major version upgrade for the KubeBlocks operator?

A major KubeBlocks operator upgrade requires checking your current version, updating CRDs, performing the helm upgrade, verifying pods, and optionally upgrading addons while aligning with release notes and required pre-checks.

Does upgrading the KubeBlocks operator via Helm also update CRDs?

Yes, upgrading the KubeBlocks operator via Helm includes CRD updates. The upgrade process enforces updating CRDs and applying new releases to ensure a safe, cluster-friendly upgrade path.

What happens to KubeBlocks addons after an operator upgrade?

After a KubeBlocks operator upgrade, addon upgrades are optional. The upgrade process notes post-upgrade addon considerations, allowing you to address addon upgrades separately while preserving running clusters.

What is the correct Helm command to upgrade KubeBlocks to a specific version?

Run helm upgrade kubeblocks kubeblocks/kubeblocks --version <VERSION> -n kb-system to upgrade the KubeBlocks operator to a specific release version in your Kubernetes cluster.

Do I need to check the current KubeBlocks version before running helm upgrade?

Yes, checking the current KubeBlocks version is an enforced step before upgrading. This pre-check ensures a safe upgrade path by aligning with release notes and identifying required CRD updates.