feat: adds image tempalte to nutanix

Author: faiq

api/v1alpha1/nutanix_node_types.go

@@ -13,6 +13,7 @@ type NutanixNodeSpec struct {
 	MachineDetails NutanixMachineDetails `json:"machineDetails"`
 }
 
+// +kubebuilder:validation:XValidation:rule="has(self.image) != has(self.imageLookup)",message="Either 'image' or 'imageLookup' must be set, but not both"
 type NutanixMachineDetails struct {
 	// vcpusPerSocket is the number of vCPUs per socket of the VM
 	// +kubebuilder:validation:Required
@@ -28,8 +29,14 @@ type NutanixMachineDetails struct {
 
 	// image identifies the image uploaded to Prism Central (PC). The identifier
 	// (uuid or name) can be obtained from the console or API.
-	// +kubebuilder:validation:Required
-	Image capxv1.NutanixResourceIdentifier `json:"image"`
+	// +kubebuilder:validation:Optional
+	// +optional
+	Image *capxv1.NutanixResourceIdentifier `json:"image,omitempty"`
+
+	// imageLookup is a container that holds how to look up vm images for the cluster.
+	// +kubebuilder:validation:Optional
+	// +optional
+	ImageLookup *capxv1.NutanixImageLookup `json:"imageLookup,omitempty"`
 
 	// cluster identifies the Prism Element in which the machine will be created.
 	// The identifier (uuid or name) can be obtained from the console or API.

docs/content/customization/nutanix/machine-details.md

@@ -111,6 +111,59 @@ spec:
       vcpusPerSocket: 1
 ```
 
+### (Optional) Use Image template
+
+```yaml
+apiVersion: cluster.x-k8s.io/v1beta1
+kind: Cluster
+metadata:
+  name: <NAME>
+spec:
+  topology:
+    variables:
+      - name: clusterConfig
+        value:
+          controlPlane:
+            nutanix:
+              machineDetails:
+                bootType: legacy
+                cluster:
+                  name: pe-cluster-name
+                  type: name
+                imageLookup:
+                  baseOS: "rockylinux-9"
+                  format: {{.BaseOS}}-kube-v{{.K8sVersion}}.*
+```
+
+Applying this configuration will result in the following value being set:
+
+- control-plane `NutanixMachineTemplate`:
+
+```yaml
+apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
+kind: NutanixMachineTemplate
+metadata:
+  name: nutanix-quick-start-cp-nmt
+spec:
+  template:
+    spec:
+      bootType: legacy
+      cluster:
+        name: pe-cluster-name
+        type: name
+      imageLookup:
+        baseOS: "rockylinux-9"
+        format: {{.BaseOS}}-kube-v{{.K8sVersion}}.*
+      memorySize: 4Gi
+      providerID: nutanix://vm-uuid
+      subnet:
+      - name: subnet-name
+        type: name
+      systemDiskSize: 40Gi
+      vcpuSockets: 2
+      vcpusPerSocket: 1
+```
+
 ### (Optional) Set Additional Categories for Control Plane and Worker nodes
 
 ```yaml

pkg/handlers/nutanix/mutation/machinedetails/inject.go

@@ -94,7 +94,11 @@ func (h *nutanixMachineDetailsPatchHandler) Mutate(
 
 			spec.BootType = nutanixMachineDetailsVar.BootType
 			spec.Cluster = nutanixMachineDetailsVar.Cluster
-			spec.Image = nutanixMachineDetailsVar.Image
+			if nutanixMachineDetailsVar.Image != nil {
+				spec.Image = nutanixMachineDetailsVar.Image
+			} else if nutanixMachineDetailsVar.ImageLookup != nil {
+				spec.ImageLookup = nutanixMachineDetailsVar.ImageLookup
+			}
 
 			spec.VCPUSockets = nutanixMachineDetailsVar.VCPUSockets
 			spec.VCPUsPerSocket = nutanixMachineDetailsVar.VCPUsPerSocket