| Field | Type | Description | Value(s) |
|---|---|---|---|
name | string | Name of the volume. Name can only contain: lowercase and uppercase ASCII letters, digits, and hyphens. | |
discovery | VolumeDiscoverySpec | The discovery describes how to find a volume. | |
mount | ExistingMountSpec | The mount describes additional mount options. | |
trim | TrimConfig | The trim describes the per-volume filesystem trim (fstrim) configuration. | |
scrub | ScrubConfig | The scrub describes the per-volume filesystem scrub configuration. |
discovery
VolumeDiscoverySpec describes how the volume is discovered.| Field | Type | Description | Value(s) |
|---|---|---|---|
volumeSelector | VolumeSelector | The volume selector expression. |
volumeSelector
VolumeSelector selects an existing volume.| Field | Type | Description | Value(s) |
|---|---|---|---|
match | Expression | The Common Expression Language (CEL) expression to match the volume. |
mount
ExistingMountSpec describes how the volume is mounted.| Field | Type | Description | Value(s) |
|---|---|---|---|
readOnly | bool | Mount the volume read-only. | |
disableAccessTime | bool | If true, disable file access time updates. | |
secure | bool | Enable secure mount options (nosuid, nodev, noexec). Defaults to true for better security. |
trim
TrimConfig describes per-volume filesystem trim (fstrim) configuration. It overrides the global FilesystemTrimConfig for the volume.| Field | Type | Description | Value(s) |
|---|---|---|---|
enabled | bool | Enable or disable trimming for this volume. If not set, trimming is enabled when the global FilesystemTrimConfig is present. | |
interval | Duration | The interval at which the volume is trimmed, overriding the global trim interval. | |
chunkSize | ByteSize | The size of the filesystem range trimmed at once, overriding the global chunk size. Setting it explicitly to zero trims the whole filesystem at once. When set to a non-zero value, the chunk size must be at least 1MiB. Size is specified in bytes, but can be expressed in human readable format, e.g. 1GiB. | |
chunkDelay | Duration | The delay between trimming consecutive chunks, overriding the global chunk delay. Setting it explicitly to zero trims the chunks back-to-back. | |
minLength | ByteSize | The minimum contiguous free range to discard, overriding the global minimum length. The value cannot exceed 128MiB, as ext4 rejects values larger than the block group size. Size is specified in bytes, but can be expressed in human readable format, e.g. 1MiB. |
scrub
ScrubConfig describes per-volume filesystem scrub configuration. It overrides the global FilesystemScrubConfig for the volume.| Field | Type | Description | Value(s) |
|---|---|---|---|
enabled | bool | Enable or disable scrubbing for this volume. If not set, scrubbing is enabled by default when scrub section is present. | |
interval | Duration | The interval at which the volume is scrubbed, overriding the global scrub interval. |