Version v1.8 of the documentation is for the Talos version being developed. For the latest stable version of Talos, see the latest version.

VolumeConfig

VolumeConfig is a volume configuration document.
apiVersion: v1alpha1
kind: VolumeConfig
name: EPHEMERAL # Name of the volume.
# The provisioning describes how the volume is provisioned.
provisioning:
    # The disk selector expression.
    diskSelector:
        match: disk.transport == "nvme" # The Common Expression Language (CEL) expression to match the disk.
    maxSize: 50GiB # The maximum size of the volume, if not specified the volume can grow to the size of the

    # # The minimum size of the volume.
    # minSize: 2.5GiB
FieldTypeDescriptionValue(s)
namestringName of the volume.
provisioningProvisioningSpecThe provisioning describes how the volume is provisioned.

provisioning

ProvisioningSpec describes how the volume is provisioned.

FieldTypeDescriptionValue(s)
diskSelectorDiskSelectorThe disk selector expression.
growboolShould the volume grow to the size of the disk (if possible).
minSizeByteSize
The minimum size of the volume.
Size is specified in bytes, but can be expressed in human readable format, e.g. 100MB.
Show example(s)
minSize: 2.5GiB
maxSizeByteSize
The maximum size of the volume, if not specified the volume can grow to the size of thedisk.

Size is specified in bytes, but can be expressed in human readable format, e.g. 100MB.
Show example(s)
maxSize: 50GiB

diskSelector

DiskSelector selects a disk for the volume.

FieldTypeDescriptionValue(s)
matchExpressionThe Common Expression Language (CEL) expression to match the disk.
Show example(s)
match: disk.size > 120u * GB && disk.size < 1u * TB
match: disk.transport == "sata" && !disk.rotational && !system_disk