Skip to main content
Version: main 🚧

Automatically Provision and Join Nodes

Limited vCluster Tenancy Configuration Support

This feature is only available when using the following worker node types:

  • Private Nodes
  • You can configure vCluster to automatically provision and join worker nodes based on the node and resource requirements. To use auto nodes, you need vCluster Platform installed and vCluster needs to be connected to it.

    The feature is based on Karpenter, which is a cluster autoscaler for Kubernetes that chooses the best node for the requested amount of pods and resources. Karpenter is built into vCluster and does not need to be installed. This allows vCluster to use Karpenter to do the node management and scheduling. The provisioning of the nodes is handled by vCluster Platform.


    vCluster provides multiple node providers to automatically create worker nodes:

    • Terraform
    • KubeVirt
    • Nvidia Base Command Manager

    Install vCluster Platform​

    vCluster needs to be connected to a running vCluster Platform to enable configuring for nodes to automatically provision based on resource needs.

    Follow our guide on installing vCluster Platform.

    Create a node provider​

    After vCluster Platform is installed, a node provider needs to be created in order for virtual clusters to reference in the vcluster.yaml configuration.

    Read more about node providers and create one.

    Create a vCluster​

    Now that vCluster Platform is created with a node provider, you can start creating virtual clusters that are configured with to have automatic nodes join. The virtual clusters must either be created through the vCluster Platform or connected to the vCluster Platform using an API key.

    Read through the auto nodes configuration details to learn about how to configure your node pools and how to define which nodes from the node provider should be configured.