KubeBlocks
BlogsEnterprise
⌘K
​
Blogs

Overview
Quickstart
Architecture

Operations

Lifecycle Management
Vertical Scaling
Horizontal Scaling
Volume Expansion
Switchover
Minor Version Upgrade
Manage Services

Backup & Restore

Backup
Restore

Observability

Observability for etcd Clusters
  1. Key Features
    1. Lifecycle Management
    2. Backup and Restore
    3. TLS Support
    4. Supported Versions

Overview of KubeBlocks etcd Addon

etcd is a strongly consistent, distributed key-value store that provides reliable storage for distributed systems. It is the primary data store for Kubernetes itself and is widely used as a coordination backbone for distributed applications.

Key characteristics of etcd:

  • Raft consensus for strong consistency across the cluster
  • MVCC (Multi-Version Concurrency Control) for transactional reads and writes
  • Watch API for real-time notification of key changes
  • TLS encryption for secure peer and client communication

The KubeBlocks etcd Addon provides a complete solution for deploying and managing etcd clusters in Kubernetes environments. Key features include:

  • Raft-based deployment with leader/follower topology
  • Comprehensive lifecycle management
  • Reliable backup and restore operations
  • Support for TLS-encrypted clusters
  • Support for multiple etcd versions

Key Features

Lifecycle Management

KubeBlocks simplifies etcd operations with comprehensive lifecycle management:

FeatureDescription
Horizontal ScalingScale cluster members in/out (see known limitation)
Vertical ScalingAdjust CPU/memory resources for etcd instances
Volume ExpansionDynamically increase storage capacity without downtime
Restart OperationsControlled cluster restarts with minimal disruption
Start/StopTemporarily suspend/resume cluster operations
SwitchoverTransfer leadership to a specific member
MonitoringIntegrated Prometheus metrics collection via built-in exporter

Backup and Restore

KubeBlocks supports backup and restore for etcd using etcdctl snapshot save:

Backup TypeMethodDescription
Full BackupdatafileSaves an etcd snapshot to a backup repository using etcdctl

TLS Support

KubeBlocks can automatically provision TLS certificates (via cert-manager) for both peer-to-peer and client-to-server communication by setting tls: true in the Cluster spec.

Supported Versions

KubeBlocks etcd Addon supports these versions:

Major VersionSupported Minor Versions
etcd 33.5.6, 3.5.15, 3.6.1
NOTE

etcd does not support downgrading between minor versions. Data written by a newer version (e.g. 3.6.x) cannot be read by an older version (e.g. 3.5.x) due to storage format changes.

The list of supported versions can be found by running:

kubectl get componentversion etcd

© 2026 KUBEBLOCKS INC