revise and regenerate doc comments and kubebuilder validations

Author: BraeTroutman

api/v1beta2/types.go

@@ -275,26 +275,27 @@ type Instance struct {
 	MarketType MarketType `json:"marketType,omitempty"`
 
 	// CapacityReservationPreference specifies the preference for use of Capacity Reservations by the instance. Valid values include:
-	// "Open" (default): The instance may make use of open Capacity Reservations that match its AZ and InstanceType
+	// "Open": The instance may make use of open Capacity Reservations that match its AZ and InstanceType
 	// "None": The instance may not make use of any Capacity Reservations. This is to conserve open reservations for desired workloads
 	// "CapacityReservationsOnly": The instance will only run if matched or targeted to a Capacity Reservation
+	// +kubebuilder:validation:Enum="";None;CapacityReservationsOnly;Open
 	// +optional
 	CapacityReservationPreference CapacityReservationPreference `json:"capacityReservationPreference,omitempty"`
 }
 
 // CapacityReservationPreference describes the preferred use of capacity reservations
 // of an instance
-// +kubebuilder:validation:Enum:=None;CapacityReservationsOnly;Open
+// +kubebuilder:validation:Enum:="";None;CapacityReservationsOnly;Open
 type CapacityReservationPreference string
 
 const (
-	// CapacityReservationPreferenceNone is a CapacityReservationPreference enum value
+	// CapacityReservationPreferenceNone the instance may not make use of any Capacity Reservations. This is to conserve open reservations for desired workloads
 	CapacityReservationPreferenceNone CapacityReservationPreference = "None"
 
-	// CapacityReservationPreferenceOnly is a CapacityReservationPreference enum value
+	// CapacityReservationPreferenceOnly the instance will only run if matched or targeted to a Capacity Reservation
 	CapacityReservationPreferenceOnly CapacityReservationPreference = "CapacityReservationsOnly"
 
-	// CapacityReservationPreferenceOpen is a CapacityReservationPreference enum value
+	// CapacityReservationPreferenceOpen the instance may make use of open Capacity Reservations that match its AZ and InstanceType.
 	CapacityReservationPreferenceOpen CapacityReservationPreference = "Open"
 )
 

config/crd/bases/controlplane.cluster.x-k8s.io_awsmanagedcontrolplanes.yaml

@@ -1215,15 +1215,22 @@ spec:
                       Reservation into which the instance should be launched.
                     type: string
                   capacityReservationPreference:
+                    allOf:
+                    - enum:
+                      - ""
+                      - None
+                      - CapacityReservationsOnly
+                      - Open
+                    - enum:
+                      - ""
+                      - None
+                      - CapacityReservationsOnly
+                      - Open
                     description: |-
                       CapacityReservationPreference specifies the preference for use of Capacity Reservations by the instance. Valid values include:
-                      "Open" (default): The instance may make make use of open Capacity Reservations that match its AZ and InstanceType
+                      "Open": The instance may make use of open Capacity Reservations that match its AZ and InstanceType
                       "None": The instance may not make use of any Capacity Reservations. This is to conserve open reservations for desired workloads
                       "CapacityReservationsOnly": The instance will only run if matched or targeted to a Capacity Reservation
-                    enum:
-                    - None
-                    - CapacityReservationsOnly
-                    - Open
                     type: string
                   ebsOptimized:
                     description: Indicates whether the instance is optimized for Amazon
@@ -3407,15 +3414,22 @@ spec:
                       Reservation into which the instance should be launched.
                     type: string
                   capacityReservationPreference:
+                    allOf:
+                    - enum:
+                      - ""
+                      - None
+                      - CapacityReservationsOnly
+                      - Open
+                    - enum:
+                      - ""
+                      - None
+                      - CapacityReservationsOnly
+                      - Open
                     description: |-
                       CapacityReservationPreference specifies the preference for use of Capacity Reservations by the instance. Valid values include:
-                      "Open" (default): The instance may make make use of open Capacity Reservations that match its AZ and InstanceType
+                      "Open": The instance may make use of open Capacity Reservations that match its AZ and InstanceType
                       "None": The instance may not make use of any Capacity Reservations. This is to conserve open reservations for desired workloads
                       "CapacityReservationsOnly": The instance will only run if matched or targeted to a Capacity Reservation
-                    enum:
-                    - None
-                    - CapacityReservationsOnly
-                    - Open
                     type: string
                   ebsOptimized:
                     description: Indicates whether the instance is optimized for Amazon

