Automatically provision and join nodes
privateNodes.autoNodes is deprecatedprivateNodes.autoNodes in vcluster.yaml is deprecated in vCluster v0.38. It still works, and
no removal date is set. For new clusters, use node pools
instead. A node pool is a platform resource that holds the provider, node types, and network for
a set of a cluster's private nodes. Control plane auto nodes (controlPlane.standalone.autoNodes)
aren't deprecated.
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 Platform provides node providers for the systems that supply worker nodes, such as:
- Metal3, for bare metal servers you provision directly
- NVIDIA Infra Controller (NICo)
- KubeVirt, for virtual machines
- Terraform, for cloud VMs and anything else a Terraform provider can create
Install vCluster Platform​
vClustervClusterAn open-source software product that creates and manages clusters within Kubernetes infrastructure. vCluster provides tenant isolation capabilities while reducing infrastructure costs. needs to be connected to a running vCluster Platform to enable configuring for nodes to automatically provision based on resource needs.
Refer to the vCluster Platform installation guide.
Create a node provider​
After vCluster Platform is installed, a node provider needs to be created in order for clusters
to reference in the vcluster.yaml configuration.
Read more about node providers and create one.
For the infrastructure side, including registering servers, designing node types, and verifying that provisioned servers joined, see Cluster nodes.
Create a vCluster​
Now that the platform is installed with a node provider, you can start creating clusters that are configured to have automatic nodes join. The clusters must either be created through the platform or connected to the 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.