This guide provides the information you need to add your baremetal machines to your cluster.
Autopilot only manages the installation of necessary software on bare metal machines and the adding/removing of machines from the cluster. Autopilot does NOT buy nor sell the servers.
Create a baremetalhosts.yaml
file, following the example below:
And apply it to your management cluster.
If the baremetal machines were previously configured to use RAID, you must follow the steps in Wiping baremetal server disks before adding them to your cluster. If you have already added them to your cluster, you will need to remove and reapply the HetznerBareMetalHosts after wiping the disk.
By default, newly purchased machines come with RAID enabled. If you are unsure whether you need RAID or not, we recommend that you disable it.
If you don't have the wwn
of your disk, you can find it by running the following command on the bare metal machine:
As an alternative, you can omit the rootDeviceHints
field from the definition. When you do this, the HetznerBareMetalHost
resource will show an error, and you can copy the WWN from the Status -> Hardware Details -> Storage
section shown when running kubectl describe HetznerBareMetalHost <name>
. Or get it using yq
:
Edit your Cluster resource in the management cluster (or cluster.yaml in your GitOps repository), adding the snippet below to spec.topology.workers.machineDeployments
:
Now, your cluster will request two machines from the baremetal class. Since you have exactly two hosts, all of them will be used. If you want to prioritize specific machines for addition, you can use labels and selectors:
Add a label to your machine:
And use matchLabels
to select it in your Cluster resource, under spec.topology.workers
:
It is recommended to always use matchLabels
in your cluster's machine deployments. If you don't set any matchLabels
, this means any HetznerBareMetalMachine available can get selected to the cluster, even those which have labels.