LVMVolumeGroup

Scope: Cluster
Version: v1alpha1

An interface for managing Volume Groups and thin pools on the nodes.

These resources might be created both by a user and the sds-node-configurator controller. The sds-node-configurator controller will automatically create an LVMVolumeGroup resource if it detects an existing Volume Group on a node tagged with ‘storage.deckhouse.io/enabled=true’. The controller will fill in both the ‘spec’ and ‘status’ fields. The spec.thinPools field must be filled in by yourself.

  • spec
    object

    Required value

    • spec.actualVGNameOnTheNode
      string

      Required value

      The desired name of a Volume Group. Must be unique for the node it is on.

      This field is immutable.

    • spec.blockDeviceSelector
      object

      Required value

      The desired block device selector.

      • spec.blockDeviceSelector.matchExpressions
        array of objects

        The desired block device selector expressions.

        • spec.blockDeviceSelector.matchExpressions.key
          string
        • spec.blockDeviceSelector.matchExpressions.operator
          string

          Allowed values: In, NotIn, Exists, DoesNotExist

        • spec.blockDeviceSelector.matchExpressions.values
          array of strings
      • spec.blockDeviceSelector.matchLabels
        object

        The desired block device selector labels.

    • spec.local
      object

      The desired configuration for a local Volume Group.

      • spec.local.nodeName
        string

        Required value

        The desired node for the LVM Volume Group.

        This field is immutable.

    • spec.thinPools
      array of objects

      The desired thin pool configuration.

      • spec.thinPools.allocationLimit
        string

        Thin pool oversize limit. Default is 150%.

        Default: "150%"

        Pattern: ^[1-9][0-9]{2,3}%$

      • spec.thinPools.name
        string

        Required value

        The desired thin pool name.

        This field is immutable.

      • spec.thinPools.size
        integer or string

        Required value

        The desired thin pool size. Might be specified as number or percent size of total VG space.

        Note, that if you specify the percent size, the thin pool will be automatically extended when VG is extended.

        Pattern: ^[0-9]+(\.[0-9]+)?(E|P|T|G|M|k|Ei|Pi|Ti|Gi|Mi|Ki)?$|^[1-9][0-9]?%$|100%

    • spec.type
      string

      Required value

      The type of a VolumeGroup:

      • Local — that is, local if the devices used are not distributed (not Shared LUN).

      Allowed values: Local