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. Highlights
    1. APIs Graduated to Stable
    2. KubeBlocks Features
    3. KubeBlocks Addon Highlights
  2. What's Changed
    1. KubeBlocks
      1. Cluster Management
      2. Data Protection
      3. Operations
    2. KubeBlocks Addons
      1. MySQL
      2. Redis
      3. MongoDB
      4. Kafka
      5. RabbitMQ
      6. ClickHouse
      7. TiDB
    3. API Graduations, Deprecations, and Removals
      1. GA (v1) API Promotions
      2. Deprecations
      3. New Alpha APIs (Experimental)
      4. API Group Realignment
  3. Upgrade Notice
  4. Acknowledgments

KubeBlocks 1.0.0 (2025-05-28)

We are glad to announce the release of KubeBlocks 1.0.0.

KubeBlocks 1.0.0 marks a significant milestone, with key APIs graduating to stable (v1) and substantial enhancements in cluster management, data protection, and operational stability—bringing greater flexibility and reliability to production environments.

Highlights

APIs Graduated to Stable

KubeBlocks 0.9 introduced flexible topologies, advanced pod management (InstanceSet), and lifecycle hooks. Many of these features have now graduated to stable.

The following CRDs are now v1 and considered stable, with long-term support:

apps.kubeblocks.io API Group:

  • ClusterDefinition
  • Cluster
  • ComponentDefinition
  • Component
  • ComponentVersion
  • ServiceDescriptor
  • ShardingDefinition
  • SidecarDefinition

workloads.kubeblocks.io API Group:

  • InstanceSet

KubeBlocks Features

  • Rolling Updates: Supports rolling upgrades via the Cluster API, minimizing downtime during updates
  • Incremental Backups: Introduces support for incremental backups to improve performance and reduce storage usage

KubeBlocks Addon Highlights

  • MySQL Enhancements: Adds TLS, group replication with ProxySQL, and PITR using WAL-G—boosting security and recovery
  • MongoDB PITR & Versioning: Introduces Point-in-Time Recovery and new version support for MongoDB
  • Kafka Improvements: Supports external ZooKeeper, custom Prometheus metrics, and multi-network access for better flexibility and observability
  • Redis Enhancements: Adds cluster switchover, instance rebuild, and external config support to improve operational robustness

What's Changed

KubeBlocks

Cluster Management

  • Rolling Upgrades: Enables zero-downtime upgrades via Cluster API #8973
  • Dynamic Image Registry: Supports dynamic image registry replacement for more flexible deployments #8018
  • Shard Pod Anti-Affinity: Adds anti-affinity rules for shard components #8705
  • Pod Metadata Updates: Allows updating labels and annotations for underlying pods #8571
  • PVC Volume Attributes: Enables setting volumeAttributesClass for PVCs #8783
  • PolicyRules for Component Definitions: Adds granular policy control #8328
  • Component Role Refactoring: Improves role definition for component management #8416

Data Protection

  • Incremental Backups: Adds support for efficient, incremental backups #8693
  • Backup/Restore Parameters: Ensures config consistency during backup/restore #8472
  • Retain Latest Backup: Adds option to retain the latest backup #9088

Operations

  • OpsRequest Validation: Introduces validation policies to enforce operation correctness #8232

KubeBlocks Addons

MySQL

  • TLS Support: Adds TLS for secure connections #1462
  • Group Replication with ProxySQL: Enhances HA via ProxySQL integration #1467
  • PITR Support: Enables Point-in-Time Recovery using WAL-G #1451
  • Continuous & Incremental Backups: Improves backup strategy with WAL-G #1456

Redis

  • Cluster Switchover & Sentinel Optimization: Enhances failover capabilities #1414
  • Instance Rebuild: Adds support for rebuilding Redis instances #1417

MongoDB

  • PITR Support: Adds Point-in-Time Recovery #1487
  • New Version Support: Adds support for MongoDB versions 8.0.8 and 8.0.6 #1431, #1590

Kafka

  • External ZooKeeper: Adds external ZooKeeper support for Kafka 2.7 #1297
  • Custom Prometheus Metrics: Allows configuring custom metrics #1544
  • Skip Advertise Port Parsing: Avoids parsing when using Pod IP #1569
  • Custom Security Context: Adds support for custom security settings #1337

RabbitMQ

  • New Versions: Adds support for RabbitMQ versions 4.0.9 #1596

ClickHouse

  • 22.9.4 Support: Adds compatibility with ClickHouse 22.9.4 #1376

TiDB

  • 8.4 Version Support: Adds support for TiDB 8.4 #1384
  • Upgrade to 6.5.12: Updates TiDB 6 to v6.5.12 #1664

API Graduations, Deprecations, and Removals

GA (v1) API Promotions

The following CRDs are now promoted to v1 and considered stable, with long-term support:

apps.kubeblocks.io API Group

  • ClusterDefinition
  • Cluster
  • ComponentDefinition
  • Component
  • ComponentVersion
  • ServiceDescriptor
  • ShardingDefinition
  • SidecarDefinition

workloads.kubeblocks.io API Group

  • InstanceSet

v1alpha1 and v1beta1 versions of these resources are now deprecated and may be dropped in a future release.

Deprecations

The following CRDs are deprecated and will be removed in upcoming releases. Migrate your configurations accordingly:

  • ConfigConstraint
  • Configuration

These resources are no longer maintained or receiving updates.

New Alpha APIs (Experimental)

A new parameters.kubeblocks.io API group introduces fine-grained configuration APIs:

  • ComponentParameter
  • ParamConfigRenderer
  • Parameter
  • ParametersDefinition

These are intended to replace the deprecated ConfigConstraint and Configuration.

API Group Realignment

Several APIs have moved to new groups to better reflect their domain responsibilities. Update your manifests accordingly:

ResourceOld API GroupNew API Group
OpsDefinition / OpsRequestapps.kubeblocks.iooperations.kubeblocks.io
BackupPolicyTemplateapps.kubeblocks.iodataprotection.kubeblocks.io

Upgrade Notice

NOTE

Please note that direct upgrades from version 0.9 to 1.0 are NOT currently supported.

We are actively developing a robust and tested upgrade path, which will be included in the upcoming release.

Acknowledgments

As we celebrate the release of KubeBlocks 1.0.0, we’d like to extend our sincere thanks to all the engineers, contributors, and partners who have helped shape the project into what it is today.

Special thanks to Kuaishou, China Mobile Cloud, Vipshop, Tencent, and 360 for their technical contributions, in-depth feedback, and real-world use cases that have significantly advanced the project’s architecture, performance, and production readiness.

We’re also deeply grateful to our community contributors — your code contributions, issue reports, discussions, and reviews have been instrumental in driving the project forward with quality and innovation.

With 1.0.0, we’ve reached a major milestone in building a robust, cloud-native database platform. We look forward to continuing this journey with all of you — growing the ecosystem, tackling new challenges, and pushing the boundaries of what’s possible in data infrastructure.

© 2025 ApeCloud PTE. Ltd.