Volumes
Volumes are used to persist data generated by and used by machines. They are independent of the machine lifecycle, so data is not lost when a machine is stopped or deleted.
If you want to know how to deploy a volume you can check Building & Deploying > Deploying.
Configuration​
| Property | Type | Required |
|---|---|---|
namespace | string | |
name | string | ✓ |
tags | array<string> | |
mode | readonly | writable | ✓ |
size | string (human readable) | ✓ |
If you want to know more about namespaces, check Building & Deploying > Namespaces
Name​
The name is the unique identifier for your volume within a namespace. It is used to reference the volume in machines.
Validation:
- It must start with a letter
- Can contain alphanumeric characters
- Can contain
-(underscore) and_(hyphen) - Can contain multiple consecutive
_(underscore) - Cannot contain multiple consecutive
-(hyphen)
Tags​
Tags are used to organize and categorize resources. They can be any valid UTF-8 string and can be used to filter resources in the Web Console..
volume:
tags:
- terminator
Mode​
It defines the access mode of the volume. It can be either readonly or writable.
volume:
mode: writable
Size​
The size property defines the size of the volume in a human readable string. The minimum size for a volume is 1KB and the maximum size is 1GB.
volume:
size: 42MB
The maximum value reflects the current limitations of the underlying infrastructure and will be increased in the future.