feat: support setting Nutanix project on machines

api/v1alpha1/nutanix_node_types.go

@@ -62,6 +62,11 @@ type NutanixMachineDetails struct {
 	// systemDiskSize is size (in Quantity format) of the system disk of the VM
 	// The minimum systemDiskSize is 20Gi bytes
 	SystemDiskSize resource.Quantity `json:"systemDiskSize"`
+
+	// add the virtual machines to the project defined in Prism Central.
+	// The project must already be present in the Prism Central.
+	// +optional
+	Project *NutanixResourceIdentifier `json:"project,omitempty"`
 }
 
 func (NutanixMachineDetails) VariableSchema() clusterv1.VariableSchema {
@@ -112,6 +117,10 @@ func (NutanixMachineDetails) VariableSchema() clusterv1.VariableSchema {
 					Description: "systemDiskSize is size (in Quantity format) of the system disk of the VM eg. 20Gi",
 					Type:        "string",
 				},
+				"project": NutanixResourceIdentifier{}.VariableSchemaFromDescription(
+					//nolint:lll // Long description.
+					"add the virtual machines to the project defined in Prism Central. The project must already be present in the Prism Central.",
+				).OpenAPIV3Schema,
 			},
 			Required: []string{
 				"vcpusPerSocket",

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

@@ -6,7 +6,7 @@ Configure Machine Details of Control plane and Worker nodes
 
 ## Examples
 
-### Set Machine details of Control Plane and Worker nodes
+### (Required) Set Machine details for Control Plane and Worker nodes
 
 ```yaml
 apiVersion: cluster.x-k8s.io/v1beta1
@@ -119,3 +119,121 @@ spec:
       vcpuSockets: 2
       vcpusPerSocket: 1
 ```
+
+### (Optional) Set Additional Categories for Control Plane and Worker nodes
+
+```yaml
+apiVersion: cluster.x-k8s.io/v1beta1
+kind: Cluster
+metadata:
+  name: <NAME>
+spec:
+  topology:
+    variables:
+      - name: clusterConfig
+        value:
+          controlPlane:
+            nutanix:
+              machineDetails:
+                additionalCategories:
+                - key: example-key
+                  value: example-value
+      - name: workerConfig
+        value:
+          nutanix:
+            machineDetails:
+              additionalCategories:
+              - key: example-key
+                value: example-value
+```
+
+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:
+      additionalCategories:
+      - key: example-key
+        value: example-value
+```
+
+- worker `NutanixMachineTemplate`:
+
+```yaml
+apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
+kind: NutanixMachineTemplate
+metadata:
+  name: nutanix-quick-start-md-nmt
+spec:
+  template:
+    spec:
+      additionalCategories:
+      - key: example-key
+        value: example-value
+```
+
+### (Optional) Set Project for Control Plane and Worker nodes
+
+```yaml
+apiVersion: cluster.x-k8s.io/v1beta1
+kind: Cluster
+metadata:
+  name: <NAME>
+spec:
+  topology:
+    variables:
+      - name: clusterConfig
+        value:
+          controlPlane:
+            nutanix:
+              machineDetails:
+                project:
+                  type: name
+                  name: project-name
+      - name: workerConfig
+        value:
+          nutanix:
+            machineDetails:
+              project:
+                type: name
+                name: project-name
+```
+
+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:
+      project:
+        type: name
+        name: project-name
+```
+
+- worker `NutanixMachineTemplate`:
+
+```yaml
+apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
+kind: NutanixMachineTemplate
+metadata:
+  name: nutanix-quick-start-md-nmt
+spec:
+  template:
+    spec:
+      project:
+        type: name
+        name: project-name
+```

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

@@ -8,6 +8,7 @@ import (
 
 	apiextensionsv1 "k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1"
 	"k8s.io/apimachinery/pkg/apis/meta/v1/unstructured"
+	"k8s.io/utils/ptr"
 	clusterv1 "sigs.k8s.io/cluster-api/api/v1beta1"
 	runtimehooksv1 "sigs.k8s.io/cluster-api/exp/runtime/hooks/api/v1alpha1"
 	ctrl "sigs.k8s.io/controller-runtime"
@@ -116,6 +117,10 @@ func (h *nutanixMachineDetailsPatchHandler) Mutate(
 				spec.AdditionalCategories[i] = capxv1.NutanixCategoryIdentifier(category)
 			}
 
+			if nutanixMachineDetailsVar.Project != nil {
+				spec.Project = ptr.To(capxv1.NutanixResourceIdentifier(*nutanixMachineDetailsVar.Project))
+			}
+
 			obj.Spec.Template.Spec = spec
 			return nil
 		},

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

@@ -51,6 +51,10 @@ var (
 				Value: "fake-value2",
 			},
 		},
+		Project: ptr.To(v1alpha1.NutanixResourceIdentifier{
+			Type: capxv1.NutanixIdentifierName,
+			Name: ptr.To("fake-project"),
+		}),
 	}
 
 	matchersForAllFieldsSet = []capitest.JSONPatchMatcher{
@@ -118,6 +122,14 @@ var (
 				),
 			),
 		},
+		{
+			Operation: "add",
+			Path:      "/spec/template/spec/project",
+			ValueMatcher: gomega.SatisfyAll(
+				gomega.HaveKeyWithValue("type", "name"),
+				gomega.HaveKeyWithValue("name", "fake-project"),
+			),
+		},
 	}
 )