Sync to the control plane cluster
Read more about how syncing works before deciding which resources to sync from the cluster to the control plane cluster.
vCluster syncs specific Kubernetes resources from the cluster to the control plane cluster. These resources are expected to be created and updated within the cluster. In addition to standard Kubernetes resources, custom resources can also be synced if configured.
Enabled by default​
The following resources are synced by default.
Disabled by default​
The following resources are not synced by default. You can explicitly enable them in your vcluster.yaml configuration.
- CustomResources
- Ingresses
- Gateway API
- NetworkPolicies
- PersistentVolumes
- StorageClasses
- ServiceAccounts
- PodDisruptionBudgets
- PriorityClasses
- Namespaces
Added by the cluster​
When syncing objects from the cluster to the control plane cluster, the cluster adds management labels to the control plane cluster-side objects.
In the default (single-namespace) mode, the following labels are added:
releasevcluster.loft.sh/namespacevcluster.loft.sh/managed-byvcluster.loft.sh/controlled-by
If sync.toHost.namespaces.enabled is true (multi-namespace sync), the cluster does not add the release label. Only the vcluster.loft.sh/* labels are applied.
Bidirectional syncing​
For all resources synced from the cluster to the control plane cluster, metadata.labels and metadata.annotations are synchronized in both directions.
This means changes made in the cluster are reflected in the control plane cluster, and changes made in the control plane cluster are also reflected in the cluster.
Any labels prefixed with vcluster.loft.sh on the control plane cluster resources should not be updated by the user. These labels are managed by the vCluster control plane to track resources and prevent conflicts.
Additional fields that support bidirectional sync​
All metadata.labels and metadata.annotations are bidirectionally synced for resources synced from the cluster to the control plane cluster.
In addition to these fields, vCluster also supports bidirectional syncing for the following resource-specific fields:
| Resource | Fields |
|---|---|
| Pods |
|
| Secrets |
|
| ConfigMaps |
|
| Services |
|
| Ingresses |
|
| Gateway API |
|
| PersistentVolumes |
|
| StorageClass |
|
Config reference​
For every field under sync.toHost, see the sync reference.
You can also browse these settings in the schema explorer (beta), laid out like the YAML you write. Click a field for its type, default, and description. Fold sections and filter to navigate quickly.