Skip to main content
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.
  • Create New Volume
  • Use Existing Volume
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:
Storage ClassCloud Provider Storage NameStorage ClassDescription
efs-scElastic File System (EFS)efs.csi.aws.comA fully managed, scalable, and highly durable elastic file system that offers high availability, automatic scaling, and cost-effective general file sharing. It’s suitable for workloads with varying capacity needs.
TrueFoundry Storage NameCloud Provider Storage NameStorage ClassDescription
standard-rwxGoogle Basic HDD Filestorefilestore.csi.storage.gke.ioA cost-effective and scalable file storage solution ideal for general-purpose file storage and cost-sensitive workloads. It offers lower cost but also lower performance due to its HDD-based nature.
premium-rwxGoogle Premium Filestorefilestore.csi.storage.gke.ioProvides higher performance and throughput compared to Basic HDD, making it suitable for I/O-intensive file operations and demanding workloads. It’s SSD-based, offering higher performance at a higher cost.
enterprise-rwxGoogle Enterprise Filestorefilestore.csi.storage.gke.ioDelivers the highest performance, throughput, advanced features, multi-zone support, and high availability, making it ideal for mission-critical workloads and applications with strict availability requirements. It comes with the highest cost.
TrueFoundry Storage NameCloud Provider Storage NameStorage ClassDescription
azurefileAzure File Storage (Standard)file.csi.azure.comUses Azure Standard storage to create file shares for general file sharing across VMs or containers, including Windows apps. It offers cost-effective performance.
azurefile-premiumAzure File Storage (Premium)file.csi.azure.comUses Azure Premium storage for higher performance, making it suitable for I/O-intensive file operations.
azurefile-csiAzure File Storage (StandardCSI)file.csi.azure.comLeverages Azure Standard storage with CSI for dynamic provisioning, potentially offering better performance and CSI features.
azurefile-csi-premiumAzure File Storage (PremiumCSI)file.csi.azure.comCombines Azure Premium storage with CSI for dynamic provisioning and high-performance file operations.
azureblob-nfs-premiumAzure Blob Storage (NFS Premium)blob.csi.azure.comUses Azure Premium storage with NFS v3 protocol for accessing large amounts of unstructured data and object storage, catering to demanding workloads with NFS access.
azureblob-fuse-premiumAzure Blob Storage (Fuse Premium)blob.csi.azure.comUses Azure Premium storage with BlobFuse for accessing large amounts of unstructured data and object storage, suitable for workloads that require BlobFuse access.
  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:
Once set-up, you can use Volume Browser to effortlessly upload, download, and view files stored within the Volumes.
You can attach Volumes to various types of deployments, including Services and Jobs. You can then read and write data to the volume like you would normally read and write data to a file system.You can read this guide to learn more about how to use volumes in deployments. This guide is for Service, but the same can be applied to Jobs as well.
I