feat: adds GPU mutation (#591)

**What problem does this PR solve?**:

**Which issue(s) this PR fixes**:
Addresses: https://jira.nutanix.com/browse/D2IQ-100465

**How Has This Been Tested?**:
<!--
Please describe the tests that you ran to verify your changes.
Provide output from the tests and any manual steps needed to replicate
the tests.
-->

This hasn't been tested yet. I am planning on doing this soon. 

**Special notes for your reviewer**:
<!--
Use this to provide any additional information to the reviewers.
This may include:
- Best way to review the PR.
- Where the author wants the most review attention on.
- etc.
-->

Author: faiq

api/v1alpha1/crds/caren.nutanix.com_nutanixclusterconfigs.yaml

@@ -270,6 +270,29 @@ spec:
                             required:
                             - type
                             type: object
+                          gpus:
+                            description: List of GPU devices that need to be added
+                              to the machines.
+                            items:
+                              properties:
+                                deviceID:
+                                  description: deviceID is the id of the GPU entity.
+                                  format: int64
+                                  type: integer
+                                name:
+                                  description: name is the GPU name
+                                  type: string
+                                type:
+                                  description: Type is the identifier type to use
+                                    for this resource.
+                                  enum:
+                                  - deviceID
+                                  - name
+                                  type: string
+                              required:
+                              - type
+                              type: object
+                            type: array
                           image:
                             description: |-
                               image identifies the image uploaded to Prism Central (PC). The identifier

api/v1alpha1/crds/caren.nutanix.com_nutanixnodeconfigs.yaml

@@ -88,6 +88,29 @@ spec:
                         required:
                         - type
                         type: object
+                      gpus:
+                        description: List of GPU devices that need to be added to
+                          the machines.
+                        items:
+                          properties:
+                            deviceID:
+                              description: deviceID is the id of the GPU entity.
+                              format: int64
+                              type: integer
+                            name:
+                              description: name is the GPU name
+                              type: string
+                            type:
+                              description: Type is the identifier type to use for
+                                this resource.
+                              enum:
+                              - deviceID
+                              - name
+                              type: string
+                          required:
+                          - type
+                          type: object
+                        type: array
                       image:
                         description: |-
                           image identifies the image uploaded to Prism Central (PC). The identifier

api/v1alpha1/nutanix_node_types.go

@@ -60,6 +60,10 @@ type NutanixMachineDetails struct {
 	// The project must already be present in the Prism Central.
 	// +kubebuilder:validation:Optional
 	Project *NutanixResourceIdentifier `json:"project,omitempty"`
+
+	// List of GPU devices that need to be added to the machines.
+	// +kubebuilder:validation:Optional
+	GPUs []capxv1.NutanixGPU `json:"gpus,omitempty"`
 }
 
 // NutanixIdentifierType is an enumeration of different resource identifier types.

api/v1alpha1/zz_generated.deepcopy.go

@@ -228,3 +228,46 @@ spec:
         type: name
         name: project-name
 ```
+
+### (Optional) Add a GPU to a machine deployment
+
+```yaml
+apiVersion: cluster.x-k8s.io/v1beta1
+kind: Cluster
+metadata:
+  name: <NAME>
+spec:
+  topology:
+    variables:
+    - name: workerConfig
+      value:
+        nutanix:
+          machineDetails:
+            gpus:
+            - type: name
+              name: "Ampere 40"
+    workers:
+      - class: nutanix-quick-start-worker
+        metadata:
+          annotations:
+            cluster.x-k8s.io/cluster-api-autoscaler-node-group-max-size: "1"
+            cluster.x-k8s.io/cluster-api-autoscaler-node-group-min-size: "1"
+        name: gpu-0
+```
+
+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-gpu-nmt
+spec:
+  template:
+    spec:
+      gpus:
+      - type: name
+        name: "Ampere 40"
+```

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

@@ -122,7 +122,11 @@ func (h *nutanixMachineDetailsPatchHandler) Mutate(
 					capxv1.NutanixResourceIdentifier(*nutanixMachineDetailsVar.Project),
 				)
 			}
-
+			spec.GPUs = make(
+				[]capxv1.NutanixGPU,
+				len(nutanixMachineDetailsVar.GPUs),
+			)
+			copy(spec.GPUs, nutanixMachineDetailsVar.GPUs)
 			obj.Spec.Template.Spec = spec
 			return nil
 		},

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

@@ -55,9 +55,33 @@ var (
 			Type: capxv1.NutanixIdentifierName,
 			Name: ptr.To("fake-project"),
 		}),
+		GPUs: []capxv1.NutanixGPU{
+			{
+				Type: "name",
+				Name: ptr.To("gpu1"),
+			},
+			{
+				Type:     "deviceID",
+				DeviceID: ptr.To(int64(1)),
+			},
+		},
 	}
 
 	matchersForAllFieldsSet = []capitest.JSONPatchMatcher{
+		{
+			Operation: "add",
+			Path:      "/spec/template/spec/gpus",
+			ValueMatcher: gomega.ContainElements(
+				gomega.SatisfyAll(
+					gomega.HaveKeyWithValue("type", "name"),
+					gomega.HaveKeyWithValue("name", "gpu1"),
+				),
+				gomega.SatisfyAll(
+					gomega.HaveKeyWithValue("type", "deviceID"),
+					gomega.HaveKeyWithValue("deviceID", gomega.BeNumerically("==", 1)),
+				),
+			),
+		},
 		{
 			Operation:    "add",
 			Path:         "/spec/template/spec/bootType",