KubeBlocks Docs

earayu

No description available

Documents Knowledge Graph

user_docs.release_notes.release-10.100.pdf

Table (html):

KBBlocks

Documentation

Databases

Blogs

KubeBlocks Cloud ☑

非

✓

Highlights

APIs Graduated to Stable KubeBlocks Features KubeBlocks Addon Highlights

What's Changed KubeBlocks

Cluster Management Data Protection Operations

KubeBlocks Addons

MySQL Redis MongoDB

Kafka

RabbitMQ

ClickHouse

TiDB

API Graduations, Deprecations, and Removals

GA (v1) API Promotions Deprecations New Alpha APIs (Experimental) API Group Realignment

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

ComponentComponentVersionServiceDescriptorShardingDefinitionSidecarDefinition

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 volumeAttributeClass 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:

Table (html):

Resource	Old API Group	New API Group
OpsDefinition / OpsRequest	apps.kubeblocks.io	operations.kubeblocks.io
BackupPolicyTemplate	apps.kubeblocks.io	dataprotection.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 allof you - growing the ecosystem, tackling new challenges, and pushing the boundaries of what's possible in data infrastructure.