Bare Metal Provider APIs

The Bare Metal Infrastructure Provider builds on elemental-operator and Cluster API. Operators interact with two CRD groups, both documented here:

infrastructure.cluster.x-k8s.io/v1beta1 — the provider's own resources.
elemental.cattle.io/v1beta1 — owned by elemental-operator; the provider only reads and annotates them, but operators must author the registration/seed objects and inspect inventory objects on every workflow.

Custom Resources

Resource	Description	Documentation
`BaremetalCluster`	Cluster-level infrastructure: control-plane VIP, endpoint, network type.	BaremetalCluster
`BaremetalMachine`	Single infra machine bound to one `MachineInventory`.	BaremetalMachine
`BaremetalMachineTemplate`	Template that binds a pool to a `KubeadmControlPlane` or `MachineDeployment`.	BaremetalMachineTemplate
`MachineInventoryPool`	Allowed set of `MachineInventory` names for a cluster.	MachineInventoryPool

Resource	Description	Documentation
`MachineRegistration`	Registration URL + first-install cloud-config. Authored once per cluster.	MachineRegistration
`SeedImage`	Triggers ISO build with the registration baked in.	SeedImage
`MachineInventory`	Long-lived host identity; consumed by `MachineInventoryPool`. The provider also reads `spec.observedNetwork` (Alauda-fork-only) and writes the `baremetal.alauda.io/*` annotations.	MachineInventory

The provider also composes the following upstream resources without changing their schemas. Refer to the Cluster API reference for full schemas.

Resource	API group	Purpose
`Cluster`	`cluster.x-k8s.io/v1beta1`	Top-level CAPI resource; carries the bare-metal-specific `cpaas.io/*` annotations.
`KubeadmControlPlane`	`controlplane.cluster.x-k8s.io/v1beta1`	Owns control-plane `Machine` lifecycle and kubeadm config.
`MachineDeployment`	`cluster.x-k8s.io/v1beta1`	Owns worker `Machine` lifecycle.
`KubeadmConfigTemplate`	`bootstrap.cluster.x-k8s.io/v1beta1`	Worker cloud-init `user-data` template.