Backing store
Each cluster requires a backing store and vClustervClusterAn open-source software product that creates and manages clusters within Kubernetes infrastructure. vCluster provides tenant isolation capabilities while reducing infrastructure costs. provides two different types of backing store options:
There are different ways to deploy the type of backing store.
By default, vCluster uses an embedded SQLite database as the backing store. This option is great for smaller sandbox clusters, but for production, it's recommended to use a different backing store option.
vCluster doesn't support changing the backing store type after initial deployment by editing configuration in place. A cluster that already runs on deployed etcd also has no snapshot or restore support for backing itself up or recovering in place, so choose a backing store type before you deploy to production.
Two exceptions exist:
- Migration from deployed etcd to embedded etcd. Both modes use etcd as the backing store technology.
- Restoring an embedded etcd snapshot onto a clusterClusterA fully isolated Kubernetes environment provisioned for a single tenant. Each cluster has its own API server, controller manager, and resource namespace, backed by a virtualized control plane hosted on a control plane cluster. From the tenant's perspective it behaves exactly like a standard Kubernetes cluster. configured with an embedded database, external database, or deployed etcd backing store. vCluster converts the snapshot automatically before restoring it. See Migrate from embedded etcd to a different backing store.
Migrating in other directions, such as from a database backing store to etcdetcdA distributed key-value store that provides reliable storage for Kubernetes cluster data. In vCluster, etcd can be deployed externally or embedded within the vCluster pod., isn't documented or tested.
vCluster Standalone has limited backing store options. For single control planeControl PlaneThe container orchestration layer that exposes the API and interfaces to define, deploy, and manage the lifecycle of containers. In vCluster, each cluster has its own control plane components. nodes setup,
- Embedded database (sqlite)
- Embedded etcd
are supported.
For multiple control plane nodes (HA) setup,
- Embedded etcd
is supported.
Config reference​
For every field under controlPlane.backingStore, see the controlPlane reference.