feat: support use of pxeurls in machine provisioning

This PR will add a new field to packetmachine that allows for the
passing of a pxe url string. If present, we check that the OS is also
set to "custom_ipxe" so that we can fail early.

Signed-off-by: Spencer Smith <robertspencersmith@gmail.com>

Author: rsmitty

api/v1alpha3/packetmachine_types.go

@@ -38,6 +38,11 @@ type PacketMachineSpec struct {
 	MachineType  string   `json:"machineType"`
 	SshKeys      []string `json:"sshKeys,omitempty"`
 
+	// IPXEUrl can be used to set the pxe boot url when using custom OSes with this provider.
+	// Note that OS should also be set to "custom_ipxe" if using this value.
+	// +optional
+	IPXEUrl string `json:"ipxeURL,omitempty"`
+
 	// HardwareReservationID is the unique device hardware reservation ID or `next-available` to
 	// automatically let the Packet api determine one.
 	// +optional

config/resources/crd/bases/infrastructure.cluster.x-k8s.io_packetmachines.yaml

@@ -68,6 +68,11 @@ spec:
                 ID or `next-available` to automatically let the Packet api determine
                 one.
               type: string
+            ipxeURL:
+              description: IPXEUrl can be used to set the pxe boot url when using
+                custom OSes with this provider. Note that OS should also be set to
+                "custom_ipxe" if using this value.
+              type: string
             machineType:
               type: string
             providerID:

config/resources/crd/bases/infrastructure.cluster.x-k8s.io_packetmachinetemplates.yaml

@@ -54,6 +54,11 @@ spec:
                         reservation ID or `next-available` to automatically let the
                         Packet api determine one.
                       type: string
+                    ipxeURL:
+                      description: IPXEUrl can be used to set the pxe boot url when
+                        using custom OSes with this provider. Note that OS should
+                        also be set to "custom_ipxe" if using this value.
+                      type: string
                     machineType:
                       type: string
                     providerID:

pkg/cloud/packet/client.go

@@ -34,6 +34,7 @@ import (
 const (
 	apiTokenVarName = "PACKET_API_KEY"
 	clientName      = "CAPP-v1alpha3"
+	pxeOS           = "custom_ipxe"
 )
 
 var ErrControlPlanEndpointNotFound = errors.New("contorl plane not found")
@@ -104,6 +105,15 @@ func (p *PacketClient) NewDevice(machineScope *scope.MachineScope, extraTags []s
 		UserData:              userData,
 	}
 
+	// Update server options to pass pxe url if specified
+	if machineScope.PacketMachine.Spec.IPXEUrl != "" {
+		// Error if pxe url and OS conflict
+		if machineScope.PacketMachine.Spec.OS != pxeOS {
+			return nil, fmt.Errorf("os should be set to custom_pxe when using pxe urls")
+		}
+		serverCreateOpts.IPXEScriptURL = machineScope.PacketMachine.Spec.IPXEUrl
+	}
+
 	dev, _, err := p.Client.Devices.Create(serverCreateOpts)
 	return dev, err
 }