vMetal
vMetal adds bare metal provisioning to the vCluster Platform. It uses Metal3 and Ironic to manage physical servers through BMC, and provisions them as nodes for tenant clusters via PXE boot and cloud-init.
info
vMetal does not require a hypervisor. Physical servers are enrolled as BareMetalHost resources. Metal3 inspects each server and provisions it with an OS image through Ironic.
Click to enlarge
What vMetal provides
- Pooled bare metal capacity — NodeTypes group servers by hardware profile (GPU model, CPU count, rack location). The platform claims and returns servers automatically as tenant cluster demand changes.
- GPU and accelerator workloads — Direct hardware access with no virtualization. Workloads see GPUs, FPGAs, and other accelerators natively.
- Automated provisioning pipeline — Register a server as a
BareMetalHost. Metal3 handles BMC verification, hardware inspection, PXE boot, OS installation, and cloud-init automatically. - Automatic node registration — Provisioned servers join tenant clusters on their own. No manual
kubeadmjoin or agent installation required. - Server lifecycle management — When a server is no longer needed, vMetal cleans it, releases its IP, and returns it to the available pool for reuse.
- Tenant isolation — Combine with vCluster and vNode for tenant isolation and secure runtime isolation on shared hardware.
Where to start
| If you want to... | Go to |
|---|---|
| Set up your first bare metal server | Install |
| Understand the provisioning architecture | Architecture |
| Understand GPU passthrough, vGPU, and MIG boundaries | GPU presentation modes |
| Provision GPU servers for AI workloads | GPU Quickstart |
| Configure a NodeProvider and node types | Configuration |