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

Deprecations

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

• ConfigConstraint
• Configuration

New Alpha APIs (Experimental)

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

• ComponentParameter
• ParamConfigRenderer
• Parameter
• ParametersDefinition

API Group Realignment

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

Upgrade Notice

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.