StoragePool

StoragePool defines a directory storage pool on a configured filesystem volume. Defines a named storage pool backed by a UserVolumeConfig, ExistingVolumeConfig, or ExternalVolumeConfig. The backing volume must be writable and filesystem-backed. Only one pool may reference a backing volume. The pool directory is named after the pool beneath the volume mount target. Removing the configuration stops and undefines the pool, but never deletes its files or backing volume. Requires the libvirtd system extension. Changing the backing volume changes the pool target; it does not migrate existing disk images.

apiVersion: v1alpha1
kind: StoragePool
name: vm-images # Pool name: 1-63 ASCII letters, digits, hyphens or underscores, starting with a letter or digit.
# Reference to the writable filesystem volume backing this pool.
volume:
    name: vm-data # Name of the UserVolumeConfig, ExistingVolumeConfig, or ExternalVolumeConfig document.

Field	Type	Description	Value(s)
`name`	string	Pool name: 1-63 ASCII letters, digits, hyphens or underscores, starting with a letter or digit.
`volume`	StoragePoolVolume	Reference to the writable filesystem volume backing this pool.

volume

StoragePoolVolume references a backing volume by its document name.

Field	Type	Description	Value(s)
`name`	string	Name of the UserVolumeConfig, ExistingVolumeConfig, or ExternalVolumeConfig document. This is the literal document name, not the runtime volume ID. For example, a UserVolumeConfig named `u-images` is referenced as `u-images`.

Overview

Getting Started

Platform specific installation

Deploying and managing workloads

Networking

Security

Build and extend Talos

Configure your Talos cluster

Advanced guides

Reference

Troubleshooting and support

Learn more

StoragePool

volume

​volume

volume