Update docs for v2.3.0 release

config.yaml

@@ -94,7 +94,7 @@ security:
 # Global parameters accessible by any Page
 params:
   # The current "latest" version. Used in the version dropdown
-  latest: "2.2"
+  latest: "2.3"
   docs: true
   anchors:
     # Generate heading anchors for any heading between min and max

content/master/api/crds/apiextensions.crossplane.io_compositeresourcedefinitions.yaml

@@ -544,6 +544,47 @@ spec:
                       description: Served specifies that this version should be served
                         via REST APIs.
                       type: boolean
+                    subresources:
+                      description: |-
+                        Subresources specifies what subresources this version of the defined Composite resource has.
+                        The composition authors have responsibility to implement the logic fulfilling the subresources.
+                      properties:
+                        scale:
+                          description: Scale indicates the CRD should serve a `/scale`
+                            subresource that returns an `autoscaling/v1` Scale object.
+                          properties:
+                            labelSelectorPath:
+                              description: |-
+                                labelSelectorPath defines the JSON path inside of a custom resource that corresponds to Scale `status.selector`.
+                                Only JSON paths without the array notation are allowed.
+                                Must be a JSON Path under `.status` or `.spec`.
+                                Must be set to work with HorizontalPodAutoscaler.
+                                The field pointed by this JSON path must be a string field (not a complex selector struct)
+                                which contains a serialized label selector in string form.
+                                More info: https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions#scale-subresource
+                                If there is no value under the given path in the custom resource, the `status.selector` value in the `/scale`
+                                subresource will default to the empty string.
+                              type: string
+                            specReplicasPath:
+                              description: |-
+                                specReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `spec.replicas`.
+                                Only JSON paths without the array notation are allowed.
+                                Must be a JSON Path under `.spec`.
+                                If there is no value under the given path in the custom resource, the `/scale` subresource will return an error on GET.
+                              type: string
+                            statusReplicasPath:
+                              description: |-
+                                statusReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `status.replicas`.
+                                Only JSON paths without the array notation are allowed.
+                                Must be a JSON Path under `.status`.
+                                If there is no value under the given path in the custom resource, the `status.replicas` value in the `/scale` subresource
+                                will default to 0.
+                              type: string
+                          required:
+                          - specReplicasPath
+                          - statusReplicasPath
+                          type: object
+                      type: object
                   required:
                   - name
                   - referenceable
@@ -1172,6 +1213,47 @@ spec:
                       description: Served specifies that this version should be served
                         via REST APIs.
                       type: boolean
+                    subresources:
+                      description: |-
+                        Subresources specifies what subresources this version of the defined Composite resource has.
+                        The composition authors have responsibility to implement the logic fulfilling the subresources.
+                      properties:
+                        scale:
+                          description: Scale indicates the CRD should serve a `/scale`
+                            subresource that returns an `autoscaling/v1` Scale object.
+                          properties:
+                            labelSelectorPath:
+                              description: |-
+                                labelSelectorPath defines the JSON path inside of a custom resource that corresponds to Scale `status.selector`.
+                                Only JSON paths without the array notation are allowed.
+                                Must be a JSON Path under `.status` or `.spec`.
+                                Must be set to work with HorizontalPodAutoscaler.
+                                The field pointed by this JSON path must be a string field (not a complex selector struct)
+                                which contains a serialized label selector in string form.
+                                More info: https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions#scale-subresource
+                                If there is no value under the given path in the custom resource, the `status.selector` value in the `/scale`
+                                subresource will default to the empty string.
+                              type: string
+                            specReplicasPath:
+                              description: |-
+                                specReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `spec.replicas`.
+                                Only JSON paths without the array notation are allowed.
+                                Must be a JSON Path under `.spec`.
+                                If there is no value under the given path in the custom resource, the `/scale` subresource will return an error on GET.
+                              type: string
+                            statusReplicasPath:
+                              description: |-
+                                statusReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale `status.replicas`.
+                                Only JSON paths without the array notation are allowed.
+                                Must be a JSON Path under `.status`.
+                                If there is no value under the given path in the custom resource, the `status.replicas` value in the `/scale` subresource
+                                will default to 0.
+                              type: string
+                          required:
+                          - specReplicasPath
+                          - statusReplicasPath
+                          type: object
+                      type: object
                   required:
                   - name
                   - referenceable

