File shares
Provisioning file shares for your instances
File share storage is currently in private preview and requires a quota to be added to your account. For access, contact your account team via Slack or email [email protected].
File shares provide convenient, high-performance file storage for your instances. File shares selected on instance creation are automatically mounted to your instances as a directory under /mnt, and are readable and writable from multiple instances concurrently.
Provisioning file share storage
To provision file share storage, go to Storage, click + Create storage and select File share for the type field.
Select the region you would like to provision in.
Select the size for your disk. Currently, each file share storage has a maximum size of 15TB.
When creating a file share, you must provide a unique Name which will be used for the folder where it will be automatically mounted inside your instance. For example, if you named your file share "training-model" it will be automatically mounted on the /mnt/training-model folder after your instance is launched.
us-central1-a
NVIDIA H100
na-east1-a
NVIDIA A40
na-east1-b
NVIDIA A5000
eu-central1-a
NVIDIA A100
Attach storage to new reservations and spot bids
Provisioned storage is available for selection while creating a reservation or spot bid. You can attach as many storage options as needed from the same region. If you select a region that does not have provisioned storage, it will not appear as an option.
Currently, it's not possible to shrink/expand disk size.
Attaching new file shares to existing instances
You can attach new files shares to existing instances when they are in a Paused state. If the instance has already booted up once when you do this, the new file shares will not automatically be mounted for you. To mount the new file shares in the standard format, you can use the following commands:
FILESHARE_NAME=<insert-name-here>
sudo mkdir /mnt/$FILESHARE_NAME
sudo chmod 777 /mnt/$FILESHARE_NAME
echo "$FILESHARE_NAME /mnt/$FILESHARE_NAME virtiofs defaults,nofail 0 1" | sudo tee -a /etc/fstab
sudo mount -aAccessing the file share from your instance
You can list all file shares attached to your instance with ls:
$ ls /mntYou can read and write to any attached file share folders.
Performance & benchmarks
Actual performance for your file share is likely to vary greatly depending on your workload and instance configuration; however, below are representative benchmarks for a single 8x H100 instance:
12 Gbps
12,000
5 Gbps
4500
The numbers above are a snapshot meant for guidance. We are constantly making improvements to optimize performance. You can also run the benchmarks yourself from your instances using the following:
# sequential write bw
fio --name=my-job --group_reporting --time_based=1 --cpus_allowed_policy=split --runtime=10s --ramp_time=5s --size 20G --numjobs=32 --direct=1 --iodepth 8 --rw write --bs 1m
# sequential read bw
fio --name=my-job --group_reporting --time_based=1 --cpus_allowed_policy=split --runtime=10s --ramp_time=5s --size 20G --numjobs=32 --direct=1 --iodepth 8 --rw read --bs 1m
# write iops
fio --name=my-job --group_reporting --time_based=1 --cpus_allowed_policy=split --runtime=10s --ramp_time=5s --size 20G --numjobs=32 --direct=1 --iodepth 8 --rw write --bs 4k
# read iops
fio --name=my-job --group_reporting --time_based=1 --cpus_allowed_policy=split --runtime=10s --ramp_time=5s --size 20G --numjobs=32 --direct=1 --iodepth 8 --rw read --bs 4kQuotas
Each project has a total storage capacity quota that accumulates usage across all regions. Contact your account team via Slack or email [email protected] to increase your quota.
Last updated