KubeBlocks
BlogsEnterprise
⌘K
​
Back
  1. KubeBlocks
    1. Features
    2. Bug Fixes
  2. KubeBlocks Addons
    1. MySQL
    2. PostgreSQL
    3. Redis
    4. MongoDB
    5. ClickHouse
    6. Elasticsearch
    7. Kafka
    8. Milvus
    9. MinIO
    10. Nebula
    11. Qdrant
    12. RabbitMQ
    13. RocketMQ
    14. TiDB
    15. ZooKeeper
  3. Breaking Changes
    1. Variable Rendering Fix (#9935)
  4. Upgrade to v1.0.2
  5. Full Changelog

Announcing KubeBlocks v1.0.2

We are delighted to announce the release of KubeBlocks v1.0.2. This release includes several new features, bug fixes, and various improvements. Here are the detailed update contents.

KubeBlocks

Features

  • Make StorageClass reclaimPolicy configurable - Allows configuring StorageClass reclaimPolicy via values.yaml when deploying KubeBlocks. (#10040)
  • Support specifying an update policy for the upgrade operation - Allows specifying update policies for upgrade operations. (#9736)
  • Support referencing the service version in vars - Enables referencing service versions in variables. (#9735)

Bug Fixes

  • Fix persistentVolumeClaimRetentionPolicy not working - Ensures PVCs are kept on Retain policy when the cluster is deleted or scaled down. (#10043)
  • Remove global affinity and tolerations for worker plane - Removed global settings of affinity and tolerations for worker nodes. It's recommended to set affinity and tolerations at the cluster level through schedulingPolicy instead. (#9949)
  • Adopt Restored PVC - Adopt restored PVCs in InstanceSet when restoring from backup. (#9882)
  • Improve sharding restore - Enhances the sharding cluster restore functionality. (#10026,#10023,#9900)

KubeBlocks Addons

MySQL

  • Support MySQL minor versions 8.0.41, 8.0.44 (#2295)
  • Fix MySQL log_output parameter constraint (#2408)
  • Disable jemalloc for ARM (#2381))

PostgreSQL

  • Support PostgreSQL 18.1 (#2409)
  • Improve PostgreSQL config constraint comment (#2376)
  • Unset archive_timeout immutable for PostgreSQL (#2380)
  • Set wal_keep_size by data disk size (#2372)

Redis

  • Support 7.2.11/7.4.6/8.0.4/8.2.2 for redis CVE-2025-49844 issue (#2123)
  • Support more minor versions of Redis 7.2.12/7.4.7/8.0.5/8.2.3/8.4.0 (#2347)
  • Improve Redis maxmemory parameter (#2392)
  • Fix redis cluster switchover failed (#2423)
  • Fix invalid config cue constraint (#2421)
  • Fix hscale failed when using loadBalance mode (#2397)
  • Fix redis cluster restore failed (#2404)
  • Fix redis pitr no time range (#2204)

MongoDB

  • Support MongoDB minor versions 8.0.17/7.0.28/6.0.27 (#2382)
  • Support MongoDB audit log (#2111)
  • Fix MongoDB backup hang (#2387)

ClickHouse

  • Improve ClickHouse memberjoin (#2431)
  • Improve ClickHouse sharding restore (#2357)
  • Fix ClickHouse restore failed when specified the init cluster name (#2429)

Elasticsearch

  • Support ES 6.x, ES 7.10.2 (#1998,#2337)
  • Support zone awareness shard allocation (#2185)
  • Add plugin analysis-pinyin (#2285)
  • Fix single node backup failed (#2290)
  • Fix ES render tpl compatibility (#2411)

Kafka

  • Support Kafka 3.7/3.8/3.9 (#2174)
  • Support custom SASL (#2259)
  • Support Kafka backup topics (#2260)
  • Fix Kafka backup when both SASL and TLS enabled (#2289)

Milvus

  • Support Milvus backup and restore (#2252)
  • Fix rebuild index when restoring Milvus (#2331)

MinIO

  • Support MinIO RELEASE.2025-10-15T17-29-55Z (#2279)

Nebula

  • Fix Nebula backup and restore failed (#2435)

Qdrant

  • Support new version v1.15.4 (#2037)

RabbitMQ

  • Support RabbitMQ 4.2.1, 4.1.6, 3.8.34(#2319)
  • Support plugins management (#2317)
  • Set memory limit to prevent OOMs (#2241)
  • Add RabbitMQ web stomp port (#2428)

RocketMQ

  • Fix RocketMQ namesrc hscale timeout (#2420)

TiDB

  • Support TiDB PITR restore (#1702)
  • Fix tidb pd scale in multiple instances (#2269)

ZooKeeper

  • Support ZooKeeper 3.9.4 (#2244)
  • Fix ZooKeeper hscale (#2216)

Breaking Changes

Variable Rendering Fix (#9935)

Variable rendering now passes map[string]any instead of map[string]string. Addons that relied on the old behavior may need template updates.

Before (KB 1.0.1 and earlier) — workaround for string-only vars:

{{if ne (index . "ENDPOINT_PORT") ""}}{{.ENDPOINT_PORT}}{{else}}5022{{end}}

After (KB 1.0.2) — simplified expression:

{{if index . "ENDPOINT_PORT"}}{{.ENDPOINT_PORT}}{{else}}5022{{end}}

Affected addons: OceanBase, MongoDB, Redis, Redis Cluster. See Issue #9934 for context.

Symptoms

After upgrading to KubeBlocks v1.0.2, existing clusters that use the OceanBase, MongoDB, Redis, or Redis Cluster addons may show:

  1. When you run kubectl describe component, events similar to:

    template: vars:1:50: executing "vars" at <.REDIS_HOST_NETWORK_PORT>: map has no entry for key "REDIS_HOST_NETWORK_PORT"

  2. In the KubeBlocks operator logs, errors similar to:

    INFO	ComponentParameterReconciler	failed to create task context: template: vars:1:50: executing "vars" at <.REDIS_HOST_NETWORK_PORT>: map has no entry for key "REDIS_HOST_NETWORK_PORT"	{"controller": "componentparameter", "controllerGroup": "parameters.kubeblocks.io", "controllerKind"

Resolution

  • Option 1 — In-place fix: Follow the approach in PR #2328 and update the variable rendering logic in the affected ComponentDefinition locally. If ComponentDefinition goes UNAVAILABLE, pls annotate the ComponentDefinition CR to allow the changes. 
    kubectl annotate cmpd <COMPONENT_DEFINITION_NAME> apps.kubeblocks.io/skip-immutable-check=true
  • Option 2 — Upgrade addon and migrate clusters: Upgrade the affected addon, then migrate existing clusters to the new addon version one by one. See Migrate Existing Clusters to a New Addon Version.

Upgrade to v1.0.2

Refer to Upgrade to KubeBlocks v1.0.x.

Full Changelog

You can check the full changelog for additional changes and kubeblocks-addons for addons changes.

© 2026 KUBEBLOCKS INC