What Redis topologies does KubeBlocks support?

KubeBlocks supports three Redis topologies: Standalone (single instance), Replication (primary-replica with Redis Sentinel for automatic failover), and Cluster (native Redis Cluster for horizontal sharding across multiple shards).

How does Redis failover work with KubeBlocks?

KubeBlocks uses Redis Sentinel for automatic failover in the Replication topology. Sentinel monitors the primary and replicas; when the primary becomes unreachable and a quorum of Sentinels agree, a replica is elected as the new primary. KubeBlocks updates the Kubernetes Service endpoints accordingly.

Does KubeBlocks Redis Operator support ACL?

Yes. KubeBlocks supports Redis ACL (Access Control Lists) for user and permission management. ACL rules are managed declaratively via Kubernetes resources and synchronized across all replica set members.

Is the KubeBlocks Redis Operator open source?

Yes. KubeBlocks is fully open source under the Apache 2.0 license at https://github.com/apecloud/kubeblocks. It supports both Redis and Valkey (the open-source Redis fork).

What Redis versions does KubeBlocks support?

KubeBlocks supports Redis 7.0, 7.2, and 8.x. It also supports Valkey 8.x as a Redis-compatible alternative.

Can KubeBlocks scale Redis horizontally?

Yes. In Replication topology, you can add or remove replicas online via an OpsRequest. In Cluster topology, you can add shards for horizontal write scalability. KubeBlocks handles the topology reconfiguration and data rebalancing automatically.

The Production-Grade Redis Operator for Kubernetes | KubeBlocks

Open Source · Production-Grade · CNCF Landscape

KubeBlocks Redis Operator for Kubernetes

Deploy production-grade Redis clusters in minutes. Multi-topology HA, ACL management, backup & restore, and full Day-2 operations — all via a unified Kubernetes API.

Try Playground Free →Read the Docs

3

Supported Topologies

99.99%

HA target

100%

Open Source

Deploy Redis in 3 steps

Install KubeBlocks

# Add Helm repo
helm repo add kubeblocks https://apecloud.github.io/helm-charts
helm repo update

# Install KubeBlocks
helm install kubeblocks kubeblocks/kubeblocks \
  --namespace kb-system --create-namespace

Create a Replication Cluster

apiVersion: apps.kubeblocks.io/v1
kind: Cluster
metadata:
  name: redis-cluster
  namespace: demo
spec:
  terminationPolicy: Delete
  clusterDef: redis
  topology: replication
  componentSpecs:
    - name: redis
      replicas: 2
    - name: redis-sentinel
      replicas: 3

Cluster is Ready

kubectl get cluster redis-cluster -n demo

NAME           CLUSTER-DEFINITION  STATUS   AGE
redis-cluster  redis               Running  2m

Trusted by Engineering Teams at Scale

BONC Cloud

China Mobile Cloud

China Telecom Cloud

Tencent

Xiaomi

Ping An

VIP.com

Kwai

Tiger Brokers

CITIC Securities

SealOS

FastGPT

KubeSphere

Momenta

360

Tilaa

Olares

Changan Automobile

State Grid

BONC Cloud

China Mobile Cloud

China Telecom Cloud

Tencent

Xiaomi

Ping An

VIP.com

Kwai

Tiger Brokers

CITIC Securities

SealOS

FastGPT

KubeSphere

Momenta

360

Tilaa

Olares

Changan Automobile

State Grid

Redis Topologies

Every Redis Topology. One Operator.

From a lightweight standalone instance to a sharded cluster — choose the topology that fits your workload.

A single Redis pod with no replication or Sentinel. Ideal for development, testing, or lightweight workloads that do not require high availability. Each pod gets its own PVC for RDB/AOF durability.

✓

Single pod, minimal Kubernetes resource footprint

✓

Full Redis feature set (all data structures, scripting)

✓

PVC per pod for RDB / AOF durability across restarts

✓

Vertical scaling and volume expansion supported

✓

Fast cold-start — no quorum bootstrap needed

Single Node

Dev / Test

Minimal Resources

Application / Client

Read/Write redis-standalone-redis-redis:6379
「redis-standalone」为示例 cluster 名

RW traffic → single pod

Kubernetes Services

redis-standalone-redis-redis

ClusterIP · :6379
selector: all redis pods (no role filter)
Direct connection to the single Redis instance

ReadWrite

→ redis-0

Redis Pod · Worker Node

redis-0STANDALONE

🔴

redis (Redis Server)

:6379 · standalone mode · accepts all R/W

🔍

[init] dbctl (→ /tools/dbctl)

copies dbctl binary for roleProbe

📊

redis-exporter

:9121 metrics (Prometheus)

💾 PVC data-0 · 20Gi · RDB / AOF data directory

🔗Headless service — stable pod DNS for operator probes and internal use; not a client endpoint

RW Traffic

Persistent Storage

Comparison

How KubeBlocks Compares to Other Redis Operators

Feature	KubeBlocks	Spotahome Operator (archived)	Opstree Operator	Redis Enterprise
Open Source	✓	✓	✓	✗
Sentinel-based HA	✓	✓	✓	✗
Redis Cluster (sharding)	✓	✗	✓	✓
TLS encryption	✓	✗	✓	✓
TLS in-place rotation	✓	✗	~	✓
ACL management	✓	✗	✓	✓
Backup (RDB snapshot)	✓	✗	~	✓
Scheduled backup	✓	✗	✗	✓
Restore from backup	✓	✗	~	✓
Horizontal scaling	✓	✓	✓	✓
Vertical scaling	✓	✓	✓	✓
Volume expansion	✓	✗	✓	✓
Dynamic config	✓	~	~	✓
Planned switchover	✓	✗	✗	~
Minor Upgrade	✓	~	✓	✓
Major Upgrade	✓	✗	~	✓
Standby cluster (cross-k8s DR)	Enterprise	✗	✗	✓
Bootstrap from external Redis	Enterprise	✓	✗	~
Prometheus metrics	✓	✓	✓	✓
Web management UI	Enterprise	✗	✗	✓

✓ = Supported · ~ = Partial / Limited · ✗ = Not supported

Enterpriseindicates a capability available in KubeBlocks Enterprise, not the open-source distribution. Contact us for licensing →

Based on publicly available documentation. Features may vary by version.

Capabilities

Built-in capabilities, declarative on Kubernetes

Backup, failover, scaling, and configuration — describe the desired state in YAML; KubeBlocks reconciles Redis for your chosen topology.

Backup & Restore (RDB Snapshot)

KubeBlocks triggers a BGSAVE on the primary, streams the RDB file to object storage, and restores to a new cluster from any saved snapshot — declarative, no cron scripts.

Scheduled Backups

Snapshot Timeline

Snapshot

00:00

Snapshot

06:00

Snapshot

12:00

Restore Point

17:42

1. Trigger BGSAVEKubeBlocks calls BGSAVE on the primary; Redis forks and writes a point-in-time RDB snapshot to disk

→

2. Upload to Object StorageRDB file streamed to S3 / GCS / OSS with encryption and versioning

→

3. Restore & ReadyNew cluster bootstraps from the RDB snapshot and returns to normal operation with updated endpoints

Day-2 Operations

Every Operation Declared as a Kubernetes Resource

No SSH into pods, no shell scripts. Submit an OpsRequest and KubeBlocks handles the rest.

High Availability & Scaling

✓

Horizontal Scaling

Add or remove replicas online without downtime — KubeBlocks handles topology reconfiguration automatically.

✓

Vertical Scaling

Resize CPU and memory on running instances with a rolling strategy.

✓

Volume Expansion

Expand PVC storage without pod restarts on supported storage classes.

✓

Rolling Restart

Controlled pod restarts with minimal disruption to active connections.

✓

Planned Switchover

Promote a specific replica to primary on demand — via SENTINEL FAILOVER in Sentinel topology.

✓

Stop / Start

Suspend clusters to eliminate compute cost; resume with full state restored.

Configuration, Security & Observability

✓

Dynamic Configuration

Tune Redis parameters via OpsRequest — changes applied without restart where supported.

✓

TLS Encryption

Enable, rotate, or disable in-flight encryption without downtime.

✓

ACL Management

Declarative user and permission management via Kubernetes — synced across all replicas automatically.

✓

Password Management

Rotate credentials stored in Kubernetes Secrets with automatic propagation.

✓

Version Upgrade

Rolling upgrades across Redis minor versions, with cross-major support (e.g., 7 → 8).

✓

Prometheus Metrics

Per-instance metrics via redis-exporter, with pre-built Grafana dashboards.

From the Blog

Go Deeper on Redis on Kubernetes

Redis Operatorization — Ready Yet?

HA, persistence, sharding challenges — and why Redis on Kubernetes is harder than it looks.

Large-Scale Redis Migration from Bare Metal to Kubernetes

How Kuaishou migrated thousands of Redis instances to Kubernetes and improved resource utilisation.

Mastering Redis Network Modes in Kubernetes

Headless Service, HostNetwork, NodePort, LoadBalancer — which network mode fits your Redis deployment.

Get Started

Get Started with KubeBlocks Redis Operator, Risk-Free.

Open source and production-ready. Enterprise customers get dedicated onboarding, migration support, and SLA-backed support.

Try Playground Free →Talk to the Team

✓Open Source

✓Redis & 35+ other engines

✓Production-grade HA

✓No vendor lock-in

# Add Helm repo helm repo add kubeblocks https://apecloud.github.io/helm-charts helm repo update # Install KubeBlocks helm install kubeblocks kubeblocks/kubeblocks \ --namespace kb-system --create-namespace

apiVersion: apps.kubeblocks.io/v1 kind: Cluster metadata: name: redis-cluster namespace: demo spec: terminationPolicy: Delete clusterDef: redis topology: replication componentSpecs: - name: redis replicas: 2 - name: redis-sentinel replicas: 3

Feature

KubeBlocks

Spotahome Operator (archived)

Opstree Operator

Redis Enterprise

Open Source

✓

✗

Sentinel-based HA

✓

✗

Redis Cluster (sharding)

✓

✗

✓

TLS encryption

✓

✗

✓

TLS in-place rotation

✓

✗

✓

ACL management

✓

✗

✓

Backup (RDB snapshot)

✓

✗

✓

Scheduled backup

✓

✗

✓

Restore from backup

✓

✗

✓

Horizontal scaling

✓

Vertical scaling

✓

Volume expansion

✓

✗

✓

Dynamic config

✓

Planned switchover

✓

✗

Minor Upgrade

✓

Major Upgrade

✓

✗

✓

Standby cluster (cross-k8s DR)

Enterprise

✗

✓

Bootstrap from external Redis

Enterprise

✓

✗

Prometheus metrics

✓

Web management UI

Enterprise

✗

✓