openstack.k-orc.cloud_servers.yaml

---
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  annotations:
    controller-gen.kubebuilder.io/version: v0.17.1
  name: servers.openstack.k-orc.cloud
spec:
  group: openstack.k-orc.cloud
  names:
    categories:
    - openstack
    kind: Server
    listKind: ServerList
    plural: servers
    singular: server
  scope: Namespaced
  versions:
  - additionalPrinterColumns:
    - description: Resource ID
      jsonPath: .status.id
      name: ID
      type: string
    - description: Availability status of resource
      jsonPath: .status.conditions[?(@.type=='Available')].status
      name: Available
      type: string
    - description: Message describing current progress status
      jsonPath: .status.conditions[?(@.type=='Progressing')].message
      name: Message
      type: string
    name: v1alpha1
    schema:
      openAPIV3Schema:
        description: Server is the Schema for an ORC resource.
        properties:
          apiVersion:
            description: |-
              APIVersion defines the versioned schema of this representation of an object.
              Servers should convert recognized schemas to the latest internal value, and
              may reject unrecognized values.
              More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
            type: string
          kind:
            description: |-
              Kind is a string value representing the REST resource this object represents.
              Servers may infer this from the endpoint the client submits requests to.
              Cannot be updated.
              In CamelCase.
              More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
            type: string
          metadata:
            type: object
          spec:
            description: spec specifies the desired state of the resource.
            properties:
              cloudCredentialsRef:
                description: cloudCredentialsRef points to a secret containing OpenStack
                  credentials
                properties:
                  cloudName:
                    description: cloudName specifies the name of the entry in the
                      clouds.yaml file to use.
                    maxLength: 256
                    minLength: 1
                    type: string
                  secretName:
                    description: |-
                      secretName is the name of a secret in the same namespace as the resource being provisioned.
                      The secret must contain a key named `clouds.yaml` which contains an OpenStack clouds.yaml file.
                      The secret may optionally contain a key named `cacert` containing a PEM-encoded CA certificate.
                    maxLength: 253
                    minLength: 1
                    type: string
                required:
                - cloudName
                - secretName
                type: object
              import:
                description: |-
                  import refers to an existing OpenStack resource which will be imported instead of
                  creating a new one.
                maxProperties: 1
                minProperties: 1
                properties:
                  filter:
                    description: |-
                      filter contains a resource query which is expected to return a single
                      result. The controller will continue to retry if filter returns no
                      results. If filter returns multiple results the controller will set an
                      error state and will not continue to retry.
                    minProperties: 1
                    properties:
                      availabilityZone:
                        description: availabilityZone is the availability zone of
                          the existing resource
                        maxLength: 255
                        type: string
                      name:
                        description: name of the existing resource
                        maxLength: 255
                        minLength: 1
                        pattern: ^[^,]+$
                        type: string
                      notTags:
                        description: |-
                          notTags is a list of tags to filter by. If specified, resources which
                          contain all of the given tags will be excluded from the result.
                        items:
                          maxLength: 80
                          minLength: 1
                          type: string
                        maxItems: 50
                        type: array
                        x-kubernetes-list-type: set
                      notTagsAny:
                        description: |-
                          notTagsAny is a list of tags to filter by. If specified, resources
                          which contain any of the given tags will be excluded from the result.
                        items:
                          maxLength: 80
                          minLength: 1
                          type: string
                        maxItems: 50
                        type: array
                        x-kubernetes-list-type: set
                      tags:
                        description: |-
                          tags is a list of tags to filter by. If specified, the resource must
                          have all of the tags specified to be included in the result.
                        items:
                          maxLength: 80
                          minLength: 1
                          type: string
                        maxItems: 50
                        type: array
                        x-kubernetes-list-type: set
                      tagsAny:
                        description: |-
                          tagsAny is a list of tags to filter by. If specified, the resource
                          must have at least one of the tags specified to be included in the
                          result.
                        items:
                          maxLength: 80
                          minLength: 1
                          type: string
                        maxItems: 50
                        type: array
                        x-kubernetes-list-type: set
                    type: object
                  id:
                    description: |-
                      id contains the unique identifier of an existing OpenStack resource. Note
                      that when specifying an import by ID, the resource MUST already exist.
                      The ORC object will enter an error state if the resource does not exist.
                    format: uuid
                    type: string
                type: object
              managedOptions:
                description: managedOptions specifies options which may be applied
                  to managed objects.
                properties:
                  onDelete:
                    default: delete
                    description: |-
                      onDelete specifies the behaviour of the controller when the ORC
                      object is deleted. Options are `delete` - delete the OpenStack resource;
                      `detach` - do not delete the OpenStack resource. If not specified, the
                      default is `delete`.
                    enum:
                    - delete
                    - detach
                    type: string
                type: object
              managementPolicy:
                default: managed
                description: |-
                  managementPolicy defines how ORC will treat the object. Valid values are
                  `managed`: ORC will create, update, and delete the resource; `unmanaged`:
                  ORC will import an existing resource, and will not apply updates to it or
                  delete it.
                enum:
                - managed
                - unmanaged
                type: string
                x-kubernetes-validations:
                - message: managementPolicy is immutable
                  rule: self == oldSelf
              resource:
                description: |-
                  resource specifies the desired state of the resource.

                  resource may not be specified if the management policy is `unmanaged`.

                  resource must be specified if the management policy is `managed`.
                properties:
                  availabilityZone:
                    description: availabilityZone is the availability zone in which
                      to create the server.
                    maxLength: 255
                    type: string
                    x-kubernetes-validations:
                    - message: availabilityZone is immutable
                      rule: self == oldSelf
                  bootVolume:
                    description: |-
                      bootVolume specifies a volume to boot from instead of an image.
                      When specified, imageRef must be omitted. The volume must be
                      bootable (created from an image using imageRef in the Volume spec).
                    properties:
                      tag:
                        description: tag is the device tag applied to the volume.
                        maxLength: 255
                        type: string
                      volumeRef:
                        description: |-
                          volumeRef is a reference to a Volume object. The volume must be
                          bootable (created from an image) and available before server creation.
                        maxLength: 253
                        minLength: 1
                        type: string
                    required:
                    - volumeRef
                    type: object
                    x-kubernetes-validations:
                    - message: bootVolume is immutable
                      rule: self == oldSelf
                  configDrive:
                    description: |-
                      configDrive specifies whether to attach a config drive to the server.
                      When true, configuration data will be available via a special drive
                      instead of the metadata service.
                    type: boolean
                    x-kubernetes-validations:
                    - message: configDrive is immutable
                      rule: self == oldSelf
                  flavorRef:
                    description: flavorRef references the flavor to use for the server
                      instance.
                    maxLength: 253
                    minLength: 1
                    type: string
                    x-kubernetes-validations:
                    - message: flavorRef is immutable
                      rule: self == oldSelf
                  imageRef:
                    description: |-
                      imageRef references the image to use for the server instance.
                      This field is required unless bootVolume is specified for boot-from-volume.
                    maxLength: 253
                    minLength: 1
                    type: string
                    x-kubernetes-validations:
                    - message: imageRef is immutable
                      rule: self == oldSelf
                  keypairRef:
                    description: |-
                      keypairRef is a reference to a KeyPair object. The server will be
                      created with this keypair for SSH access.
                    maxLength: 253
                    minLength: 1
                    type: string
                    x-kubernetes-validations:
                    - message: keypairRef is immutable
                      rule: self == oldSelf
                  metadata:
                    description: metadata is a list of metadata key-value pairs which
                      will be set on the server.
                    items:
                      description: ServerMetadata represents a key-value pair for
                        server metadata.
                      properties:
                        key:
                          description: key is the metadata key.
                          maxLength: 255
                          minLength: 1
                          type: string
                        value:
                          description: value is the metadata value.
                          maxLength: 255
                          minLength: 1
                          type: string
                      required:
                      - key
                      - value
                      type: object
                    maxItems: 128
                    type: array
                    x-kubernetes-list-type: atomic
                  name:
                    description: |-
                      name will be the name of the created resource. If not specified, the
                      name of the ORC object will be used.
                    maxLength: 255
                    minLength: 1
                    pattern: ^[^,]+$
                    type: string
                  ports:
                    description: ports defines a list of ports which will be attached
                      to the server.
                    items:
                      maxProperties: 1
                      minProperties: 1
                      properties:
                        portRef:
                          description: |-
                            portRef is a reference to a Port object. Server creation will wait for
                            this port to be created and available.
                          maxLength: 253
                          minLength: 1
                          type: string
                      type: object
                    maxItems: 64
                    type: array
                    x-kubernetes-list-type: atomic
                  serverGroupRef:
                    description: |-
                      serverGroupRef is a reference to a ServerGroup object. The server
                      will be created in the server group.
                    maxLength: 253
                    minLength: 1
                    type: string
                    x-kubernetes-validations:
                    - message: serverGroupRef is immutable
                      rule: self == oldSelf
                  tags:
                    description: tags is a list of tags which will be applied to the
                      server.
                    items:
                      maxLength: 80
                      minLength: 1
                      type: string
                    maxItems: 50
                    type: array
                    x-kubernetes-list-type: set
                  userData:
                    description: |-
                      userData specifies data which will be made available to the server at
                      boot time, either via the metadata service or a config drive. It is
                      typically read by a configuration service such as cloud-init or ignition.
                    maxProperties: 1
                    minProperties: 1
                    properties:
                      secretRef:
                        description: secretRef is a reference to a Secret containing
                          the user data for this server.
                        maxLength: 253
                        minLength: 1
                        type: string
                    type: object
                    x-kubernetes-validations:
                    - message: userData is immutable
                      rule: self == oldSelf
                  volumes:
                    description: volumes is a list of volumes attached to the server.
                    items:
                      minProperties: 1
                      properties:
                        device:
                          description: |-
                            device is the name of the device, such as `/dev/vdb`.
                            Omit for auto-assignment
                          maxLength: 255
                          type: string
                        volumeRef:
                          description: |-
                            volumeRef is a reference to a Volume object. Server creation will wait for
                            this volume to be created and available.
                          maxLength: 253
                          minLength: 1
                          type: string
                      required:
                      - volumeRef
                      type: object
                    maxItems: 64
                    type: array
                    x-kubernetes-list-type: atomic
                required:
                - flavorRef
                - ports
                type: object
                x-kubernetes-validations:
                - message: either imageRef or bootVolume must be specified
                  rule: has(self.imageRef) || has(self.bootVolume)
                - message: imageRef and bootVolume are mutually exclusive
                  rule: '!(has(self.imageRef) && has(self.bootVolume))'
            required:
            - cloudCredentialsRef
            type: object
            x-kubernetes-validations:
            - message: resource must be specified when policy is managed
              rule: 'self.managementPolicy == ''managed'' ? has(self.resource) : true'
            - message: import may not be specified when policy is managed
              rule: 'self.managementPolicy == ''managed'' ? !has(self.__import__)
                : true'
            - message: resource may not be specified when policy is unmanaged
              rule: 'self.managementPolicy == ''unmanaged'' ? !has(self.resource)
                : true'
            - message: import must be specified when policy is unmanaged
              rule: 'self.managementPolicy == ''unmanaged'' ? has(self.__import__)
                : true'
            - message: managedOptions may only be provided when policy is managed
              rule: 'has(self.managedOptions) ? self.managementPolicy == ''managed''
                : true'
          status:
            description: status defines the observed state of the resource.
            properties:
              conditions:
                description: |-
                  conditions represents the observed status of the object.
                  Known .status.conditions.type are: "Available", "Progressing"

                  Available represents the availability of the OpenStack resource. If it is
                  true then the resource is ready for use.

                  Progressing indicates whether the controller is still attempting to
                  reconcile the current state of the OpenStack resource to the desired
                  state. Progressing will be False either because the desired state has
                  been achieved, or because some terminal error prevents it from ever being
                  achieved and the controller is no longer attempting to reconcile. If
                  Progressing is True, an observer waiting on the resource should continue
                  to wait.
                items:
                  description: Condition contains details for one aspect of the current
                    state of this API Resource.
                  properties:
                    lastTransitionTime:
                      description: |-
                        lastTransitionTime is the last time the condition transitioned from one status to another.
                        This should be when the underlying condition changed.  If that is not known, then using the time when the API field changed is acceptable.
                      format: date-time
                      type: string
                    message:
                      description: |-
                        message is a human readable message indicating details about the transition.
                        This may be an empty string.
                      maxLength: 32768
                      type: string
                    observedGeneration:
                      description: |-
                        observedGeneration represents the .metadata.generation that the condition was set based upon.
                        For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
                        with respect to the current state of the instance.
                      format: int64
                      minimum: 0
                      type: integer
                    reason:
                      description: |-
                        reason contains a programmatic identifier indicating the reason for the condition's last transition.
                        Producers of specific condition types may define expected values and meanings for this field,
                        and whether the values are considered a guaranteed API.
                        The value should be a CamelCase string.
                        This field may not be empty.
                      maxLength: 1024
                      minLength: 1
                      pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
                      type: string
                    status:
                      description: status of the condition, one of True, False, Unknown.
                      enum:
                      - "True"
                      - "False"
                      - Unknown
                      type: string
                    type:
                      description: type of condition in CamelCase or in foo.example.com/CamelCase.
                      maxLength: 316
                      pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$
                      type: string
                  required:
                  - lastTransitionTime
                  - message
                  - reason
                  - status
                  - type
                  type: object
                maxItems: 32
                type: array
                x-kubernetes-list-map-keys:
                - type
                x-kubernetes-list-type: map
              id:
                description: id is the unique identifier of the OpenStack resource.
                type: string
              resource:
                description: resource contains the observed state of the OpenStack
                  resource.
                properties:
                  availabilityZone:
                    description: availabilityZone is the availability zone where the
                      server is located.
                    maxLength: 1024
                    type: string
                  configDrive:
                    description: configDrive indicates whether the server was booted
                      with a config drive.
                    type: boolean
                  hostID:
                    description: hostID is the host where the server is located in
                      the cloud.
                    maxLength: 1024
                    type: string
                  imageID:
                    description: imageID indicates the OS image used to deploy the
                      server.
                    maxLength: 1024
                    type: string
                  interfaces:
                    description: interfaces contains the list of interfaces attached
                      to the server.
                    items:
                      properties:
                        fixedIPs:
                          description: fixedIPs is the list of fixed IP addresses
                            assigned to the interface.
                          items:
                            properties:
                              ipAddress:
                                description: ipAddress is the IP address assigned
                                  to the port.
                                maxLength: 1024
                                type: string
                              subnetID:
                                description: subnetID is the ID of the subnet from
                                  which the IP address is allocated.
                                maxLength: 1024
                                type: string
                            type: object
                          maxItems: 32
                          type: array
                          x-kubernetes-list-type: atomic
                        macAddr:
                          description: macAddr is the MAC address of the interface.
                          maxLength: 1024
                          type: string
                        netID:
                          description: netID is the ID of the network to which the
                            interface is attached.
                          maxLength: 1024
                          type: string
                        portID:
                          description: portID is the ID of a port attached to the
                            server.
                          maxLength: 1024
                          type: string
                        portState:
                          description: portState is the state of the port (e.g., ACTIVE,
                            DOWN).
                          maxLength: 1024
                          type: string
                      type: object
                    maxItems: 64
                    type: array
                    x-kubernetes-list-type: atomic
                  metadata:
                    description: metadata is the list of metadata key-value pairs
                      on the resource.
                    items:
                      description: ServerMetadataStatus represents a key-value pair
                        for server metadata in status.
                      properties:
                        key:
                          description: key is the metadata key.
                          maxLength: 255
                          type: string
                        value:
                          description: value is the metadata value.
                          maxLength: 255
                          type: string
                      type: object
                    maxItems: 128
                    type: array
                    x-kubernetes-list-type: atomic
                  name:
                    description: name is the human-readable name of the resource.
                      Might not be unique.
                    maxLength: 1024
                    type: string
                  serverGroups:
                    description: |-
                      serverGroups is a slice of strings containing the UUIDs of the
                      server groups to which the server belongs. Currently this can
                      contain at most one entry.
                    items:
                      maxLength: 1024
                      type: string
                    maxItems: 32
                    type: array
                    x-kubernetes-list-type: atomic
                  status:
                    description: |-
                      status contains the current operational status of the server,
                      such as IN_PROGRESS or ACTIVE.
                    maxLength: 1024
                    type: string
                  tags:
                    description: tags is the list of tags on the resource.
                    items:
                      maxLength: 1024
                      type: string
                    maxItems: 50
                    type: array
                    x-kubernetes-list-type: atomic
                  volumes:
                    description: volumes contains the volumes attached to the server.
                    items:
                      properties:
                        id:
                          description: id is the ID of a volume attached to the server.
                          maxLength: 1024
                          type: string
                      type: object
                    maxItems: 64
                    type: array
                    x-kubernetes-list-type: atomic
                type: object
            type: object
        type: object
    served: true
    storage: true
    subresources:
      status: {}