sigs.k8s.io/cluster-api@v1.7.1/config/crd/bases/runtime.cluster.x-k8s.io_extensionconfigs.yaml (about)

     1  ---
     2  apiVersion: apiextensions.k8s.io/v1
     3  kind: CustomResourceDefinition
     4  metadata:
     5    annotations:
     6      controller-gen.kubebuilder.io/version: v0.14.0
     7    name: extensionconfigs.runtime.cluster.x-k8s.io
     8  spec:
     9    group: runtime.cluster.x-k8s.io
    10    names:
    11      categories:
    12      - cluster-api
    13      kind: ExtensionConfig
    14      listKind: ExtensionConfigList
    15      plural: extensionconfigs
    16      shortNames:
    17      - ext
    18      singular: extensionconfig
    19    scope: Cluster
    20    versions:
    21    - additionalPrinterColumns:
    22      - description: Time duration since creation of ExtensionConfig
    23        jsonPath: .metadata.creationTimestamp
    24        name: Age
    25        type: date
    26      name: v1alpha1
    27      schema:
    28        openAPIV3Schema:
    29          description: ExtensionConfig is the Schema for the ExtensionConfig API.
    30          properties:
    31            apiVersion:
    32              description: |-
    33                APIVersion defines the versioned schema of this representation of an object.
    34                Servers should convert recognized schemas to the latest internal value, and
    35                may reject unrecognized values.
    36                More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
    37              type: string
    38            kind:
    39              description: |-
    40                Kind is a string value representing the REST resource this object represents.
    41                Servers may infer this from the endpoint the client submits requests to.
    42                Cannot be updated.
    43                In CamelCase.
    44                More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
    45              type: string
    46            metadata:
    47              type: object
    48            spec:
    49              description: ExtensionConfigSpec is the desired state of the ExtensionConfig
    50              properties:
    51                clientConfig:
    52                  description: ClientConfig defines how to communicate with the Extension
    53                    server.
    54                  properties:
    55                    caBundle:
    56                      description: CABundle is a PEM encoded CA bundle which will be
    57                        used to validate the Extension server's server certificate.
    58                      format: byte
    59                      type: string
    60                    service:
    61                      description: |-
    62                        Service is a reference to the Kubernetes service for the Extension server.
    63                        Note: Exactly one of `url` or `service` must be specified.
    64  
    65  
    66                        If the Extension server is running within a cluster, then you should use `service`.
    67                      properties:
    68                        name:
    69                          description: Name is the name of the service.
    70                          type: string
    71                        namespace:
    72                          description: Namespace is the namespace of the service.
    73                          type: string
    74                        path:
    75                          description: |-
    76                            Path is an optional URL path and if present may be any string permissible in
    77                            a URL. If a path is set it will be used as prefix to the hook-specific path.
    78                          type: string
    79                        port:
    80                          description: |-
    81                            Port is the port on the service that's hosting the Extension server.
    82                            Defaults to 443.
    83                            Port should be a valid port number (1-65535, inclusive).
    84                          format: int32
    85                          type: integer
    86                      required:
    87                      - name
    88                      - namespace
    89                      type: object
    90                    url:
    91                      description: |-
    92                        URL gives the location of the Extension server, in standard URL form
    93                        (`scheme://host:port/path`).
    94                        Note: Exactly one of `url` or `service` must be specified.
    95  
    96  
    97                        The scheme must be "https".
    98  
    99  
   100                        The `host` should not refer to a service running in the cluster; use
   101                        the `service` field instead.
   102  
   103  
   104                        A path is optional, and if present may be any string permissible in
   105                        a URL. If a path is set it will be used as prefix to the hook-specific path.
   106  
   107  
   108                        Attempting to use a user or basic auth e.g. "user:password@" is not
   109                        allowed. Fragments ("#...") and query parameters ("?...") are not
   110                        allowed either.
   111                      type: string
   112                  type: object
   113                namespaceSelector:
   114                  description: |-
   115                    NamespaceSelector decides whether to call the hook for an object based
   116                    on whether the namespace for that object matches the selector.
   117                    Defaults to the empty LabelSelector, which matches all objects.
   118                  properties:
   119                    matchExpressions:
   120                      description: matchExpressions is a list of label selector requirements.
   121                        The requirements are ANDed.
   122                      items:
   123                        description: |-
   124                          A label selector requirement is a selector that contains values, a key, and an operator that
   125                          relates the key and values.
   126                        properties:
   127                          key:
   128                            description: key is the label key that the selector applies
   129                              to.
   130                            type: string
   131                          operator:
   132                            description: |-
   133                              operator represents a key's relationship to a set of values.
   134                              Valid operators are In, NotIn, Exists and DoesNotExist.
   135                            type: string
   136                          values:
   137                            description: |-
   138                              values is an array of string values. If the operator is In or NotIn,
   139                              the values array must be non-empty. If the operator is Exists or DoesNotExist,
   140                              the values array must be empty. This array is replaced during a strategic
   141                              merge patch.
   142                            items:
   143                              type: string
   144                            type: array
   145                        required:
   146                        - key
   147                        - operator
   148                        type: object
   149                      type: array
   150                    matchLabels:
   151                      additionalProperties:
   152                        type: string
   153                      description: |-
   154                        matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
   155                        map is equivalent to an element of matchExpressions, whose key field is "key", the
   156                        operator is "In", and the values array contains only "value". The requirements are ANDed.
   157                      type: object
   158                  type: object
   159                  x-kubernetes-map-type: atomic
   160                settings:
   161                  additionalProperties:
   162                    type: string
   163                  description: |-
   164                    Settings defines key value pairs to be passed to all calls
   165                    to all supported RuntimeExtensions.
   166                    Note: Settings can be overridden on the ClusterClass.
   167                  type: object
   168              required:
   169              - clientConfig
   170              type: object
   171            status:
   172              description: ExtensionConfigStatus is the current state of the ExtensionConfig
   173              properties:
   174                conditions:
   175                  description: Conditions define the current service state of the ExtensionConfig.
   176                  items:
   177                    description: Condition defines an observation of a Cluster API resource
   178                      operational state.
   179                    properties:
   180                      lastTransitionTime:
   181                        description: |-
   182                          Last time the condition transitioned from one status to another.
   183                          This should be when the underlying condition changed. If that is not known, then using the time when
   184                          the API field changed is acceptable.
   185                        format: date-time
   186                        type: string
   187                      message:
   188                        description: |-
   189                          A human readable message indicating details about the transition.
   190                          This field may be empty.
   191                        type: string
   192                      reason:
   193                        description: |-
   194                          The reason for the condition's last transition in CamelCase.
   195                          The specific API may choose whether or not this field is considered a guaranteed API.
   196                          This field may not be empty.
   197                        type: string
   198                      severity:
   199                        description: |-
   200                          Severity provides an explicit classification of Reason code, so the users or machines can immediately
   201                          understand the current situation and act accordingly.
   202                          The Severity field MUST be set only when Status=False.
   203                        type: string
   204                      status:
   205                        description: Status of the condition, one of True, False, Unknown.
   206                        type: string
   207                      type:
   208                        description: |-
   209                          Type of condition in CamelCase or in foo.example.com/CamelCase.
   210                          Many .condition.type values are consistent across resources like Available, but because arbitrary conditions
   211                          can be useful (see .node.status.conditions), the ability to deconflict is important.
   212                        type: string
   213                    required:
   214                    - lastTransitionTime
   215                    - status
   216                    - type
   217                    type: object
   218                  type: array
   219                handlers:
   220                  description: Handlers defines the current ExtensionHandlers supported
   221                    by an Extension.
   222                  items:
   223                    description: ExtensionHandler specifies the details of a handler
   224                      for a particular runtime hook registered by an Extension server.
   225                    properties:
   226                      failurePolicy:
   227                        description: |-
   228                          FailurePolicy defines how failures in calls to the ExtensionHandler should be handled by a client.
   229                          Defaults to Fail if not set.
   230                        type: string
   231                      name:
   232                        description: Name is the unique name of the ExtensionHandler.
   233                        type: string
   234                      requestHook:
   235                        description: RequestHook defines the versioned runtime hook
   236                          which this ExtensionHandler serves.
   237                        properties:
   238                          apiVersion:
   239                            description: APIVersion is the group and version of the
   240                              Hook.
   241                            type: string
   242                          hook:
   243                            description: Hook is the name of the hook.
   244                            type: string
   245                        required:
   246                        - apiVersion
   247                        - hook
   248                        type: object
   249                      timeoutSeconds:
   250                        description: |-
   251                          TimeoutSeconds defines the timeout duration for client calls to the ExtensionHandler.
   252                          Defaults to 10 is not set.
   253                        format: int32
   254                        type: integer
   255                    required:
   256                    - name
   257                    - requestHook
   258                    type: object
   259                  type: array
   260                  x-kubernetes-list-map-keys:
   261                  - name
   262                  x-kubernetes-list-type: map
   263              type: object
   264          type: object
   265      served: true
   266      storage: true
   267      subresources:
   268        status: {}