Handle ISO url properly:

api/v1beta1/tinkerbellmachine_types.go

@@ -88,11 +88,19 @@ type BootOptions struct {
 	// When this field is set, the controller will create a job.bmc.tinkerbell.org object
 	// for getting the associated hardware into a CDROM booting state.
 	// A HardwareRef that contains a spec.BmcRef must be provided.
+	//
+	// The format of the ISOURL must be http://$IP:$Port/iso/:macAddress/hook.iso
+	// The name of the ISO file must have the .iso extension, but the name can be anything.
+	// The $IP and $Port should generally point to the IP and Port of the Smee server
+	// as this is where the ISO patching endpoint lives.
+	// The ":macAddress" is a placeholder for the MAC address of the hardware and
+	// should be provided exactly as is: ":macAddress".
 	// +optional
 	// +kubebuilder:validation:Format=url
 	ISOURL string `json:"isoURL,omitempty"`
 
 	// BootMode is the type of booting that will be done.
+	// Must be one of "none", "netboot", or "iso".
 	// +optional
 	// +kubebuilder:validation:Enum=none;netboot;iso
 	BootMode BootMode `json:"bootMode,omitempty"`

config/crd/bases/infrastructure.cluster.x-k8s.io_tinkerbellmachines.yaml

@@ -66,7 +66,9 @@ spec:
                 description: BootOptions are options that control the booting of Hardware.
                 properties:
                   bootMode:
-                    description: BootMode is the type of booting that will be done.
+                    description: |-
+                      BootMode is the type of booting that will be done.
+                      Must be one of "none", "netboot", or "iso".
                     enum:
                     - none
                     - netboot
@@ -78,6 +80,13 @@ spec:
                       When this field is set, the controller will create a job.bmc.tinkerbell.org object
                       for getting the associated hardware into a CDROM booting state.
                       A HardwareRef that contains a spec.BmcRef must be provided.
+
+                      The format of the ISOURL must be http://$IP:$Port/iso/:macAddress/hook.iso
+                      The name of the ISO file must have the .iso extension, but the name can be anything.
+                      The $IP and $Port should generally point to the IP and Port of the Smee server
+                      as this is where the ISO patching endpoint lives.
+                      The ":macAddress" is a placeholder for the MAC address of the hardware and
+                      should be provided exactly as is: ":macAddress".
                     format: url
                     type: string
                 type: object

config/crd/bases/infrastructure.cluster.x-k8s.io_tinkerbellmachinetemplates.yaml

@@ -56,8 +56,9 @@ spec:
                           of Hardware.
                         properties:
                           bootMode:
-                            description: BootMode is the type of booting that will
-                              be done.
+                            description: |-
+                              BootMode is the type of booting that will be done.
+                              Must be one of "none", "netboot", or "iso".
                             enum:
                             - none
                             - netboot
@@ -69,6 +70,13 @@ spec:
                               When this field is set, the controller will create a job.bmc.tinkerbell.org object
                               for getting the associated hardware into a CDROM booting state.
                               A HardwareRef that contains a spec.BmcRef must be provided.
+
+                              The format of the ISOURL must be http://$IP:$Port/iso/:macAddress/hook.iso
+                              The name of the ISO file must have the .iso extension, but the name can be anything.
+                              The $IP and $Port should generally point to the IP and Port of the Smee server
+                              as this is where the ISO patching endpoint lives.
+                              The ":macAddress" is a placeholder for the MAC address of the hardware and
+                              should be provided exactly as is: ":macAddress".
                             format: url
                             type: string
                         type: object

controller/machine/workflow.go

@@ -3,6 +3,8 @@ package machine
 import (
 	"errors"
 	"fmt"
+	"net/url"
+	"strings"
 
 	"github.com/tinkerbell/cluster-api-provider-tinkerbell/api/v1beta1"
 
@@ -75,8 +77,14 @@ func (scope *machineReconcileScope) createWorkflow(hw *tinkv1.Hardware) error {
 				return errISOBootURLRequired
 			}
 
+			u, err := url.Parse(scope.tinkerbellMachine.Spec.BootOptions.ISOURL)
+			if err != nil {
+				return fmt.Errorf("boot option isoURL is not parse-able: %w", err)
+			}
+
+			u.Path = strings.Replace(u.Path, ":macAddress", strings.Replace(hw.Spec.Metadata.Instance.ID, ":", "-", 5), 1)
+			workflow.Spec.BootOptions.ISOURL = u.String()
 			workflow.Spec.BootOptions.BootMode = tinkv1.BootMode("iso")
-			workflow.Spec.BootOptions.ISOURL = scope.tinkerbellMachine.Spec.BootOptions.ISOURL
 		}
 	}