To create a volume, click on New Deployment and select Volume.
To create a volume, you will need to select a workspace. Volumes created within a specific workspace in TrueFoundry can only be used by applications deployed within the same workspace.This ensures that the volume’s data is accessible only to the applications that are part of the same environment, enhancing security and organization.
The volume form will look something like this: The key fields to fill up in the form are:
  1. Name: The name of the volume.
  2. Volume Config: You can select either of Create New Volume or Use Existing Volume.
In most cases, you will want to create a new volume. The Use Existing Volume option is useful when you want to mount a pre-existing volume or bucket like S3, GCS, etc.
You will need to fill up two fields here:
  1. Size: The size of the volume in Gi.
In most cases, you can increase the size of the volume after it is created. But you cannot decrease the size of the volume once created. So if you are not sure about the final size, you can start with a smaller size and increase it later.
  1. Storage Class: The Kubernetes storage class to use for the volume. Storage classes provide a way to specify the type of storage that should be provisioned for a Volume. These storage classes differ in their characteristics, such as performance, durability, and cost. The specific storage classes available will depend on the cloud provider you are using and what is preconfigured by the Infra team.
In case you want to whitelist only certain storage classes in the cluster to be used for provisioning volumes, you can add the truefoundry.com/enabled: 'true' label to the StorageClass resources. The dropdown will then show only the storage classes with this label.
The most common storage classes available in different cloud providers are:
  1. Volume Browser: Enabling the volume browser will provide you a user-friendly interface that allows you to effortlessly upload, download, and view files stored within the Volumes. The interface will need to be configured with a password so that only authorized users can view the data in the volume. The password will need to be first created as a Secret and then entered in the form below.
You can enable the volume browser by following the demo below:

Using the Volume

Once you press the submit button in the deployment form, the volume will be created within a few seconds. The Volume Dashboard will transform to appear as follows:
You can use the volume in the following ways: