Managing Container Volumes
The Volumes settings page shows a list of all volumes configured on a given container as well as a volume config for each identified volume.
To get there:
- Environments on the main, left-hand navigation.
- Select the environment from the first column.
- Containers from the horizontal navigation.
- Select the container from the list.
- Volumes tab under the container name.
This list now includes external volumes, see that page for configuration settings and information.
Local Volume Config
To see information about a given volume, select it from the list of configured volumes, identified by the path the volume.
Max Size - the maximum size this volume can grow to.
Read Only - If the read only checkbox is checked this volume cannot be written to.
Resizing and Max Size
Extending a volume is not constrained by the max volume size when the extension is issued. However, if the container is migrated and the max size of the volume is less than what its been extended to the max size will be used when creating the new volume.
Therefore, when increasing the size of the volume directly, it is also best practice to increase the maximum size of the volume so that this issue can be avoided.
Storage Pool
If the server the instance is being deployed to has more than one disk and one or more of those disks are 2TB or larger, storage pool can be set to enabled to signify that the instance should create its volume from the space on larger disk.
Remote Access
Local type volumes only.
If enabled, the remote access section allows the user to change information on the currently configured for volume remote access. This is required for remotely connecting via SFTP. For more information, see the platform documentation.
It's important to check if the server the instance is deployed to does not have SFTP connections enabled. If this is disabled, enable it before connecting.
| Field | Description |
|---|---|
| Enable | Remote access is enabled. |
| Algorithm | The type of algorithm used to hash the password. Currently can be Raw, SHA512, or MD5. |
| Password | The hashed (or raw) password. |
| Authorized IPs | Allow any IP is the default setting, but if a list of IP addresses is provided, SFTP connections will only be allowed if the origin of the request is an IP on the list. |
SFTP
SFTP is only available on the local type volumes.
The SFTP credentials for a given instance are located below the instance console on the instance dashboard
Extend Volume Size
Changing the size of an external volume is not currently supported, see external volumes for how to configure the volume size for this type of volume.
Users who wish to extend the size of the volume attached to an instance can do so using the extend volume size mini-modal. To get to this, navigate to the container > instances page and select the instance to reconfigure. Scroll down to the Attached Volumes section just below the instance console. From here open the mini-modal by clicking on the icon with crossed arrows at the end of the row.
The value entered into the first two columns represents how much space to add to the current volume. The third column shows the volumes current maximum size.
Once the data is entered, use the extend button to confirm the change.
Resizing and Max Size
Extending a volume is not constrained by the max volume size when the extension is issued. However, if the container is migrated and the max size of the volume is less than what its been extended to the max size will be used when creating the new volume.
Therefore, when increasing the size of the volume directly, it is also best practice to increase the maximum size of the volume so that this issue can be avoided.
External Volume Management and Configuration Changes
External volumes can be changed in different ways than local volumes. For externally mounted volumes the following options appear.
| Field | Description / Value |
|---|---|
| Type | External - Indicates that the volume being configured is managed externally (e.g., via Ceph RBD or another supported backend). |
| External Volume | The name of the external volume being attached to the container, this can be changed after container create. |
| Read-Only | When checked, the volume will be mounted in read-only mode, preventing write operations. |
| Block Device | When mounting a block device volume type, this box is checked after create. It cannot be changed after container create. |