content/master/api/crds/apiextensions.crossplane.io_compositionrevisions.yaml

@@ -210,10 +210,8 @@ spec:
                             - requirementName
                             type: object
                             x-kubernetes-validations:
-                            - message: Either name or matchLabels must be specified,
-                                but not both
-                              rule: (has(self.name) && !has(self.matchLabels)) ||
-                                (!has(self.name) && has(self.matchLabels))
+                            - message: name and matchLabels are mutually exclusive
+                              rule: '!(has(self.name) && has(self.matchLabels))'
                           type: array
                           x-kubernetes-list-map-keys:
                           - requirementName

content/master/api/crds/apiextensions.crossplane.io_compositions.yaml

@@ -206,10 +206,8 @@ spec:
                             - requirementName
                             type: object
                             x-kubernetes-validations:
-                            - message: Either name or matchLabels must be specified,
-                                but not both
-                              rule: (has(self.name) && !has(self.matchLabels)) ||
-                                (!has(self.name) && has(self.matchLabels))
+                            - message: name and matchLabels are mutually exclusive
+                              rule: '!(has(self.name) && has(self.matchLabels))'
                           type: array
                           x-kubernetes-list-map-keys:
                           - requirementName

content/master/api/crds/ops.crossplane.io_cronoperations.yaml

@@ -214,10 +214,8 @@ spec:
                                     - requirementName
                                     type: object
                                     x-kubernetes-validations:
-                                    - message: Either name or matchLabels must be
-                                        specified, but not both
-                                      rule: (has(self.name) && !has(self.matchLabels))
-                                        || (!has(self.name) && has(self.matchLabels))
+                                    - message: name and matchLabels are mutually exclusive
+                                      rule: '!(has(self.name) && has(self.matchLabels))'
                                   type: array
                                   x-kubernetes-list-map-keys:
                                   - requirementName

content/master/api/crds/ops.crossplane.io_operations.yaml

@@ -180,10 +180,8 @@ spec:
                             - requirementName
                             type: object
                             x-kubernetes-validations:
-                            - message: Either name or matchLabels must be specified,
-                                but not both
-                              rule: (has(self.name) && !has(self.matchLabels)) ||
-                                (!has(self.name) && has(self.matchLabels))
+                            - message: name and matchLabels are mutually exclusive
+                              rule: '!(has(self.name) && has(self.matchLabels))'
                           type: array
                           x-kubernetes-list-map-keys:
                           - requirementName

content/master/api/crds/ops.crossplane.io_watchoperations.yaml

@@ -217,10 +217,8 @@ spec:
                                     - requirementName
                                     type: object
                                     x-kubernetes-validations:
-                                    - message: Either name or matchLabels must be
-                                        specified, but not both
-                                      rule: (has(self.name) && !has(self.matchLabels))
-                                        || (!has(self.name) && has(self.matchLabels))
+                                    - message: name and matchLabels are mutually exclusive
+                                      rule: '!(has(self.name) && has(self.matchLabels))'
                                   type: array
                                   x-kubernetes-list-map-keys:
                                   - requirementName

content/master/api/crds/pkg.crossplane.io_configurationrevisions.yaml

@@ -72,6 +72,13 @@ spec:
           spec:
             description: PackageRevisionSpec specifies the desired state of a PackageRevision.
             properties:
+              commonAnnotations:
+                additionalProperties:
+                  type: string
+                description: |-
+                  Map of string keys and values that can be used to annotate objects.
+                  More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
+                type: object
               commonLabels:
                 additionalProperties:
                   type: string

