Cycle Logo

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.

FieldDescription
EnableRemote access is enabled.
AlgorithmThe type of algorithm used to hash the password. Currently can be Raw, SHA512, or MD5.
PasswordThe hashed (or raw) password.
Authorized IPsAllow 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.

FieldDescription / Value
TypeExternal - Indicates that the volume being configured is managed externally (e.g., via Ceph RBD or another supported backend).
External VolumeThe name of the external volume being attached to the container, this can be changed after container create.
Read-OnlyWhen checked, the volume will be mounted in read-only mode, preventing write operations.
Block DeviceWhen mounting a block device volume type, this box is checked after create. It cannot be changed after container create.

🍪 Help Us Improve Our Site

We use first-party cookies to keep the site fast and secure, see which pages need improved, and remember little things to make your experience better. For more information, read our Privacy Policy.