Update .spec.config api doc to ellucidate validation

Signed-off-by: Per Goncalves da Silva <[email protected]>

Author: Per Goncalves da Silva

api/v1/clusterextension_types.go

@@ -101,6 +101,8 @@ type ClusterExtensionSpec struct {
 	// config contains optional configuration values applied during rendering of the
 	// ClusterExtension's manifests. Values can be specified inline.
 	//
+	// The configuration schema is defined by the bundle and validated at runtime.
+	//
 	// config is optional. When not specified, the default configuration of the resolved bundle will be used.
 	//
 	// <opcon:experimental>
@@ -174,6 +176,8 @@ type ClusterExtensionConfig struct {
 	// ClusterExtension.
 	//
 	// inline must be set if configType is 'Inline'.
+	// inline accepts arbitrary JSON/YAML objects whose validation is carried out at runtime against the schema provided
+	// by the bundle if one is provided.
 	//
 	// +kubebuilder:validation:Type=object
 	// +optional

docs/api-reference/olmv1-api-reference.md

@@ -254,7 +254,7 @@ _Appears in:_
 | Field | Description | Default | Validation |
 | --- | --- | --- | --- |
 | `configType` _[ClusterExtensionConfigType](#clusterextensionconfigtype)_ | configType is a required reference to the type of configuration source.<br /><br />Allowed values are "Inline"<br /><br />When this field is set to "Inline", the cluster extension configuration is defined inline within the<br />ClusterExtension resource. |  | Enum: [Inline] <br />Required: \{\} <br /> |
-| `inline` _[JSON](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.31/#json-v1-apiextensions-k8s-io)_ | inline contains JSON or YAML values specified directly in the<br />ClusterExtension.<br /><br />inline must be set if configType is 'Inline'. |  | Type: object <br /> |
+| `inline` _[JSON](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.31/#json-v1-apiextensions-k8s-io)_ | inline contains JSON or YAML values specified directly in the<br />ClusterExtension.<br /><br />inline must be set if configType is 'Inline'.<br />inline accepts arbitrary JSON/YAML objects whose validation is carried out at runtime against the schema provided<br />by the bundle if one is provided. |  | Type: object <br /> |
 
 
 #### ClusterExtensionConfigType
@@ -343,7 +343,7 @@ _Appears in:_
 | `serviceAccount` _[ServiceAccountReference](#serviceaccountreference)_ | serviceAccount is a reference to a ServiceAccount used to perform all interactions<br />with the cluster that are required to manage the extension.<br />The ServiceAccount must be configured with the necessary permissions to perform these interactions.<br />The ServiceAccount must exist in the namespace referenced in the spec.<br />serviceAccount is required. |  | Required: \{\} <br /> |
 | `source` _[SourceConfig](#sourceconfig)_ | source is a required field which selects the installation source of content<br />for this ClusterExtension. Selection is performed by setting the sourceType.<br /><br />Catalog is currently the only implemented sourceType, and setting the<br />sourcetype to "Catalog" requires the catalog field to also be defined.<br /><br />Below is a minimal example of a source definition (in yaml):<br /><br />source:<br />  sourceType: Catalog<br />  catalog:<br />    packageName: example-package |  | Required: \{\} <br /> |
 | `install` _[ClusterExtensionInstallConfig](#clusterextensioninstallconfig)_ | install is an optional field used to configure the installation options<br />for the ClusterExtension such as the pre-flight check configuration. |  |  |
-| `config` _[ClusterExtensionConfig](#clusterextensionconfig)_ | config contains optional configuration values applied during rendering of the<br />ClusterExtension's manifests. Values can be specified inline.<br /><br />config is optional. When not specified, the default configuration of the resolved bundle will be used.<br /><br /><opcon:experimental> |  |  |
+| `config` _[ClusterExtensionConfig](#clusterextensionconfig)_ | config contains optional configuration values applied during rendering of the<br />ClusterExtension's manifests. Values can be specified inline.<br /><br />The configuration schema is defined by the bundle and validated at runtime.<br /><br />config is optional. When not specified, the default configuration of the resolved bundle will be used.<br /><br /><opcon:experimental> |  |  |
 
 
 #### ClusterExtensionStatus

helm/olmv1/base/operator-controller/crd/experimental/olm.operatorframework.io_clusterextensions.yaml

@@ -62,6 +62,8 @@ spec:
                   config contains optional configuration values applied during rendering of the
                   ClusterExtension's manifests. Values can be specified inline.
 
+                  The configuration schema is defined by the bundle and validated at runtime.
+
                   config is optional. When not specified, the default configuration of the resolved bundle will be used.
                 properties:
                   configType:
@@ -81,6 +83,8 @@ spec:
                       ClusterExtension.
 
                       inline must be set if configType is 'Inline'.
+                      inline accepts arbitrary JSON/YAML objects whose validation is carried out at runtime against the schema provided
+                      by the bundle if one is provided.
                     type: object
                     x-kubernetes-preserve-unknown-fields: true
                 required:

manifests/experimental-e2e.yaml

@@ -867,6 +867,8 @@ spec:
                   config contains optional configuration values applied during rendering of the
                   ClusterExtension's manifests. Values can be specified inline.
 
+                  The configuration schema is defined by the bundle and validated at runtime.
+
                   config is optional. When not specified, the default configuration of the resolved bundle will be used.
                 properties:
                   configType:
@@ -886,6 +888,8 @@ spec:
                       ClusterExtension.
 
                       inline must be set if configType is 'Inline'.
+                      inline accepts arbitrary JSON/YAML objects whose validation is carried out at runtime against the schema provided
+                      by the bundle if one is provided.
                     type: object
                     x-kubernetes-preserve-unknown-fields: true
                 required:

manifests/experimental.yaml

@@ -832,6 +832,8 @@ spec:
                   config contains optional configuration values applied during rendering of the
                   ClusterExtension's manifests. Values can be specified inline.
 
+                  The configuration schema is defined by the bundle and validated at runtime.
+
                   config is optional. When not specified, the default configuration of the resolved bundle will be used.
                 properties:
                   configType:
@@ -851,6 +853,8 @@ spec:
                       ClusterExtension.
 
                       inline must be set if configType is 'Inline'.
+                      inline accepts arbitrary JSON/YAML objects whose validation is carried out at runtime against the schema provided
+                      by the bundle if one is provided.
                     type: object
                     x-kubernetes-preserve-unknown-fields: true
                 required: