Machine onboarding

The goal of the Machine Onboarding service is to register a new machine in the SUSE® Rancher Prime OS Manager Operator catalog (MachineInventory resources) and provision the host with the OS, applying the desired configuration.

The Machine Onboarding involves the following steps:

  • The user creates a MachineRegistration resource: the MachineRegistration includes the configuration required for the OS installation. As soon as the MachineRegistration is created, the SUSE® Rancher Prime OS Manager Operator exposes an HTTP registration endpoint: it is the entrypoint required by the onboarding hosts to register to the operator.

  • The user requests a self-installing image via a SeedImage resource: it only requires a reference to a MachineRegistration resource and to an OS container image compatible with the SUSE® Rancher Prime OS Manager Toolkit. As soon as the SeedImage is created, the SUSE® Rancher Prime OS Manager Operator triggers the build process of the self-installing image: once completed, the URL is exposed in the status.downloadURL field of the SeedImage resource.

  • The user downloads the self-installing image and uses it to boot an unprovisioned host: the host authenticates to the registration endpoint of the SUSE® Rancher Prime OS Manager Operator, gets the full configuration stored in the MachineRegistration and installs the OS on the local storage device. As soon as the host has completed the registration process, the SUSE® Rancher Prime OS Manager Operator creates a unique MachineInventory resource tracking the host. The self-installing image can be used to onboard any number of hosts.