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

     1  
     2  ---
     3  apiVersion: apiextensions.k8s.io/v1beta1
     4  kind: CustomResourceDefinition
     5  metadata:
     6    creationTimestamp: null
     7    name: machinedeployments.cluster.sigs.k8s.io
     8  spec:
     9    group: cluster.sigs.k8s.io
    10    names:
    11      kind: MachineDeployment
    12      plural: machinedeployments
    13      shortNames:
    14      - md
    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: / [MachineDeployment] MachineDeployment is the Schema for the machinedeployments
    25          API
    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: / [MachineDeploymentSpec] MachineDeploymentSpec defines the
   410              desired state of MachineDeployment
   411            properties:
   412              minReadySeconds:
   413                description: Minimum number of seconds for which a newly created machine
   414                  should be ready. Defaults to 0 (machine will be considered available
   415                  as soon as it is ready)
   416                format: int32
   417                type: integer
   418              paused:
   419                description: Indicates that the deployment is paused.
   420                type: boolean
   421              progressDeadlineSeconds:
   422                description: The maximum time in seconds for a deployment to make progress
   423                  before it is considered to be failed. The deployment controller will
   424                  continue to process failed deployments and a condition with a ProgressDeadlineExceeded
   425                  reason will be surfaced in the deployment status. Note that progress
   426                  will not be estimated during the time a deployment is paused. Defaults
   427                  to 600s.
   428                format: int32
   429                type: integer
   430              replicas:
   431                description: Number of desired machines. Defaults to 1. This is a pointer
   432                  to distinguish between explicit zero and not specified.
   433                format: int32
   434                type: integer
   435              revisionHistoryLimit:
   436                description: The number of old MachineSets to retain to allow rollback.
   437                  This is a pointer to distinguish between explicit zero and not specified.
   438                  Defaults to 1.
   439                format: int32
   440                type: integer
   441              selector:
   442                description: Label selector for machines. Existing MachineSets whose
   443                  machines are selected by this will be the ones affected by this deployment.
   444                  It must match the machine template's labels.
   445                properties:
   446                  matchExpressions:
   447                    description: matchExpressions is a list of label selector requirements.
   448                      The requirements are ANDed.
   449                    items:
   450                      description: A label selector requirement is a selector that contains
   451                        values, a key, and an operator that relates the key and values.
   452                      properties:
   453                        key:
   454                          description: key is the label key that the selector applies
   455                            to.
   456                          type: string
   457                        operator:
   458                          description: operator represents a key's relationship to a
   459                            set of values. Valid operators are In, NotIn, Exists and
   460                            DoesNotExist.
   461                          type: string
   462                        values:
   463                          description: values is an array of string values. If the operator
   464                            is In or NotIn, the values array must be non-empty. If the
   465                            operator is Exists or DoesNotExist, the values array must
   466                            be empty. This array is replaced during a strategic merge
   467                            patch.
   468                          items:
   469                            type: string
   470                          type: array
   471                      required:
   472                      - key
   473                      - operator
   474                      type: object
   475                    type: array
   476                  matchLabels:
   477                    additionalProperties:
   478                      type: string
   479                    description: matchLabels is a map of {key,value} pairs. A single
   480                      {key,value} in the matchLabels map is equivalent to an element
   481                      of matchExpressions, whose key field is "key", the operator is
   482                      "In", and the values array contains only "value". The requirements
   483                      are ANDed.
   484                    type: object
   485                type: object
   486              strategy:
   487                description: The deployment strategy to use to replace existing machines
   488                  with new ones.
   489                properties:
   490                  rollingUpdate:
   491                    description: Rolling update config params. Present only if MachineDeploymentStrategyType
   492                      = RollingUpdate.
   493                    properties:
   494                      maxSurge:
   495                        anyOf:
   496                        - type: string
   497                        - type: integer
   498                        description: 'The maximum number of machines that can be scheduled
   499                          above the desired number of machines. Value can be an absolute
   500                          number (ex: 5) or a percentage of desired machines (ex: 10%).
   501                          This can not be 0 if MaxUnavailable is 0. Absolute number
   502                          is calculated from percentage by rounding up. Defaults to
   503                          1. Example: when this is set to 30%, the new MachineSet can
   504                          be scaled up immediately when the rolling update starts, such
   505                          that the total number of old and new machines do not exceed
   506                          130% of desired machines. Once old machines have been killed,
   507                          new MachineSet can be scaled up further, ensuring that total
   508                          number of machines running at any time during the update is
   509                          at most 130% of desired machines.'
   510                      maxUnavailable:
   511                        anyOf:
   512                        - type: string
   513                        - type: integer
   514                        description: 'The maximum number of machines that can be unavailable
   515                          during the update. Value can be an absolute number (ex: 5)
   516                          or a percentage of desired machines (ex: 10%). Absolute number
   517                          is calculated from percentage by rounding down. This can not
   518                          be 0 if MaxSurge is 0. Defaults to 0. Example: when this is
   519                          set to 30%, the old MachineSet can be scaled down to 70% of
   520                          desired machines immediately when the rolling update starts.
   521                          Once new machines are ready, old MachineSet can be scaled
   522                          down further, followed by scaling up the new MachineSet, ensuring
   523                          that the total number of machines available at all times during
   524                          the update is at least 70% of desired machines.'
   525                    type: object
   526                  type:
   527                    description: Type of deployment. Currently the only supported strategy
   528                      is "RollingUpdate". Default is RollingUpdate.
   529                    type: string
   530                type: object
   531              template:
   532                description: Template describes the machines that will be created.
   533                properties:
   534                  metadata:
   535                    description: 'Standard object''s metadata. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata'
   536                    properties:
   537                      annotations:
   538                        additionalProperties:
   539                          type: string
   540                        description: 'Annotations is an unstructured key value map stored
   541                          with a resource that may be set by external tools to store
   542                          and retrieve arbitrary metadata. They are not queryable and
   543                          should be preserved when modifying objects. More info: http://kubernetes.io/docs/user-guide/annotations'
   544                        type: object
   545                      generateName:
   546                        description: "GenerateName is an optional prefix, used by the
   547                          server, to generate a unique name ONLY IF the Name field has
   548                          not been provided. If this field is used, the name returned
   549                          to the client will be different than the name passed. This
   550                          value will also be combined with a unique suffix. The provided
   551                          value has the same validation rules as the Name field, and
   552                          may be truncated by the length of the suffix required to make
   553                          the value unique on the server. \n If this field is specified
   554                          and the generated name exists, the server will NOT return
   555                          a 409 - instead, it will either return 201 Created or 500
   556                          with Reason ServerTimeout indicating a unique name could not
   557                          be found in the time allotted, and the client should retry
   558                          (optionally after the time indicated in the Retry-After header).
   559                          \n Applied only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency"
   560                        type: string
   561                      labels:
   562                        additionalProperties:
   563                          type: string
   564                        description: 'Map of string keys and values that can be used
   565                          to organize and categorize (scope and select) objects. May
   566                          match selectors of replication controllers and services. More
   567                          info: http://kubernetes.io/docs/user-guide/labels'
   568                        type: object
   569                      name:
   570                        description: 'Name must be unique within a namespace. Is required
   571                          when creating resources, although some resources may allow
   572                          a client to request the generation of an appropriate name
   573                          automatically. Name is primarily intended for creation idempotence
   574                          and configuration definition. Cannot be updated. More info:
   575                          http://kubernetes.io/docs/user-guide/identifiers#names'
   576                        type: string
   577                      namespace:
   578                        description: "Namespace defines the space within each name must
   579                          be unique. An empty namespace is equivalent to the \"default\"
   580                          namespace, but \"default\" is the canonical representation.
   581                          Not all objects are required to be scoped to a namespace -
   582                          the value of this field for those objects will be empty. \n
   583                          Must be a DNS_LABEL. Cannot be updated. More info: http://kubernetes.io/docs/user-guide/namespaces"
   584                        type: string
   585                      ownerReferences:
   586                        description: List of objects depended by this object. If ALL
   587                          objects in the list have been deleted, this object will be
   588                          garbage collected. If this object is managed by a controller,
   589                          then an entry in this list will point to this controller,
   590                          with the controller field set to true. There cannot be more
   591                          than one managing controller.
   592                        items:
   593                          description: OwnerReference contains enough information to
   594                            let you identify an owning object. An owning object must
   595                            be in the same namespace as the dependent, or be cluster-scoped,
   596                            so there is no namespace field.
   597                          properties:
   598                            apiVersion:
   599                              description: API version of the referent.
   600                              type: string
   601                            blockOwnerDeletion:
   602                              description: If true, AND if the owner has the "foregroundDeletion"
   603                                finalizer, then the owner cannot be deleted from the
   604                                key-value store until this reference is removed. Defaults
   605                                to false. To set this field, a user needs "delete" permission
   606                                of the owner, otherwise 422 (Unprocessable Entity) will
   607                                be returned.
   608                              type: boolean
   609                            controller:
   610                              description: If true, this reference points to the managing
   611                                controller.
   612                              type: boolean
   613                            kind:
   614                              description: 'Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   615                              type: string
   616                            name:
   617                              description: 'Name of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#names'
   618                              type: string
   619                            uid:
   620                              description: 'UID of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#uids'
   621                              type: string
   622                          required:
   623                          - apiVersion
   624                          - kind
   625                          - name
   626                          - uid
   627                          type: object
   628                        type: array
   629                    type: object
   630                  spec:
   631                    description: 'Specification of the desired behavior of the machine.
   632                      More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status'
   633                    properties:
   634                      bootstrap:
   635                        description: Bootstrap is a reference to a local struct which
   636                          encapsulates fields to configure the Machine’s bootstrapping
   637                          mechanism.
   638                        properties:
   639                          configRef:
   640                            description: ConfigRef is a reference to a bootstrap provider-specific
   641                              resource that holds configuration details. The reference
   642                              is optional to allow users/operators to specify Bootstrap.Data
   643                              without the need of a controller.
   644                            properties:
   645                              apiVersion:
   646                                description: API version of the referent.
   647                                type: string
   648                              fieldPath:
   649                                description: 'If referring to a piece of an object instead
   650                                  of an entire object, this string should contain a
   651                                  valid JSON/Go field access statement, such as desiredState.manifest.containers[2].
   652                                  For example, if the object reference is to a container
   653                                  within a pod, this would take on a value like: "spec.containers{name}"
   654                                  (where "name" refers to the name of the container
   655                                  that triggered the event) or if no container name
   656                                  is specified "spec.containers[2]" (container with
   657                                  index 2 in this pod). This syntax is chosen only to
   658                                  have some well-defined way of referencing a part of
   659                                  an object. TODO: this design is not final and this
   660                                  field is subject to change in the future.'
   661                                type: string
   662                              kind:
   663                                description: 'Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   664                                type: string
   665                              name:
   666                                description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names'
   667                                type: string
   668                              namespace:
   669                                description: 'Namespace of the referent. More info:
   670                                  https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/'
   671                                type: string
   672                              resourceVersion:
   673                                description: 'Specific resourceVersion to which this
   674                                  reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency'
   675                                type: string
   676                              uid:
   677                                description: 'UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids'
   678                                type: string
   679                            type: object
   680                          data:
   681                            description: Data contains the bootstrap data, such as cloud-init
   682                              details scripts. If nil, the Machine should remain in
   683                              the Pending state.
   684                            type: string
   685                        type: object
   686                      infrastructureRef:
   687                        description: InfrastructureRef is a required reference to a
   688                          custom resource offered by an infrastructure provider.
   689                        properties:
   690                          apiVersion:
   691                            description: API version of the referent.
   692                            type: string
   693                          fieldPath:
   694                            description: 'If referring to a piece of an object instead
   695                              of an entire object, this string should contain a valid
   696                              JSON/Go field access statement, such as desiredState.manifest.containers[2].
   697                              For example, if the object reference is to a container
   698                              within a pod, this would take on a value like: "spec.containers{name}"
   699                              (where "name" refers to the name of the container that
   700                              triggered the event) or if no container name is specified
   701                              "spec.containers[2]" (container with index 2 in this pod).
   702                              This syntax is chosen only to have some well-defined way
   703                              of referencing a part of an object. TODO: this design
   704                              is not final and this field is subject to change in the
   705                              future.'
   706                            type: string
   707                          kind:
   708                            description: 'Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   709                            type: string
   710                          name:
   711                            description: 'Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names'
   712                            type: string
   713                          namespace:
   714                            description: 'Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/'
   715                            type: string
   716                          resourceVersion:
   717                            description: 'Specific resourceVersion to which this reference
   718                              is made, if any. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency'
   719                            type: string
   720                          uid:
   721                            description: 'UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids'
   722                            type: string
   723                        type: object
   724                      metadata:
   725                        description: ObjectMeta will autopopulate the Node created.
   726                          Use this to indicate what labels, annotations, name prefix,
   727                          etc., should be used when creating the Node.
   728                        properties:
   729                          annotations:
   730                            additionalProperties:
   731                              type: string
   732                            description: 'Annotations is an unstructured key value map
   733                              stored with a resource that may be set by external tools
   734                              to store and retrieve arbitrary metadata. They are not
   735                              queryable and should be preserved when modifying objects.
   736                              More info: http://kubernetes.io/docs/user-guide/annotations'
   737                            type: object
   738                          generateName:
   739                            description: "GenerateName is an optional prefix, used by
   740                              the server, to generate a unique name ONLY IF the Name
   741                              field has not been provided. If this field is used, the
   742                              name returned to the client will be different than the
   743                              name passed. This value will also be combined with a unique
   744                              suffix. The provided value has the same validation rules
   745                              as the Name field, and may be truncated by the length
   746                              of the suffix required to make the value unique on the
   747                              server. \n If this field is specified and the generated
   748                              name exists, the server will NOT return a 409 - instead,
   749                              it will either return 201 Created or 500 with Reason ServerTimeout
   750                              indicating a unique name could not be found in the time
   751                              allotted, and the client should retry (optionally after
   752                              the time indicated in the Retry-After header). \n Applied
   753                              only if Name is not specified. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency"
   754                            type: string
   755                          labels:
   756                            additionalProperties:
   757                              type: string
   758                            description: 'Map of string keys and values that can be
   759                              used to organize and categorize (scope and select) objects.
   760                              May match selectors of replication controllers and services.
   761                              More info: http://kubernetes.io/docs/user-guide/labels'
   762                            type: object
   763                          name:
   764                            description: 'Name must be unique within a namespace. Is
   765                              required when creating resources, although some resources
   766                              may allow a client to request the generation of an appropriate
   767                              name automatically. Name is primarily intended for creation
   768                              idempotence and configuration definition. Cannot be updated.
   769                              More info: http://kubernetes.io/docs/user-guide/identifiers#names'
   770                            type: string
   771                          namespace:
   772                            description: "Namespace defines the space within each name
   773                              must be unique. An empty namespace is equivalent to the
   774                              \"default\" namespace, but \"default\" is the canonical
   775                              representation. Not all objects are required to be scoped
   776                              to a namespace - the value of this field for those objects
   777                              will be empty. \n Must be a DNS_LABEL. Cannot be updated.
   778                              More info: http://kubernetes.io/docs/user-guide/namespaces"
   779                            type: string
   780                          ownerReferences:
   781                            description: List of objects depended by this object. If
   782                              ALL objects in the list have been deleted, this object
   783                              will be garbage collected. If this object is managed by
   784                              a controller, then an entry in this list will point to
   785                              this controller, with the controller field set to true.
   786                              There cannot be more than one managing controller.
   787                            items:
   788                              description: OwnerReference contains enough information
   789                                to let you identify an owning object. An owning object
   790                                must be in the same namespace as the dependent, or be
   791                                cluster-scoped, so there is no namespace field.
   792                              properties:
   793                                apiVersion:
   794                                  description: API version of the referent.
   795                                  type: string
   796                                blockOwnerDeletion:
   797                                  description: If true, AND if the owner has the "foregroundDeletion"
   798                                    finalizer, then the owner cannot be deleted from
   799                                    the key-value store until this reference is removed.
   800                                    Defaults to false. To set this field, a user needs
   801                                    "delete" permission of the owner, otherwise 422
   802                                    (Unprocessable Entity) will be returned.
   803                                  type: boolean
   804                                controller:
   805                                  description: If true, this reference points to the
   806                                    managing controller.
   807                                  type: boolean
   808                                kind:
   809                                  description: 'Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds'
   810                                  type: string
   811                                name:
   812                                  description: 'Name of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#names'
   813                                  type: string
   814                                uid:
   815                                  description: 'UID of the referent. More info: http://kubernetes.io/docs/user-guide/identifiers#uids'
   816                                  type: string
   817                              required:
   818                              - apiVersion
   819                              - kind
   820                              - name
   821                              - uid
   822                              type: object
   823                            type: array
   824                        type: object
   825                      providerID:
   826                        description: ProviderID is the identification ID of the machine
   827                          provided by the provider. This field must match the provider
   828                          ID as seen on the node object corresponding to this machine.
   829                          This field is required by higher level consumers of cluster-api.
   830                          Example use case is cluster autoscaler with cluster-api as
   831                          provider. Clean-up logic in the autoscaler compares machines
   832                          to nodes to find out machines at provider which could not
   833                          get registered as Kubernetes nodes. With cluster-api as a
   834                          generic out-of-tree provider for autoscaler, this field is
   835                          required by autoscaler to be able to have a provider view
   836                          of the list of machines. Another list of nodes is queried
   837                          from the k8s apiserver and then a comparison is done to find
   838                          out unregistered machines and are marked for delete. This
   839                          field will be set by the actuators and consumed by higher
   840                          level entities like autoscaler that will be interfacing with
   841                          cluster-api as generic provider.
   842                        type: string
   843                      version:
   844                        description: Version defines the desired Kubernetes version.
   845                          This field is meant to be optionally used by bootstrap providers.
   846                        type: string
   847                    required:
   848                    - bootstrap
   849                    - infrastructureRef
   850                    type: object
   851                type: object
   852            required:
   853            - selector
   854            - template
   855            type: object
   856          status:
   857            description: / [MachineDeploymentStatus] MachineDeploymentStatus defines
   858              the observed state of MachineDeployment
   859            properties:
   860              availableReplicas:
   861                description: Total number of available machines (ready for at least
   862                  minReadySeconds) targeted by this deployment.
   863                format: int32
   864                type: integer
   865              observedGeneration:
   866                description: The generation observed by the deployment controller.
   867                format: int64
   868                type: integer
   869              readyReplicas:
   870                description: Total number of ready machines targeted by this deployment.
   871                format: int32
   872                type: integer
   873              replicas:
   874                description: Total number of non-terminated machines targeted by this
   875                  deployment (their labels match the selector).
   876                format: int32
   877                type: integer
   878              unavailableReplicas:
   879                description: Total number of unavailable machines targeted by this deployment.
   880                  This is the total number of machines that are still required for the
   881                  deployment to have 100% available capacity. They may either be machines
   882                  that are running but not yet available or machines that still have
   883                  not been created.
   884                format: int32
   885                type: integer
   886              updatedReplicas:
   887                description: Total number of non-terminated machines targeted by this
   888                  deployment that have the desired template spec.
   889                format: int32
   890                type: integer
   891            type: object
   892        type: object
   893    versions:
   894    - name: v1alpha2
   895      served: true
   896      storage: true
   897  status:
   898    acceptedNames:
   899      kind: ""
   900      plural: ""
   901    conditions: []
   902    storedVersions: []