github.com/operator-framework/operator-lifecycle-manager@v0.30.0/deploy/upstream/manifests/0.7.1/0000_30_02-clusterserviceversion.crd.yaml (about)

     1  ##---
     2  # Source: olm/templates/0000_30_02-clusterserviceversion.crd.yaml
     3  apiVersion: apiextensions.k8s.io/v1beta1
     4  kind: CustomResourceDefinition
     5  metadata:
     6    name: clusterserviceversions.operators.coreos.com
     7    annotations:
     8      displayName: Operator Version
     9      description: Represents an Operator that should be running on the cluster, including requirements and install strategy.
    10  spec:
    11    names:
    12      plural: clusterserviceversions
    13      singular: clusterserviceversion
    14      kind: ClusterServiceVersion
    15      listKind: ClusterServiceVersionList
    16      shortNames:
    17      - csv
    18      categories:
    19      - all
    20      - olm
    21    additionalPrinterColumns:
    22    - name: Display
    23      type: string
    24      description: The name of the CSV
    25      JSONPath: .spec.displayName
    26    - name: Version
    27      type: string
    28      description: The version of the CSV
    29      JSONPath: .spec.version
    30    - name: Replaces
    31      type: string
    32      description: The name of a CSV that this one replaces
    33      JSONPath: .spec.replaces
    34    - name: Phase
    35      type: string
    36      JSONPath: .status.phase
    37    group: operators.coreos.com
    38    version: v1alpha1
    39    versions:
    40      - name: v1alpha1
    41        served: true
    42        storage: true
    43    scope: Namespaced
    44    subresources:
    45      # status enables the status subresource.
    46      status: {}
    47    validation:
    48      openAPIV3Schema:
    49        properties:
    50          spec:
    51            type: object
    52            description: Spec for a ClusterServiceVersion
    53            required:
    54            - displayName
    55            - install
    56            properties:
    57              displayName:
    58                type: string
    59                description: Human readable name of the application that will be displayed in the ALM UI
    60  
    61              description:
    62                type: string
    63                description: Human readable description of what the application does
    64  
    65              keywords:
    66                type: array
    67                description: List of keywords which will be used to discover and categorize app types
    68                items:
    69                  type: string
    70  
    71              maintainers:
    72                type: array
    73                description: Those responsible for the creation of this specific app type
    74                items:
    75                  type: object
    76                  description: Information for a single maintainer
    77                  required:
    78                  - name
    79                  - email
    80                  properties:
    81                    name:
    82                      type: string
    83                      description: Maintainer's name
    84                    email:
    85                      type: string
    86                      description: Maintainer's email address
    87                      format: email
    88                  optionalProperties:
    89                    type: string
    90                    description: "Any additional key-value metadata you wish to expose about the maintainer, e.g. github: <username>"
    91  
    92              links:
    93                type: array
    94                description: Interesting links to find more information about the project, such as marketing page, documentation, or github page
    95                items:
    96                  type: object
    97                  description: A single link to describe one aspect of the project
    98                  required:
    99                  - name
   100                  - url
   101                  properties:
   102                    name:
   103                      type: string
   104                      description: Name of the link type, e.g. homepage or github url
   105                    url:
   106                      type: string
   107                      description: URL to which the link should point
   108                      format: uri
   109  
   110              icon:
   111                type: array
   112                description: Icon which should be rendered with the application information
   113                required:
   114                - base64data
   115                - mediatype
   116                properties:
   117                  base64data:
   118                    type: string
   119                    description: Base64 binary representation of the icon image
   120                    pattern: ^(?:[A-Za-z0-9+/]{4}){0,16250}(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$
   121                  mediatype:
   122                    type: string
   123                    description: Mediatype for the binary data specified in the base64data property
   124                    enum:
   125                    - image/gif
   126                    - image/jpeg
   127                    - image/png
   128                    - image/svg+xml
   129              version:
   130                type: string
   131                description: Version string, recommended that users use semantic versioning
   132                pattern: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(-(0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(\.(0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*)?(\+[0-9a-zA-Z-]+(\.[0-9a-zA-Z-]+)*)?$
   133  
   134              replaces:
   135                type: string
   136                description: Name of the ClusterServiceVersion custom resource that this version replaces
   137  
   138              maturity:
   139                type: string
   140                description: What level of maturity the software has achieved at this version
   141                enum:
   142                - planning
   143                - pre-alpha
   144                - alpha
   145                - beta
   146                - stable
   147                - mature
   148                - inactive
   149                - deprecated
   150              labels:
   151                type: object
   152                description: Labels that will be applied to associated resources created by the operator.
   153              selector:
   154                type: object
   155                description: Label selector to find resources associated with or managed by the operator
   156                properties:
   157                  matchLabels:
   158                    type: object
   159                    description: Label key:value pairs to match directly
   160                  matchExpressions:
   161                    type: array
   162                    description: A set of expressions to match against the resource.
   163                    items:
   164                      allOf:
   165                        - type: object
   166                          required:
   167                          - key
   168                          - operator
   169                          - values
   170                          properties:
   171                            key:
   172                              type: string
   173                              description: the key to match
   174                            operator:
   175                              type: string
   176                              description: the operator for the expression
   177                              enum:
   178                              - In
   179                              - NotIn
   180                              - Exists
   181                              - DoesNotExist
   182                            values:
   183                              type: array
   184                              description: set of values for the expression
   185              apiservicedefinitions:
   186                type: object
   187                properties:
   188                  owned:
   189                    type: array
   190                    description: What resources this operator is responsible for managing. No two running operators should manage the same resource.
   191                    items:
   192                      type: object
   193                      required:
   194                      - name
   195                      - version
   196                      - kind
   197                      - displayName
   198                      - description
   199                      properties:
   200                        name:
   201                          type: string
   202                          description: Fully qualified name of the APIService (e.g. my-resource-v1.app.coreos.com)
   203                        version:
   204                          type: string
   205                          description: The version field of the APIService
   206                        kind:
   207                          type: string
   208                          description: The kind field of the APIService
   209                        displayName:
   210                          type: string
   211                          description: A human-readable name for the APIService.
   212                        description:
   213                          type: string
   214                          description: A description of the APIService
   215                        resources:
   216                          type: array
   217                          items:
   218                            type: object
   219                            description: A list of resources that should be displayed for the APIService
   220                            required:
   221                            - kind
   222                            - version
   223                            properties:
   224                              name:
   225                                type: string
   226                                description: If a APIService, the fully qualified name of the APIService (e.g. my-resource-v1.app.coreos.com)
   227                              version:
   228                                type: string
   229                                description: The version of the resource kind
   230                              kind:
   231                                type: string
   232                                description: The kind field of the resource kind
   233                        statusDescriptors:
   234                          type: array
   235                          items:
   236                            type: object
   237                            description: A spec for a field in the status block of the API resource
   238                            required:
   239                            - path
   240                            - displayName
   241                            - description
   242                            properties:
   243                              path:
   244                                type: string
   245                                description: A jsonpath indexing into the status object on the API resource where the the status value can be found.
   246                              displayName:
   247                                type: string
   248                                description: A human-readable name for the status entry.
   249                              description:
   250                                type: string
   251                                description: A description of the status entry.
   252                              x-descriptors:
   253                                type: array
   254                                description: A list of descriptors for the status entry that indicate the meaning of the field.
   255                                items:
   256                                  type: string
   257                              value:
   258                                type: object
   259                                description: If present, the value of this status is the same for all instances of the API resource and can be found here instead of on the API resource.
   260                        specDescriptors:
   261                          type: array
   262                          items:
   263                            type: object
   264                            description: A spec for a field in the spec block of the APIService resource.
   265                            required:
   266                            - path
   267                            - displayName
   268                            - description
   269                            properties:
   270                              path:
   271                                type: string
   272                                description: A jsonpath indexing into the spec object on the API resource where the the spec value can be found.
   273                              displayName:
   274                                type: string
   275                                description: A human-readable name for the spec entry.
   276                              description:
   277                                type: string
   278                                description: A description of the spec entry.
   279                              x-descriptors:
   280                                type: array
   281                                description: A list of descriptors for the spec entry that indicate the meaning of the field.
   282                                items:
   283                                  type: string
   284                              value:
   285                                type: object
   286                                description: If present, the value of this spec is the same for all instances of the API Resource and can be found here instead of on the API resource.
   287                        actionDescriptors:
   288                          type: array
   289                          items:
   290                            type: object
   291                            description: A spec for actions that can be performed on instances of the API resource
   292                            required:
   293                            - path
   294                            - displayName
   295                            - description
   296                            properties:
   297                              path:
   298                                type: string
   299                                description: A jsonpath indexing into the spec object on the API resource where the the spec value can be found.
   300                              displayName:
   301                                type: string
   302                                description: A human-readable name for the action.
   303                              description:
   304                                type: string
   305                                description: A description of the action.
   306                              x-descriptors:
   307                                type: array
   308                                description: A list of descriptors for the action that indicate the meaning of the action.
   309                                items:
   310                                  type: string
   311                              value:
   312                                type: object
   313                                description: If present, the value of this action is the same for all instances of the API resource and can be found here instead of on the API resource.
   314                  required:
   315                    type: array
   316                    description: What resources this operator is responsible for managing. No two running operators should manage the same resource.
   317                    items:
   318                      type: object
   319                      required:
   320                      - name
   321                      - version
   322                      - kind
   323                      - displayName
   324                      - description
   325                      properties:
   326                        name:
   327                          type: string
   328                          description: Fully qualified name of the APIService (e.g. my-resource-v1.app.coreos.com)
   329                        version:
   330                          type: string
   331                          description: The version field of the APIService
   332                        kind:
   333                          type: string
   334                          description: The kind field of the APIService
   335                        displayName:
   336                          type: string
   337                          description: A human-readable name for the APIService.
   338                        description:
   339                          type: string
   340                          description: A description of the APIService
   341                        statusDescriptors:
   342                          type: array
   343                          items:
   344                            type: object
   345                            description: A spec for a field in the status block of the APIService
   346                            required:
   347                            - path
   348                            - displayName
   349                            - description
   350                            properties:
   351                              path:
   352                                type: string
   353                                description: A jsonpath indexing into the status object on the API Resource where the the status value can be found.
   354                              displayName:
   355                                type: string
   356                                description: A human-readable name for the status entry.
   357                              description:
   358                                type: string
   359                                description: A description of the status entry.
   360                              x-descriptors:
   361                                type: array
   362                                description: A list of descriptors for the status entry that indicate the meaning of the field.
   363                                items:
   364                                  type: string
   365                              value:
   366                                type: object
   367                                description: If present, the value of this status is the same for all instances of the API Resource and can be found here instead of on the API Resource.
   368  
   369              customresourcedefinitions:
   370                type: object
   371                properties:
   372                  owned:
   373                    type: array
   374                    description: What resources this operator is responsible for managing. No two running operators should manage the same resource.
   375                    items:
   376                      type: object
   377                      required:
   378                        - name
   379                        - version
   380                        - kind
   381                        - displayName
   382                        - description
   383                      properties:
   384                        name:
   385                          type: string
   386                          description: Fully qualified name of the CustomResourceDefinition (e.g. my-resource-v1.app.coreos.com)
   387                        version:
   388                          type: string
   389                          description: The version field of the CustomResourceDefinition
   390                        kind:
   391                          type: string
   392                          description: The kind field of the CustomResourceDefinition
   393                        displayName:
   394                          type: string
   395                          description: A human-readable name for the CRD.
   396                        description:
   397                          type: string
   398                          description: A description of the CRD
   399                        resources:
   400                          type: array
   401                          items:
   402                            type: object
   403                            description: A list of resources that should be displayed for the CRD
   404                            required:
   405                              - kind
   406                              - version
   407                            properties:
   408                              name:
   409                                type: string
   410                                description: If a CRD, the fully qualified name of the CustomResourceDefinition (e.g. my-resource-v1.app.coreos.com)
   411                              version:
   412                                type: string
   413                                description: The version of the resource kind
   414                              kind:
   415                                type: string
   416                                description: The kind field of the resource kind
   417                        statusDescriptors:
   418                          type: array
   419                          items:
   420                            type: object
   421                            description: A spec for a field in the status block of the CRD
   422                            required:
   423                              - path
   424                              - displayName
   425                              - description
   426                            properties:
   427                              path:
   428                                type: string
   429                                description: A jsonpath indexing into the status object on the CR where the the status value can be found.
   430                              displayName:
   431                                type: string
   432                                description: A human-readable name for the status entry.
   433                              description:
   434                                type: string
   435                                description: A description of the status entry.
   436                              x-descriptors:
   437                                type: array
   438                                description: A list of descriptors for the status entry that indicate the meaning of the field.
   439                                items:
   440                                  type: string
   441                              value:
   442                                type: object
   443                                description: If present, the value of this status is the same for all instances of the CRD and can be found here instead of on the CR.
   444                        specDescriptors:
   445                          type: array
   446                          items:
   447                            type: object
   448                            description: A spec for a field in the spec block of the CRD
   449                            required:
   450                              - path
   451                              - displayName
   452                              - description
   453                            properties:
   454                              path:
   455                                type: string
   456                                description: A jsonpath indexing into the spec object on the CR where the the spec value can be found.
   457                              displayName:
   458                                type: string
   459                                description: A human-readable name for the spec entry.
   460                              description:
   461                                type: string
   462                                description: A description of the spec entry.
   463                              x-descriptors:
   464                                type: array
   465                                description: A list of descriptors for the spec entry that indicate the meaning of the field.
   466                                items:
   467                                  type: string
   468                              value:
   469                                type: object
   470                                description: If present, the value of this spec is the same for all instances of the CRD and can be found here instead of on the CR.
   471                        actionDescriptors:
   472                          type: array
   473                          items:
   474                            type: object
   475                            description: A spec for actions that can be performed on instances of the CRD
   476                            required:
   477                              - path
   478                              - displayName
   479                              - description
   480                            properties:
   481                              path:
   482                                type: string
   483                                description: A jsonpath indexing into the spec object on the CR where the the spec value can be found.
   484                              displayName:
   485                                type: string
   486                                description: A human-readable name for the action.
   487                              description:
   488                                type: string
   489                                description: A description of the action.
   490                              x-descriptors:
   491                                type: array
   492                                description: A list of descriptors for the action that indicate the meaning of the action.
   493                                items:
   494                                  type: string
   495                              value:
   496                                type: object
   497                                description: If present, the value of this action is the same for all instances of the CRD and can be found here instead of on the CR.
   498                  required:
   499                    type: array
   500                    description: What resources this operator is responsible for managing. No two running operators should manage the same resource.
   501                    items:
   502                      type: object
   503                      required:
   504                        - name
   505                        - version
   506                        - kind
   507                        - displayName
   508                        - description
   509                      properties:
   510                        name:
   511                          type: string
   512                          description: Fully qualified name of the CustomResourceDefinition (e.g. my-resource-v1.app.coreos.com)
   513                        version:
   514                          type: string
   515                          description: The version field of the CustomResourceDefinition
   516                        kind:
   517                          type: string
   518                          description: The kind field of the CustomResourceDefinition
   519                        displayName:
   520                          type: string
   521                          description: A human-readable name for the CRD.
   522                        description:
   523                          type: string
   524                          description: A description of the CRD
   525                        statusDescriptors:
   526                          type: array
   527                          items:
   528                            type: object
   529                            description: A spec for a field in the status block of the CRD
   530                            required:
   531                              - path
   532                              - displayName
   533                              - description
   534                            properties:
   535                              path:
   536                                type: string
   537                                description: A jsonpath indexing into the status object on the CR where the the status value can be found.
   538                              displayName:
   539                                type: string
   540                                description: A human-readable name for the status entry.
   541                              description:
   542                                type: string
   543                                description: A description of the status entry.
   544                              x-descriptors:
   545                                type: array
   546                                description: A list of descriptors for the status entry that indicate the meaning of the field.
   547                                items:
   548                                  type: string
   549                              value:
   550                                type: object
   551                                description: If present, the value of this status is the same for all instances of the CRD and can be found here instead of on the CR.
   552  
   553  
   554              install:
   555                type: object
   556                description: Information required to install this specific version of the operator software
   557                oneOf:
   558                - type: object
   559                  required:
   560                  - strategy
   561                  - spec
   562                  properties:
   563                    strategy:
   564                      type: string
   565                      enum: ['image']
   566                    spec:
   567                      type: object
   568                      required:
   569                      - image
   570                      properties:
   571                        image:
   572                          type: string
   573                - type: object
   574                  required:
   575                  - strategy
   576                  - spec
   577                  properties:
   578                    strategy:
   579                      type: string
   580                      enum: ['deployment']
   581                    spec:
   582                      type: object
   583                      required:
   584                      - deployments
   585                      properties:
   586                        deployments:
   587                          type: array
   588                          description: List of deployments to create
   589                          items:
   590                            type: object
   591                            description: A name and deployment to create in the cluster
   592                            required:
   593                              - name
   594                              - spec
   595                            properties:
   596                              name:
   597                                type: string
   598                                description: the consistent name of the deployment
   599                              spec:
   600                                type: object
   601                                description: The deployment spec to create in the cluster
   602                        permissions:
   603                          type: array
   604                          description: Permissions needed by the deployement to run correctly
   605                          items:
   606                            type: object
   607                            required:
   608                              - serviceAccountName
   609                              - rules
   610                            properties:
   611                              serviceAccountName:
   612                                type: string
   613                                description: The service account name to create for the deployment
   614                              rules:
   615                                type: array
   616                                items:
   617                                  type: object
   618                                  description: a rule required by the service account
   619                                  properties:
   620                                    apiGroups:
   621                                      type: array
   622                                      description: apiGroups the rule applies to
   623                                      items:
   624                                        type: string
   625                                    resources:
   626                                      type: array
   627                                      items:
   628                                        type: string
   629                                    resourceNames:
   630                                      type: array
   631                                      items:
   632                                        type: string
   633                                    verbs:
   634                                      type: array
   635                                      items:
   636                                        type: string
   637                                        enum:
   638                                          - "*"
   639                                          - get
   640                                          - list
   641                                          - watch
   642                                          - create
   643                                          - update
   644                                          - patch
   645                                          - delete
   646                                          - deletecollection
   647                        clusterPermissions:
   648                          type: array
   649                          description: Cluster permissions needed by the deployement to run correctly
   650                          items:
   651                            type: object
   652                            required:
   653                            - serviceAccountName
   654                            - rules
   655                            properties:
   656                              serviceAccountName:
   657                                type: string
   658                                description: The service account name to create for the deployment
   659                              rules:
   660                                type: array
   661                                items:
   662                                  type: object
   663                                  description: a rule required by the service account
   664                                  properties:
   665                                    apiGroups:
   666                                      type: array
   667                                      description: apiGroups the rule applies to
   668                                      items:
   669                                        type: string
   670                                    resources:
   671                                      type: array
   672                                      items:
   673                                        type: string
   674                                    resourceNames:
   675                                      type: array
   676                                      items:
   677                                        type: string
   678                                    verbs:
   679                                      type: array
   680                                      items:
   681                                        type: string
   682                                        enum:
   683                                        - "*"
   684                                        - get
   685                                        - list
   686                                        - watch
   687                                        - create
   688                                        - update
   689                                        - patch
   690                                        - delete
   691                                        - deletecollection
   692          status:
   693            type: object
   694            description: Status for a ClusterServiceVersion