Getting Started
Concepts and Features
Backup and Restore
In Place Update
Instance Template
Trouble Shooting
References
Upgrade KubeBlocks
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.
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
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.
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.
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
.
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 |
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.
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.