Skip to main content
Version: v0.38 Stable

What's new in vCluster v0.38

vCluster v0.38 makes control planes more reliable to run and pairs with vCluster Platform v5.0, which adds Tenants and a shared machine inventory. This page covers the main changes. For the full list, see the vCluster v0.38 release notes.

Serve customers on dedicated machines​

With Platform v5.0, a provider gives each customer a Tenant and grants it dedicated machines. Clusters in that Tenant use Auto Nodes to draw private nodes from those machines. Node pools that an administrator defines in the platform now run through Auto Nodes alongside the pools in vcluster.yaml. In v0.38, Auto Nodes also replaces node claims that never joined when a pool's configuration changes, and removes nodes whose machine is gone.

Start control planes reliably​

Embedded etcd defragments on startup only when it can reclaim space, and you can set how long defragmentation may take with defragTimeout. Both also shipped in v0.37.7. Restoring a snapshot of an embedded database keeps the store revision moving forward, a fix that also shipped in v0.37.5. The syncer keeps unsynced changes when a sync fails part way.

Stay patched and enforce policy​

The default Kubernetes version is 1.36.6, the same as v0.37.5. Rebuilt Kubernetes images include upstream security fixes.

The resource proxy enforces the cluster's validating admission policies and webhooks on proxied resources. The policies that guard the cluster also guard what the proxy writes.

Run locally on Podman​

The Docker driver works with Podman through its Docker-compatible API, so you can run a cluster on a machine that runs Podman instead of the Docker daemon. You still need the docker CLI.

Target clusters from Argo CD​

integrations.argoCD.cluster.metadata adds your own labels and annotations to the cluster's Argo CD registration, so ApplicationSet cluster generators can select it. This key also shipped in v0.37.4.

Availability​

Some of these changes need a vCluster license or vCluster Platform v5.0.

ChangeRequires
Platform node pools, Auto Nodes changesvCluster Platform v5.0
defragTimeout, startup defragmentation changesEmbedded etcd, which needs the Free tier or higher, or vCluster Standalone
Admission checks on proxied resourcesvCluster Platform, because the resource proxy is a Platform feature
Argo CD cluster metadatavCluster Platform with the Argo CD integration
Observability integrationvCluster Platform v5.0 with an observability connector
Kubernetes 1.36.6, PodmanAvailable in every edition

Limited availability​

vCluster v0.38 is a limited availability release, recommended only for new deployments. Keep existing clusters on vCluster v0.37 and Platform v4.12, the current LTS releases. For upgrade guidance, contact vCluster Labs.

vCluster v0.38 deprecates the Istio integration. See the deprecations and changes in the vCluster v0.38 release notes.