Hardware Labels

When a node is registered, hardware data is collected and made available to the MachineRegistration in the same way as SMBIOS data.

This data can be used for easy identification and selection via a MachineSelector.

The following are available for templating:

Label	Description
${System Data/Runtime/Hostname}	The hostname of the node (at registration time)
${System Data/Memory/Total Physical Bytes}	The total RAM memory in the node, expressed in bytes
${System Data/CPU/Total Cores}	Total CPU cores
${System Data/CPU/Total Threads}	Total CPU threads
${System Data/CPU/Vendor}	CPU vendor
${System Data/CPU/Model}	CPU model
${System Data/GPU/Vendor}	GPU vendor (Only available if the node has an identifiable GPU)
${System Data/GPU/Model}	GPU model (Only available if the node has an identifiable GPU)
${System Data/Network/Number Interfaces}	Number of network interfaces in the system
${System Data/Network/{Iface name}/Name}	Network interface name
${System Data/Network/{Iface name}/IsVirtual}	Boolean indicating virtual network interface
${System Data/Block Devices/Number Devices}	Number of block devices in the system (includes DVD and USB drives)
${System Data/Block Devices/{Disk name}/Name}	Device name of the block device (i.e. sda, sr0, vda, etc...)
${System Data/Block Devices/{Disk name}/Removable}	Whether this block device is removable (i.e. DVD)
${System Data/Block Devices/{Disk name}/Size}	Total space in this block device, expressed in bytes
${System Data/Block Devices/{Disk name}/Drive Type}	Drive type of this block device, see table below
${System Data/Block Devices/{Disk name}/Storage Controller}	Controller type for this block device connection, see table below

info

On both Block Devices and Network the device name is used as a sub-block, as there could be more than one device.

Block device drive types

Type	Description
HDD	Hard disk drive
FDD	Floppy disk drive
ODD	Optical disk drive
SSD	Solid-state drive
virtual	virtual drive i.e. loop devices
Unknown	unknown drive type

Block device controller types

Type	Description
IDE	Integrated Drive Electronics
SCSI	Small computer system interface
NVMe	Non-volatile Memory Express
MMC	Multi-media controller (used for mobile phone storage devices)
virtio	Virtualized storage controller/driver
loop	loop device
Unknown	unknown controller type

Example MachineRegistration

registration example with smbios labels

apiVersion: elemental.cattle.io/v1beta1
kind: MachineRegistration
metadata:
  name: my-nodes
  namespace: fleet-default
spec:
  machineName: "${Runtime/Hostname}"
  config:
    cloud-config:
      users:
        - name: root
          passwd: root
    elemental:
      install:
        reboot: true
        device: /dev/sda
        debug: true
  machineInventoryLabels:
    elemental.cattle.io/CpuTotalCores: "${CPU/TotalCores}"
    elemental.cattle.io/CpuTotalThreads: "${CPU/TotalThreads}"
    elemental.cattle.io/TotalMemoryBytes: "${Memory/TotalPhysicalBytes}"
    elemental.cattle.io/NumDisks: "${Storage/TotalDisks}"