Use team storage volumes

A team storage volume is persistent storage that your team attaches to a GPU Container Job. When you delete a job, the volume keeps its data, so you can reuse datasets and checkpoints in later jobs. You manage volumes in Settings > Storage volumes, and you attach a volume when you create a job.

Prerequisites

Before you start, make sure that you have the following.

• The role for your task. Team leads and platform administrators can create and delete volumes. Members can attach a volume to a job that they create. Viewers can view the team's volumes. See Teams and roles.
• A deployment that serves storage volumes. Volumes work only on a cluster that runs on Gcore. For the setup, see Team storage volumes.

Understand team storage volumes

• One job at a time: only one job can use a volume. To free the volume for another job, delete the job that uses the volume.
• Fixed location: a volume stays in the location where you create it. A job that uses the volume runs in that location.
• Fixed size: you set the size in GiB when you create the volume, with a minimum of 100 GiB. You can't resize a volume later.
• Volume limit: each team can hold a limited number of volumes. The Volume slots card on the Storage volumes page shows how many the team uses. A failed volume keeps its slot until you delete it.
• Mount path: inside the job, the volume appears at /mnt/team-volume.

Create a volume

1. In the sidebar, click Settings.
2. In the Team group, click Storage volumes.
3. Click New volume.
4. In Location, select the volume's location. You can't change the location later.
5. In Name, enter a name that's unique in your team. Use up to 63 lowercase letters, numbers, and hyphens, and start and end with a letter or number.
6. In Size, select a preset or enter a whole number of GiB. The minimum is 100.
7. Click Create volume.

The volume appears in the list with the status Provisioning. Provisioning takes a few minutes. When the volume is ready, CosmicAC shows a Volume ready notification, and the status changes to Available.

Attach a volume to a job

You attach a volume when you create a GPU Container Job. You can't attach a volume to a job that already exists. You can attach only volumes that have the status Available.

To attach a volume, follow the steps in one of the following guides.

• Create a GPU Container Job in the web interface
• Create a GPU Container Job with the CLI

Use the volume in the job

Connect to the job, and then work with the files in /mnt/team-volume. To check the volume's size and free space, run the following command.

df -h /mnt/team-volume

A new volume is empty. The first job that uses the volume creates an ext4 file system on it. You don't need to format the volume yourself. Later jobs keep the file system, so they can read the files that earlier jobs wrote. When you delete a job, the volume and the files on it remain.

Delete a volume

You can delete a volume only when its status is Available or Failed. If the status is In use, first delete the job that uses the volume. To find the job, check the Attached to column. The volume's status changes to Available a few minutes after you delete the job.

To delete a volume, follow these steps.

1. In Settings > Storage volumes, click Delete in the volume's row.
2. Type the volume's name to confirm.
3. Click Delete volume.

The status changes to Deleting, and the volume disappears from the list when the deletion completes.

Help and troubleshooting

Next steps

• Connect to a GPU Container Job
• Settings pages and access