VolumeConfig

VolumeConfig is a system volume configuration document. Note: at the moment, only EPHEMERAL and IMAGE-CACHE system volumes are supported.

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

Field	Type	Description	Value(s)
`name`	string	Name of the volume.
`provisioning`	ProvisioningSpec	The provisioning describes how the volume is provisioned.

provisioning

ProvisioningSpec describes how the volume is provisioned.

Field	Type	Description
`diskSelector`	DiskSelector	The disk selector expression.
`grow`	bool	Should the volume grow to the size of the disk (if possible).
`minSize`	ByteSize	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`
`maxSize`	ByteSize	The maximum size of the volume, if not specified the volume can grow to the size of the disk. 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.

Field	Type	Description	Value(s)
`match`	Expression	The 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`

Last modified June 12, 2025: docs: expand documentation description (87421af87)