content/master/api/crds/pkg.crossplane.io_configurations.yaml

@@ -63,6 +63,13 @@ spec:
               ConfigurationSpec specifies details about a request to install a
               configuration to Crossplane.
             properties:
+              commonAnnotations:
+                additionalProperties:
+                  type: string
+                description: |-
+                  Map of string keys and values that can be used to annotate objects.
+                  More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
+                type: object
               commonLabels:
                 additionalProperties:
                   type: string

content/master/api/crds/pkg.crossplane.io_functionrevisions.yaml

@@ -75,6 +75,13 @@ spec:
           spec:
             description: FunctionRevisionSpec specifies configuration for a FunctionRevision.
             properties:
+              commonAnnotations:
+                additionalProperties:
+                  type: string
+                description: |-
+                  Map of string keys and values that can be used to annotate objects.
+                  More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
+                type: object
               commonLabels:
                 additionalProperties:
                   type: string
@@ -378,6 +385,13 @@ spec:
           spec:
             description: FunctionRevisionSpec specifies configuration for a FunctionRevision.
             properties:
+              commonAnnotations:
+                additionalProperties:
+                  type: string
+                description: |-
+                  Map of string keys and values that can be used to annotate objects.
+                  More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
+                type: object
               commonLabels:
                 additionalProperties:
                   type: string

content/master/api/crds/pkg.crossplane.io_functions.yaml

@@ -60,6 +60,13 @@ spec:
           spec:
             description: FunctionSpec specifies the configuration of a Function.
             properties:
+              commonAnnotations:
+                additionalProperties:
+                  type: string
+                description: |-
+                  Map of string keys and values that can be used to annotate objects.
+                  More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
+                type: object
               commonLabels:
                 additionalProperties:
                   type: string
@@ -301,6 +308,13 @@ spec:
           spec:
             description: FunctionSpec specifies the configuration of a Function.
             properties:
+              commonAnnotations:
+                additionalProperties:
+                  type: string
+                description: |-
+                  Map of string keys and values that can be used to annotate objects.
+                  More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
+                type: object
               commonLabels:
                 additionalProperties:
                   type: string

content/master/api/crds/pkg.crossplane.io_providerrevisions.yaml

@@ -75,6 +75,13 @@ spec:
           spec:
             description: ProviderRevisionSpec specifies configuration for a ProviderRevision.
             properties:
+              commonAnnotations:
+                additionalProperties:
+                  type: string
+                description: |-
+                  Map of string keys and values that can be used to annotate objects.
+                  More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
+                type: object
               commonLabels:
                 additionalProperties:
                   type: string

content/master/api/crds/pkg.crossplane.io_providers.yaml

@@ -62,6 +62,13 @@ spec:
               ProviderSpec specifies details about a request to install a provider to
               Crossplane.
             properties:
+              commonAnnotations:
+                additionalProperties:
+                  type: string
+                description: |-
+                  Map of string keys and values that can be used to annotate objects.
+                  More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
+                type: object
               commonLabels:
                 additionalProperties:
                   type: string

content/master/composition/composite-resource-definitions.md

@@ -130,9 +130,8 @@ The XRD
 {{<hover label="xrdName" line="9">}}plural{{</hover>}} name, `.` (dot character),
 {{<hover label="xrdName" line="6">}}group{{</hover>}}.
 
-For example, {{<hover label="xrdName"
-line="4">}}mydatabases.example.org{{</hover>}} matches the {{<hover
-label="xrdName" line="9">}}plural{{</hover>}} name
+For example, {{<hover label="xrdName" line="4">}}mydatabases.example.org{{</hover>}} matches the
+{{<hover label="xrdName" line="9">}}plural{{</hover>}} name
 {{<hover label="xrdName" line="9">}}mydatabases{{</hover>}}, `.`
 {{<hover label="xrdName" line="6">}}group{{</hover>}} name,
 {{<hover label="xrdName" line="6">}}example.org{{</hover>}}.