config: add aws usertags to infrastructure

Add a new field userTags to `.status.aws` of the
infrastructure.config.openshift.io type. Tags included
in the userTags field will be applied to new resources
created for the cluster.

Note that even though AWS generally allows the tag value
to be empty, some AWS services do not support this.
Therefore, we require that a tag value have a minimum
length of 1.

https://issues.redhat.com/browse/CORS-1657

Author: staebler

config/v1/0000_10_config-operator_01_infrastructure.crd.yaml

@@ -271,6 +271,38 @@ spec:
                                 empty.
                               type: string
                               pattern: ^https://
+                      userTags:
+                        description: userTags is a list of additional tags to apply
+                          to AWS resources created for the cluster. See https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
+                          for information on tagging AWS resources. AWS supports a
+                          maximum of 50 tags per resource. OpenShift reserves 25 tags
+                          for its use, leaving 25 tags available for the user.
+                        type: array
+                        maxItems: 25
+                        items:
+                          description: AWSUserTag is a tag to apply to AWS resources
+                            created for the cluster.
+                          type: object
+                          required:
+                          - key
+                          - value
+                          properties:
+                            key:
+                              description: key is the key of the tag
+                              type: string
+                              maxLength: 128
+                              minLength: 1
+                              pattern: ^[0-9A-Za-z_.:/=+-@]+$
+                            value:
+                              description: value is the value of the tag. Some AWS
+                                service do not support empty values. Since user tags
+                                are added to resources in many services, the length
+                                of the tag value must meet the requirements of all
+                                services.
+                              type: string
+                              maxLength: 256
+                              minLength: 1
+                              pattern: ^[0-9A-Za-z_.:/=+-@]+$
                   azure:
                     description: Azure contains settings specific to the Azure infrastructure
                       provider.

config/v1/types_infrastructure.go

@@ -313,6 +313,34 @@ type AWSPlatformStatus struct {
 	// There must be only one ServiceEndpoint for a service.
 	// +optional
 	ServiceEndpoints []AWSServiceEndpoint `json:"serviceEndpoints,omitempty"`
+
+	// userTags is a list of additional tags to apply to AWS resources created for the cluster.
+	// See https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html for information on tagging AWS resources.
+	// AWS supports a maximum of 50 tags per resource. OpenShift reserves 25 tags for its use, leaving 25 tags
+	// available for the user.
+	// +kubebuilder:validation:MaxItems=25
+	// +optional
+	UserTags []AWSUserTag `json:"userTags,omitempty"`
+}
+
+// AWSUserTag is a tag to apply to AWS resources created for the cluster.
+type AWSUserTag struct {
+	// key is the key of the tag
+	// +kubebuilder:validation:Required
+	// +kubebuilder:validation:MinLength=1
+	// +kubebuilder:validation:MaxLength=128
+	// +kubebuilder:validation:Pattern=`^[0-9A-Za-z_.:/=+-@]+$`
+	// +required
+	Key string `json:"key"`
+	// value is the value of the tag.
+	// Some AWS service do not support empty values. Since user tags are added to resources in many services, the
+	// length of the tag value must meet the requirements of all services.
+	// +kubebuilder:validation:Required
+	// +kubebuilder:validation:MinLength=1
+	// +kubebuilder:validation:MaxLength=256
+	// +kubebuilder:validation:Pattern=`^[0-9A-Za-z_.:/=+-@]+$`
+	// +required
+	Value string `json:"value"`
 }
 
 // AzurePlatformSpec holds the desired state of the Azure infrastructure provider.