Skip to main content
Version: 0.3

Volumes

Configuring volumes at runtime

Acorn images can define volumes. To see which volumes are available for an Acorn image you can run --help on the image.

acorn run [IMAGE] --help
# ...
Volumes: my-data

The Volumes line shows the volumes that will be created as part of the Acorn app deployment. Unless otherwise specified in the Acorn image, each volume will be created using the following default values:

FieldDefault Value
size10G
classdefault
accessModereadWriteOnce

These values can be customized at runtime by passing -v arguments. For example, the following command will cause the "my-data" volume to be created with 5G of storage and using the fast storage class:

acorn run -v my-data,size=5G,class=fast [IMAGE]

Using precreated volumes

You can use a precreated volumes by binding the volume at runtime.

acorn run -v db-data:my-data [IMAGE]

This Acorn app will use the volume named db-data as it's my-data volume.

The volume will match the size and class of the pre-created PV db-data.