config/crd/bases/infrastructure.cluster.x-k8s.io_awsclusters.yaml

@@ -2198,15 +2198,22 @@ spec:
                       Reservation into which the instance should be launched.
                     type: string
                   capacityReservationPreference:
+                    allOf:
+                    - enum:
+                      - ""
+                      - None
+                      - CapacityReservationsOnly
+                      - Open
+                    - enum:
+                      - ""
+                      - None
+                      - CapacityReservationsOnly
+                      - Open
                     description: |-
                       CapacityReservationPreference specifies the preference for use of Capacity Reservations by the instance. Valid values include:
-                      "Open" (default): The instance may make make use of open Capacity Reservations that match its AZ and InstanceType
+                      "Open": The instance may make use of open Capacity Reservations that match its AZ and InstanceType
                       "None": The instance may not make use of any Capacity Reservations. This is to conserve open reservations for desired workloads
                       "CapacityReservationsOnly": The instance will only run if matched or targeted to a Capacity Reservation
-                    enum:
-                    - None
-                    - CapacityReservationsOnly
-                    - Open
                     type: string
                   ebsOptimized:
                     description: Indicates whether the instance is optimized for Amazon

config/crd/bases/infrastructure.cluster.x-k8s.io_awsmachinepools.yaml

@@ -647,10 +647,11 @@ spec:
                   capacityReservationPreference:
                     description: |-
                       CapacityReservationPreference specifies the preference for use of Capacity Reservations by the instance. Valid values include:
-                      "Open" (default): The instance may make make use of open Capacity Reservations that match its AZ and InstanceType
+                      "Open" (default): The instance may make use of open Capacity Reservations that match its AZ and InstanceType
                       "None": The instance may not make use of any Capacity Reservations. This is to conserve open reservations for desired workloads
                       "CapacityReservationsOnly": The instance will only run if matched or targeted to a Capacity Reservation
                     enum:
+                    - ""
                     - None
                     - CapacityReservationsOnly
                     - Open

config/crd/bases/infrastructure.cluster.x-k8s.io_awsmachines.yaml

@@ -644,10 +644,11 @@ spec:
               capacityReservationPreference:
                 description: |-
                   CapacityReservationPreference specifies the preference for use of Capacity Reservations by the instance. Valid values include:
-                  "Open" (default): The instance may make make use of open Capacity Reservations that match its AZ and InstanceType
+                  "Open" (default): The instance may make use of open Capacity Reservations that match its AZ and InstanceType
                   "None": The instance may not make use of any Capacity Reservations. This is to conserve open reservations for desired workloads
                   "CapacityReservationsOnly": The instance will only run if matched or targeted to a Capacity Reservation
                 enum:
+                - ""
                 - None
                 - CapacityReservationsOnly
                 - Open

config/crd/bases/infrastructure.cluster.x-k8s.io_awsmachinetemplates.yaml

@@ -563,10 +563,11 @@ spec:
                       capacityReservationPreference:
                         description: |-
                           CapacityReservationPreference specifies the preference for use of Capacity Reservations by the instance. Valid values include:
-                          "Open" (default): The instance may make make use of open Capacity Reservations that match its AZ and InstanceType
+                          "Open" (default): The instance may make use of open Capacity Reservations that match its AZ and InstanceType
                           "None": The instance may not make use of any Capacity Reservations. This is to conserve open reservations for desired workloads
                           "CapacityReservationsOnly": The instance will only run if matched or targeted to a Capacity Reservation
                         enum:
+                        - ""
                         - None
                         - CapacityReservationsOnly
                         - Open

config/crd/bases/infrastructure.cluster.x-k8s.io_awsmanagedmachinepools.yaml

@@ -656,10 +656,11 @@ spec:
                   capacityReservationPreference:
                     description: |-
                       CapacityReservationPreference specifies the preference for use of Capacity Reservations by the instance. Valid values include:
-                      "Open" (default): The instance may make make use of open Capacity Reservations that match its AZ and InstanceType
+                      "Open" (default): The instance may make use of open Capacity Reservations that match its AZ and InstanceType
                       "None": The instance may not make use of any Capacity Reservations. This is to conserve open reservations for desired workloads
                       "CapacityReservationsOnly": The instance will only run if matched or targeted to a Capacity Reservation
                     enum:
+                    - ""
                     - None
                     - CapacityReservationsOnly
                     - Open