sigs.k8s.io/cluster-api/bootstrap/kubeadm@v0.0.0-20191016155141-23a891785b60/config-capi/crds/cluster.sigs.k8s.io_machinesets.yaml (about)

     1  
     2  ---
     3  apiVersion: apiextensions.k8s.io/v1beta1
     4  kind: CustomResourceDefinition
     5  metadata:
     6    creationTimestamp: null
     7    name: machinesets.cluster.sigs.k8s.io
     8  spec:
     9    group: cluster.sigs.k8s.io
    10    names:
    11      kind: MachineSet
    12      plural: machinesets
    13      shortNames:
    14      - ms
    15    scope: Namespaced
    16    subresources:
    17      scale:
    18        labelSelectorPath: .status.labelSelector
    19        specReplicasPath: .spec.replicas
    20        statusReplicasPath: .status.replicas
    21      status: {}
    22    validation:
    23      openAPIV3Schema:
    24        description: / [MachineSet] MachineSet ensures that a specified number of machines
    25          replicas are running at any given time.
    26        properties:
    27          apiVersion:
    28            description: 'APIVersion defines the versioned schema of this representation
    29              of an object. Servers should convert recognized schemas to the latest
    30              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#resources'
    31            type: string
    32          kind:
    33            description: 'Kind is a string value representing the REST resource this
    34              object represents. Servers may infer this from the endpoint the client
    35              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
    36            type: string
    37          metadata:
    38            description: ObjectMeta is metadata that all persisted resources must have,
    39              which includes all objects users must create.
    40            properties:
    41              annotations:
    42                additionalProperties:
    43                  type: string
    44                description: 'Annotations is an unstructured key value map stored with
    45                  a resource that may be set by external tools to store and retrieve
    46                  arbitrary metadata. They are not queryable and should be preserved
    47                  when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations'
    48                type: object
    49              clusterName:
    50                description: The name of the cluster which the object belongs to. This
    51                  is used to distinguish resources with same name and namespace in different
    52                  clusters. This field is not set anywhere right now and apiserver is
    53                  going to ignore it if set in create or update request.
    54                type: string
    55              creationTimestamp:
    56                description: "CreationTimestamp is a timestamp representing the server
    57                  time when this object was created. It is not guaranteed to be set
    58                  in happens-before order across separate operations. Clients may not
    59                  set this value. It is represented in RFC3339 form and is in UTC. \n
    60                  Populated by the system. Read-only. Null for lists. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata"
    61                format: date-time
    62                type: string
    63              deletionGracePeriodSeconds:
    64                description: Number of seconds allowed for this object to gracefully
    65                  terminate before it will be removed from the system. Only set when
    66                  deletionTimestamp is also set. May only be shortened. Read-only.
    67                format: int64
    68                type: integer
    69              deletionTimestamp:
    70                description: "DeletionTimestamp is RFC 3339 date and time at which this
    71                  resource will be deleted. This field is set by the server when a graceful
    72                  deletion is requested by the user, and is not directly settable by
    73                  a client. The resource is expected to be deleted (no longer visible
    74                  from resource lists, and not reachable by name) after the time in
    75                  this field, once the finalizers list is empty. As long as the finalizers
    76                  list contains items, deletion is blocked. Once the deletionTimestamp
    77                  is set, this value may not be unset or be set further into the future,
    78                  although it may be shortened or the resource may be deleted prior
    79                  to this time. For example, a user may request that a pod is deleted
    80                  in 30 seconds. The Kubelet will react by sending a graceful termination
    81                  signal to the containers in the pod. After that 30 seconds, the Kubelet
    82                  will send a hard termination signal (SIGKILL) to the container and
    83                  after cleanup, remove the pod from the API. In the presence of network
    84                  partitions, this object may still exist after this timestamp, until
    85                  an administrator or automated process can determine the resource is
    86                  fully terminated. If not set, graceful deletion of the object has
    87                  not been requested. \n Populated by the system when a graceful deletion
    88                  is requested. Read-only. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata"
    89                format: date-time
    90                type: string
    91              finalizers:
    92                description: Must be empty before the object is deleted from the registry.
    93                  Each entry is an identifier for the responsible component that will
    94                  remove the entry from the list. If the deletionTimestamp of the object
    95                  is non-nil, entries in this list can only be removed.
    96                items:
    97                  type: string
    98                type: array
    99              generateName:
   100                description: "GenerateName is an optional prefix, used by the server,
   101                  to generate a unique name ONLY IF the Name field has not been provided.
   102                  If this field is used, the name returned to the client will be different
   103                  than the name passed. This value will also be combined with a unique
   104                  suffix. The provided value has the same validation rules as the Name
   105                  field, and may be truncated by the length of the suffix required to
   106                  make the value unique on the server. \n If this field is specified
   107                  and the generated name exists, the server will NOT return a 409 -
   108                  instead, it will either return 201 Created or 500 with Reason ServerTimeout
   109                  indicating a unique name could not be found in the time allotted,
   110                  and the client should retry (optionally after the time indicated in
   111                  the Retry-After header). \n Applied only if Name is not specified.
   112                  More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency"
   113                type: string
   114              generation:
   115                description: A sequence number representing a specific generation of
   116                  the desired state. Populated by the system. Read-only.
   117                format: int64
   118                type: integer
   119              initializers:
   120                description: "An initializer is a controller which enforces some system
   121                  invariant at object creation time. This field is a list of initializers
   122                  that have not yet acted on this object. If nil or empty, this object
   123                  has been completely initialized. Otherwise, the object is considered
   124                  uninitialized and is hidden (in list/watch and get calls) from clients
   125                  that haven't explicitly asked to observe uninitialized objects. \n
   126                  When an object is created, the system will populate this list with
   127                  the current set of initializers. Only privileged users may set or
   128                  modify this list. Once it is empty, it may not be modified further
   129                  by any user. \n DEPRECATED - initializers are an alpha field and will
   130                  be removed in v1.15."
   131                properties:
   132                  pending:
   133                    description: Pending is a list of initializers that must execute
   134                      in order before this object is visible. When the last pending
   135                      initializer is removed, and no failing result is set, the initializers
   136                      struct will be set to nil and the object is considered as initialized
   137                      and visible to all clients.
   138                    items:
   139                      description: Initializer is information about an initializer that
   140                        has not yet completed.
   141                      properties:
   142                        name:
   143                          description: name of the process that is responsible for initializing
   144                            this object.
   145                          type: string
   146                      required:
   147                      - name
   148                      type: object
   149                    type: array
   150                  result:
   151                    description: If result is set with the Failure field, the object
   152                      will be persisted to storage and then deleted, ensuring that other
   153                      clients can observe the deletion.
   154                    properties:
   155                      apiVersion:
   156                        description: 'APIVersion defines the versioned schema of this
   157                          representation of an object. Servers should convert recognized
   158                          schemas to the latest internal value, and may reject unrecognized
   159                          values. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#resources'
   160                        type: string
   161                      code:
   162                        description: Suggested HTTP return code for this status, 0 if
   163                          not set.
   164                        format: int32
   165                        type: integer
   166                      details:
   167                        description: Extended data associated with the reason.  Each
   168                          reason may define its own extended details. This field is
   169                          optional and the data returned is not guaranteed to conform
   170                          to any schema except that defined by the reason type.
   171                        properties:
   172                          causes:
   173                            description: The Causes array includes more details associated
   174                              with the StatusReason failure. Not all StatusReasons may
   175                              provide detailed causes.
   176                            items:
   177                              description: StatusCause provides more information about
   178                                an api.Status failure, including cases when multiple
   179                                errors are encountered.
   180                              properties:
   181                                field:
   182                                  description: "The field of the resource that has caused
   183                                    this error, as named by its JSON serialization.
   184                                    May include dot and postfix notation for nested
   185                                    attributes. Arrays are zero-indexed.  Fields may
   186                                    appear more than once in an array of causes due
   187                                    to fields having multiple errors. Optional. \n Examples:
   188                                    \  \"name\" - the field \"name\" on the current
   189                                    resource   \"items[0].name\" - the field \"name\"
   190                                    on the first array entry in \"items\""
   191                                  type: string
   192                                message:
   193                                  description: A human-readable description of the cause
   194                                    of the error.  This field may be presented as-is
   195                                    to a reader.
   196                                  type: string
   197                                reason:
   198                                  description: A machine-readable description of the
   199                                    cause of the error. If this value is empty there
   200                                    is no information available.
   201                                  type: string
   202                              type: object
   203                            type: array
   204                          group:
   205                            description: The group attribute of the resource associated
   206                              with the status StatusReason.
   207                            type: string
   208                          kind:
   209                            description: 'The kind attribute of the resource associated
   210                              with the status StatusReason. On some operations may differ
   211                              from the requested resource Kind. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   212                            type: string
   213                          name:
   214                            description: The name attribute of the resource associated
   215                              with the status StatusReason (when there is a single name
   216                              which can be described).
   217                            type: string
   218                          retryAfterSeconds:
   219                            description: If specified, the time in seconds before the
   220                              operation should be retried. Some errors may indicate
   221                              the client must take an alternate action - for those errors
   222                              this field may indicate how long to wait before taking
   223                              the alternate action.
   224                            format: int32
   225                            type: integer
   226                          uid:
   227                            description: 'UID of the resource. (when there is a single
   228                              resource which can be described). More info: http://kubernetes.io/docs/user-guide/identifiers#uids'
   229                            type: string
   230                        type: object
   231                      kind:
   232                        description: 'Kind is a string value representing the REST resource
   233                          this object represents. Servers may infer this from the endpoint
   234                          the client submits requests to. Cannot be updated. In CamelCase.
   235                          More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   236                        type: string
   237                      message:
   238                        description: A human-readable description of the status of this
   239                          operation.
   240                        type: string
   241                      metadata:
   242                        description: 'Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   243                        properties:
   244                          continue:
   245                            description: continue may be set if the user set a limit
   246                              on the number of items returned, and indicates that the
   247                              server has more data available. The value is opaque and
   248                              may be used to issue another request to the endpoint that
   249                              served this list to retrieve the next set of available
   250                              objects. Continuing a consistent list may not be possible
   251                              if the server configuration has changed or more than a
   252                              few minutes have passed. The resourceVersion field returned
   253                              when using this continue value will be identical to the
   254                              value in the first response, unless you have received
   255                              this token from an error message.
   256                            type: string
   257                          resourceVersion:
   258                            description: 'String that identifies the server''s internal
   259                              version of this object that can be used by clients to
   260                              determine when objects have changed. Value must be treated
   261                              as opaque by clients and passed unmodified back to the
   262                              server. Populated by the system. Read-only. More info:
   263                              https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency'
   264                            type: string
   265                          selfLink:
   266                            description: selfLink is a URL representing this object.
   267                              Populated by the system. Read-only.
   268                            type: string
   269                        type: object
   270                      reason:
   271                        description: A machine-readable description of why this operation
   272                          is in the "Failure" status. If this value is empty there is
   273                          no information available. A Reason clarifies an HTTP status
   274                          code but does not override it.
   275                        type: string
   276                      status:
   277                        description: 'Status of the operation. One of: "Success" or
   278                          "Failure". More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status'
   279                        type: string
   280                    type: object
   281                required:
   282                - pending
   283                type: object
   284              labels:
   285                additionalProperties:
   286                  type: string
   287                description: 'Map of string keys and values that can be used to organize
   288                  and categorize (scope and select) objects. May match selectors of
   289                  replication controllers and services. More info: http://kubernetes.io/docs/user-guide/labels'
   290                type: object
   291              managedFields:
   292                description: "ManagedFields maps workflow-id and version to the set
   293                  of fields that are managed by that workflow. This is mostly for internal
   294                  housekeeping, and users typically shouldn't need to set or understand
   295                  this field. A workflow can be the user's name, a controller's name,
   296                  or the name of a specific apply path like \"ci-cd\". The set of fields
   297                  is always in the version that the workflow used when modifying the
   298                  object. \n This field is alpha and can be changed or removed without
   299                  notice."
   300                items:
   301                  description: ManagedFieldsEntry is a workflow-id, a FieldSet and the
   302                    group version of the resource that the fieldset applies to.
   303                  properties:
   304                    apiVersion:
   305                      description: APIVersion defines the version of this resource that
   306                        this field set applies to. The format is "group/version" just
   307                        like the top-level APIVersion field. It is necessary to track
   308                        the version of a field set because it cannot be automatically
   309                        converted.
   310                      type: string
   311                    fields:
   312                      additionalProperties: true
   313                      description: Fields identifies a set of fields.
   314                      type: object
   315                    manager:
   316                      description: Manager is an identifier of the workflow managing
   317                        these fields.
   318                      type: string
   319                    operation:
   320                      description: Operation is the type of operation which lead to
   321                        this ManagedFieldsEntry being created. The only valid values
   322                        for this field are 'Apply' and 'Update'.
   323                      type: string
   324                    time:
   325                      description: Time is timestamp of when these fields were set.
   326                        It should always be empty if Operation is 'Apply'
   327                      format: date-time
   328                      type: string
   329                  type: object
   330                type: array
   331              name:
   332                description: 'Name must be unique within a namespace. Is required when
   333                  creating resources, although some resources may allow a client to
   334                  request the generation of an appropriate name automatically. Name
   335                  is primarily intended for creation idempotence and configuration definition.
   336                  Cannot be updated. More info: http://kubernetes.io/docs/user-guide/identifiers#names'
   337                type: string
   338              namespace:
   339                description: "Namespace defines the space within each name must be unique.
   340                  An empty namespace is equivalent to the \"default\" namespace, but
   341                  \"default\" is the canonical representation. Not all objects are required
   342                  to be scoped to a namespace - the value of this field for those objects
   343                  will be empty. \n Must be a DNS_LABEL. Cannot be updated. More info:
   344                  http://kubernetes.io/docs/user-guide/namespaces"
   345                type: string
   346              ownerReferences:
   347                description: List of objects depended by this object. If ALL objects
   348                  in the list have been deleted, this object will be garbage collected.
   349                  If this object is managed by a controller, then an entry in this list
   350                  will point to this controller, with the controller field set to true.
   351                  There cannot be more than one managing controller.
   352                items:
   353                  description: OwnerReference contains enough information to let you
   354                    identify an owning object. An owning object must be in the same
   355                    namespace as the dependent, or be cluster-scoped, so there is no
   356                    namespace field.
   357                  properties:
   358                    apiVersion:
   359                      description: API version of the referent.
   360                      type: string
   361                    blockOwnerDeletion:
   362                      description: If true, AND if the owner has the "foregroundDeletion"
   363                        finalizer, then the owner cannot be deleted from the key-value
   364                        store until this reference is removed. Defaults to false. To
   365                        set this field, a user needs "delete" permission of the owner,
   366                        otherwise 422 (Unprocessable Entity) will be returned.
   367                      type: boolean
   368                    controller:
   369                      description: If true, this reference points to the managing controller.
   370                      type: boolean
   371                    kind:
   372                      description: 'Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   373                      type: string
   374                    name:
   375                      description: 'Name of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#names'
   376                      type: string
   377                    uid:
   378                      description: 'UID of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#uids'
   379                      type: string
   380                  required:
   381                  - apiVersion
   382                  - kind
   383                  - name
   384                  - uid
   385                  type: object
   386                type: array
   387              resourceVersion:
   388                description: "An opaque value that represents the internal version of
   389                  this object that can be used by clients to determine when objects
   390                  have changed. May be used for optimistic concurrency, change detection,
   391                  and the watch operation on a resource or set of resources. Clients
   392                  must treat these values as opaque and passed unmodified back to the
   393                  server. They may only be valid for a particular resource or set of
   394                  resources. \n Populated by the system. Read-only. Value must be treated
   395                  as opaque by clients and . More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency"
   396                type: string
   397              selfLink:
   398                description: SelfLink is a URL representing this object. Populated by
   399                  the system. Read-only.
   400                type: string
   401              uid:
   402                description: "UID is the unique in time and space value for this object.
   403                  It is typically generated by the server on successful creation of
   404                  a resource and is not allowed to change on PUT operations. \n Populated
   405                  by the system. Read-only. More info: http://kubernetes.io/docs/user-guide/identifiers#uids"
   406                type: string
   407            type: object
   408          spec:
   409            description: / [MachineSetSpec] MachineSetSpec defines the desired state
   410              of MachineSet
   411            properties:
   412              deletePolicy:
   413                description: DeletePolicy defines the policy used to identify nodes
   414                  to delete when downscaling. Defaults to "Random".  Valid values are
   415                  "Random, "Newest", "Oldest"
   416                enum:
   417                - Random
   418                - Newest
   419                - Oldest
   420                type: string
   421              minReadySeconds:
   422                description: MinReadySeconds is the minimum number of seconds for which
   423                  a newly created machine should be ready. Defaults to 0 (machine will
   424                  be considered available as soon as it is ready)
   425                format: int32
   426                type: integer
   427              replicas:
   428                description: Replicas is the number of desired replicas. This is a pointer
   429                  to distinguish between explicit zero and unspecified. Defaults to
   430                  1.
   431                format: int32
   432                type: integer
   433              selector:
   434                description: 'Selector is a label query over machines that should match
   435                  the replica count. Label keys and values that must match in order
   436                  to be controlled by this MachineSet. It must match the machine template''s
   437                  labels. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors'
   438                properties:
   439                  matchExpressions:
   440                    description: matchExpressions is a list of label selector requirements.
   441                      The requirements are ANDed.
   442                    items:
   443                      description: A label selector requirement is a selector that contains
   444                        values, a key, and an operator that relates the key and values.
   445                      properties:
   446                        key:
   447                          description: key is the label key that the selector applies
   448                            to.
   449                          type: string
   450                        operator:
   451                          description: operator represents a key's relationship to a
   452                            set of values. Valid operators are In, NotIn, Exists and
   453                            DoesNotExist.
   454                          type: string
   455                        values:
   456                          description: values is an array of string values. If the operator
   457                            is In or NotIn, the values array must be non-empty. If the
   458                            operator is Exists or DoesNotExist, the values array must
   459                            be empty. This array is replaced during a strategic merge
   460                            patch.
   461                          items:
   462                            type: string
   463                          type: array
   464                      required:
   465                      - key
   466                      - operator
   467                      type: object
   468                    type: array
   469                  matchLabels:
   470                    additionalProperties:
   471                      type: string
   472                    description: matchLabels is a map of {key,value} pairs. A single
   473                      {key,value} in the matchLabels map is equivalent to an element
   474                      of matchExpressions, whose key field is "key", the operator is
   475                      "In", and the values array contains only "value". The requirements
   476                      are ANDed.
   477                    type: object
   478                type: object
   479              template:
   480                description: Template is the object that describes the machine that
   481                  will be created if insufficient replicas are detected. Object references
   482                  to custom resources resources are treated as templates.
   483                properties:
   484                  metadata:
   485                    description: 'Standard object''s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata'
   486                    properties:
   487                      annotations:
   488                        additionalProperties:
   489                          type: string
   490                        description: 'Annotations is an unstructured key value map stored
   491                          with a resource that may be set by external tools to store
   492                          and retrieve arbitrary metadata. They are not queryable and
   493                          should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations'
   494                        type: object
   495                      generateName:
   496                        description: "GenerateName is an optional prefix, used by the
   497                          server, to generate a unique name ONLY IF the Name field has
   498                          not been provided. If this field is used, the name returned
   499                          to the client will be different than the name passed. This
   500                          value will also be combined with a unique suffix. The provided
   501                          value has the same validation rules as the Name field, and
   502                          may be truncated by the length of the suffix required to make
   503                          the value unique on the server. \n If this field is specified
   504                          and the generated name exists, the server will NOT return
   505                          a 409 - instead, it will either return 201 Created or 500
   506                          with Reason ServerTimeout indicating a unique name could not
   507                          be found in the time allotted, and the client should retry
   508                          (optionally after the time indicated in the Retry-After header).
   509                          \n Applied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency"
   510                        type: string
   511                      labels:
   512                        additionalProperties:
   513                          type: string
   514                        description: 'Map of string keys and values that can be used
   515                          to organize and categorize (scope and select) objects. May
   516                          match selectors of replication controllers and services. More
   517                          info: http://kubernetes.io/docs/user-guide/labels'
   518                        type: object
   519                      name:
   520                        description: 'Name must be unique within a namespace. Is required
   521                          when creating resources, although some resources may allow
   522                          a client to request the generation of an appropriate name
   523                          automatically. Name is primarily intended for creation idempotence
   524                          and configuration definition. Cannot be updated. More info:
   525                          http://kubernetes.io/docs/user-guide/identifiers#names'
   526                        type: string
   527                      namespace:
   528                        description: "Namespace defines the space within each name must
   529                          be unique. An empty namespace is equivalent to the \"default\"
   530                          namespace, but \"default\" is the canonical representation.
   531                          Not all objects are required to be scoped to a namespace -
   532                          the value of this field for those objects will be empty. \n
   533                          Must be a DNS_LABEL. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/namespaces"
   534                        type: string
   535                      ownerReferences:
   536                        description: List of objects depended by this object. If ALL
   537                          objects in the list have been deleted, this object will be
   538                          garbage collected. If this object is managed by a controller,
   539                          then an entry in this list will point to this controller,
   540                          with the controller field set to true. There cannot be more
   541                          than one managing controller.
   542                        items:
   543                          description: OwnerReference contains enough information to
   544                            let you identify an owning object. An owning object must
   545                            be in the same namespace as the dependent, or be cluster-scoped,
   546                            so there is no namespace field.
   547                          properties:
   548                            apiVersion:
   549                              description: API version of the referent.
   550                              type: string
   551                            blockOwnerDeletion:
   552                              description: If true, AND if the owner has the "foregroundDeletion"
   553                                finalizer, then the owner cannot be deleted from the
   554                                key-value store until this reference is removed. Defaults
   555                                to false. To set this field, a user needs "delete" permission
   556                                of the owner, otherwise 422 (Unprocessable Entity) will
   557                                be returned.
   558                              type: boolean
   559                            controller:
   560                              description: If true, this reference points to the managing
   561                                controller.
   562                              type: boolean
   563                            kind:
   564                              description: 'Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   565                              type: string
   566                            name:
   567                              description: 'Name of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#names'
   568                              type: string
   569                            uid:
   570                              description: 'UID of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#uids'
   571                              type: string
   572                          required:
   573                          - apiVersion
   574                          - kind
   575                          - name
   576                          - uid
   577                          type: object
   578                        type: array
   579                    type: object
   580                  spec:
   581                    description: 'Specification of the desired behavior of the machine.
   582                      More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status'
   583                    properties:
   584                      bootstrap:
   585                        description: Bootstrap is a reference to a local struct which
   586                          encapsulates fields to configure the Machine’s bootstrapping
   587                          mechanism.
   588                        properties:
   589                          configRef:
   590                            description: ConfigRef is a reference to a bootstrap provider-specific
   591                              resource that holds configuration details. The reference
   592                              is optional to allow users/operators to specify Bootstrap.Data
   593                              without the need of a controller.
   594                            properties:
   595                              apiVersion:
   596                                description: API version of the referent.
   597                                type: string
   598                              fieldPath:
   599                                description: 'If referring to a piece of an object instead
   600                                  of an entire object, this string should contain a
   601                                  valid JSON/Go field access statement, such as desiredState.manifest.containers[2].
   602                                  For example, if the object reference is to a container
   603                                  within a pod, this would take on a value like: "spec.containers{name}"
   604                                  (where "name" refers to the name of the container
   605                                  that triggered the event) or if no container name
   606                                  is specified "spec.containers[2]" (container with
   607                                  index 2 in this pod). This syntax is chosen only to
   608                                  have some well-defined way of referencing a part of
   609                                  an object. TODO: this design is not final and this
   610                                  field is subject to change in the future.'
   611                                type: string
   612                              kind:
   613                                description: 'Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   614                                type: string
   615                              name:
   616                                description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names'
   617                                type: string
   618                              namespace:
   619                                description: 'Namespace of the referent. More info:
   620                                  https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/'
   621                                type: string
   622                              resourceVersion:
   623                                description: 'Specific resourceVersion to which this
   624                                  reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency'
   625                                type: string
   626                              uid:
   627                                description: 'UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids'
   628                                type: string
   629                            type: object
   630                          data:
   631                            description: Data contains the bootstrap data, such as cloud-init
   632                              details scripts. If nil, the Machine should remain in
   633                              the Pending state.
   634                            type: string
   635                        type: object
   636                      infrastructureRef:
   637                        description: InfrastructureRef is a required reference to a
   638                          custom resource offered by an infrastructure provider.
   639                        properties:
   640                          apiVersion:
   641                            description: API version of the referent.
   642                            type: string
   643                          fieldPath:
   644                            description: 'If referring to a piece of an object instead
   645                              of an entire object, this string should contain a valid
   646                              JSON/Go field access statement, such as desiredState.manifest.containers[2].
   647                              For example, if the object reference is to a container
   648                              within a pod, this would take on a value like: "spec.containers{name}"
   649                              (where "name" refers to the name of the container that
   650                              triggered the event) or if no container name is specified
   651                              "spec.containers[2]" (container with index 2 in this pod).
   652                              This syntax is chosen only to have some well-defined way
   653                              of referencing a part of an object. TODO: this design
   654                              is not final and this field is subject to change in the
   655                              future.'
   656                            type: string
   657                          kind:
   658                            description: 'Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   659                            type: string
   660                          name:
   661                            description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names'
   662                            type: string
   663                          namespace:
   664                            description: 'Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/'
   665                            type: string
   666                          resourceVersion:
   667                            description: 'Specific resourceVersion to which this reference
   668                              is made, if any. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency'
   669                            type: string
   670                          uid:
   671                            description: 'UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids'
   672                            type: string
   673                        type: object
   674                      metadata:
   675                        description: ObjectMeta will autopopulate the Node created.
   676                          Use this to indicate what labels, annotations, name prefix,
   677                          etc., should be used when creating the Node.
   678                        properties:
   679                          annotations:
   680                            additionalProperties:
   681                              type: string
   682                            description: 'Annotations is an unstructured key value map
   683                              stored with a resource that may be set by external tools
   684                              to store and retrieve arbitrary metadata. They are not
   685                              queryable and should be preserved when modifying objects.
   686                              More info: http://kubernetes.io/docs/user-guide/annotations'
   687                            type: object
   688                          generateName:
   689                            description: "GenerateName is an optional prefix, used by
   690                              the server, to generate a unique name ONLY IF the Name
   691                              field has not been provided. If this field is used, the
   692                              name returned to the client will be different than the
   693                              name passed. This value will also be combined with a unique
   694                              suffix. The provided value has the same validation rules
   695                              as the Name field, and may be truncated by the length
   696                              of the suffix required to make the value unique on the
   697                              server. \n If this field is specified and the generated
   698                              name exists, the server will NOT return a 409 - instead,
   699                              it will either return 201 Created or 500 with Reason ServerTimeout
   700                              indicating a unique name could not be found in the time
   701                              allotted, and the client should retry (optionally after
   702                              the time indicated in the Retry-After header). \n Applied
   703                              only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency"
   704                            type: string
   705                          labels:
   706                            additionalProperties:
   707                              type: string
   708                            description: 'Map of string keys and values that can be
   709                              used to organize and categorize (scope and select) objects.
   710                              May match selectors of replication controllers and services.
   711                              More info: http://kubernetes.io/docs/user-guide/labels'
   712                            type: object
   713                          name:
   714                            description: 'Name must be unique within a namespace. Is
   715                              required when creating resources, although some resources
   716                              may allow a client to request the generation of an appropriate
   717                              name automatically. Name is primarily intended for creation
   718                              idempotence and configuration definition. Cannot be updated.
   719                              More info: http://kubernetes.io/docs/user-guide/identifiers#names'
   720                            type: string
   721                          namespace:
   722                            description: "Namespace defines the space within each name
   723                              must be unique. An empty namespace is equivalent to the
   724                              \"default\" namespace, but \"default\" is the canonical
   725                              representation. Not all objects are required to be scoped
   726                              to a namespace - the value of this field for those objects
   727                              will be empty. \n Must be a DNS_LABEL. Cannot be updated.
   728                              More info: http://kubernetes.io/docs/user-guide/namespaces"
   729                            type: string
   730                          ownerReferences:
   731                            description: List of objects depended by this object. If
   732                              ALL objects in the list have been deleted, this object
   733                              will be garbage collected. If this object is managed by
   734                              a controller, then an entry in this list will point to
   735                              this controller, with the controller field set to true.
   736                              There cannot be more than one managing controller.
   737                            items:
   738                              description: OwnerReference contains enough information
   739                                to let you identify an owning object. An owning object
   740                                must be in the same namespace as the dependent, or be
   741                                cluster-scoped, so there is no namespace field.
   742                              properties:
   743                                apiVersion:
   744                                  description: API version of the referent.
   745                                  type: string
   746                                blockOwnerDeletion:
   747                                  description: If true, AND if the owner has the "foregroundDeletion"
   748                                    finalizer, then the owner cannot be deleted from
   749                                    the key-value store until this reference is removed.
   750                                    Defaults to false. To set this field, a user needs
   751                                    "delete" permission of the owner, otherwise 422
   752                                    (Unprocessable Entity) will be returned.
   753                                  type: boolean
   754                                controller:
   755                                  description: If true, this reference points to the
   756                                    managing controller.
   757                                  type: boolean
   758                                kind:
   759                                  description: 'Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   760                                  type: string
   761                                name:
   762                                  description: 'Name of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#names'
   763                                  type: string
   764                                uid:
   765                                  description: 'UID of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#uids'
   766                                  type: string
   767                              required:
   768                              - apiVersion
   769                              - kind
   770                              - name
   771                              - uid
   772                              type: object
   773                            type: array
   774                        type: object
   775                      providerID:
   776                        description: ProviderID is the identification ID of the machine
   777                          provided by the provider. This field must match the provider
   778                          ID as seen on the node object corresponding to this machine.
   779                          This field is required by higher level consumers of cluster-api.
   780                          Example use case is cluster autoscaler with cluster-api as
   781                          provider. Clean-up logic in the autoscaler compares machines
   782                          to nodes to find out machines at provider which could not
   783                          get registered as Kubernetes nodes. With cluster-api as a
   784                          generic out-of-tree provider for autoscaler, this field is
   785                          required by autoscaler to be able to have a provider view
   786                          of the list of machines. Another list of nodes is queried
   787                          from the k8s apiserver and then a comparison is done to find
   788                          out unregistered machines and are marked for delete. This
   789                          field will be set by the actuators and consumed by higher
   790                          level entities like autoscaler that will be interfacing with
   791                          cluster-api as generic provider.
   792                        type: string
   793                      version:
   794                        description: Version defines the desired Kubernetes version.
   795                          This field is meant to be optionally used by bootstrap providers.
   796                        type: string
   797                    required:
   798                    - bootstrap
   799                    - infrastructureRef
   800                    type: object
   801                type: object
   802            required:
   803            - selector
   804            type: object
   805          status:
   806            description: / [MachineSetStatus] MachineSetStatus defines the observed
   807              state of MachineSet
   808            properties:
   809              availableReplicas:
   810                description: The number of available replicas (ready for at least minReadySeconds)
   811                  for this MachineSet.
   812                format: int32
   813                type: integer
   814              errorMessage:
   815                type: string
   816              errorReason:
   817                description: "In the event that there is a terminal problem reconciling
   818                  the replicas, both ErrorReason and ErrorMessage will be set. ErrorReason
   819                  will be populated with a succinct value suitable for machine interpretation,
   820                  while ErrorMessage will contain a more verbose string suitable for
   821                  logging and human consumption. \n These fields should not be set for
   822                  transitive errors that a controller faces that are expected to be
   823                  fixed automatically over time (like service outages), but instead
   824                  indicate that something is fundamentally wrong with the MachineTemplate's
   825                  spec or the configuration of the machine controller, and that manual
   826                  intervention is required. Examples of terminal errors would be invalid
   827                  combinations of settings in the spec, values that are unsupported
   828                  by the machine controller, or the responsible machine controller itself
   829                  being critically misconfigured. \n Any transient errors that occur
   830                  during the reconciliation of Machines can be added as events to the
   831                  MachineSet object and/or logged in the controller's output."
   832                type: string
   833              fullyLabeledReplicas:
   834                description: The number of replicas that have labels matching the labels
   835                  of the machine template of the MachineSet.
   836                format: int32
   837                type: integer
   838              observedGeneration:
   839                description: ObservedGeneration reflects the generation of the most
   840                  recently observed MachineSet.
   841                format: int64
   842                type: integer
   843              readyReplicas:
   844                description: The number of ready replicas for this MachineSet. A machine
   845                  is considered ready when the node has been created and is "Ready".
   846                format: int32
   847                type: integer
   848              replicas:
   849                description: Replicas is the most recently observed number of replicas.
   850                format: int32
   851                type: integer
   852            required:
   853            - replicas
   854            type: object
   855        type: object
   856    versions:
   857    - name: v1alpha2
   858      served: true
   859      storage: true
   860  status:
   861    acceptedNames:
   862      kind: ""
   863      plural: ""
   864    conditions: []
   865    storedVersions: []