Getting Started
Concepts and Features
Backup and Restore
In Place Update
Instance Template
Trouble Shooting
References
Upgrade KubeBlocks
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:
Resource | Old API Group | New API Group |
---|---|---|
OpsDefinition / OpsRequest | apps.kubeblocks.io | operations.kubeblocks.io |
BackupPolicyTemplate | apps.kubeblocks.io | dataprotection.kubeblocks.io |
Upgrade Notice
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.