feat: support setting Nutanix project on machines

Author: dkoshkin

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",

api/v1alpha1/zz_generated.deepcopy.go

@@ -29,6 +29,9 @@ spec:
                   name: os-image-name
                   type: name
                 memorySize: 4Gi
+                project:
+                  type: name
+                  name: project-name
                 subnets:
                 - name: subnet-name
                   type: name
@@ -47,6 +50,9 @@ spec:
                 name: os-image-name
                 type: name
               memorySize: 4Gi
+              project:
+                type: name
+                name: project-name
               subnets:
               - name: subnet-name
                 type: name
@@ -78,6 +84,9 @@ spec:
         name: os-image-name
         type: name
       memorySize: 4Gi
+      project:
+        type: name
+        name: project-name
       providerID: nutanix://vm-uuid
       subnet:
       - name: subnet-name
@@ -108,6 +117,9 @@ spec:
         name: os-image-name
         type: name
       memorySize: 4Gi
+      project:
+        type: name
+        name: project-name
       providerID: nutanix://vm-uuid
       subnet:
       - name: subnet-name

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

@@ -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.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"),
+			),
+		},
 	}
 )
 

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

@@ -19,6 +19,10 @@ import (
 func TestVariableValidation(t *testing.T) {
 	testImageName := "fake-image"
 	testPEClusterName := "fake-pe-cluster"
+	testProject := ptr.To(v1alpha1.NutanixResourceIdentifier{
+		Type: capxv1.NutanixIdentifierName,
+		Name: ptr.To("fake-project"),
+	})
 	capitest.ValidateDiscoverVariables(
 		t,
 		clusterconfig.MetaVariableName,
@@ -43,6 +47,7 @@ func TestVariableValidation(t *testing.T) {
 								Name: &testPEClusterName,
 							},
 							MemorySize:     resource.MustParse("8Gi"),
+							Project:        testProject,
 							SystemDiskSize: resource.MustParse("40Gi"),
 							Subnets:        []v1alpha1.NutanixResourceIdentifier{},
 							AdditionalCategories: []v1alpha1.NutanixCategoryIdentifier{