메인 콘텐츠로 건너뛰기
volume 명령어(별칭: vol)를 사용하면 VESSL Cloud에서 데이터 Volume을 생성하고 관리할 수 있어요. Volume은 Workspace와 Job에 마운트할 수 있는 영구 Storage를 제공해요.

​
list

현재 팀의 모든 Volume을 조회해요. 
vesslctl volume list
플래그약어설명
--storageStorage 슬러그로 Volume 필터링
--typeVolume 종류 제한: object 또는 cluster
--page페이지 번호 (1부터 시작)
--per-page페이지당 항목 수

​
show

Volume의 상세 정보를 표시해요. 
vesslctl volume show <slug>
인자설명
slugVolume의 slug

​
create

지정된 Storage 백엔드에 새 Volume을 생성해요. 
vesslctl volume create --name my-volume --storage <slug> --teams <team>
플래그약어필수설명
--name예Volume 이름
--storage예Volume을 생성할 Storage 슬러그
--teams예Volume에 접근할 팀의 쉼표 구분 목록
--description아니오사람이 읽을 수 있는 설명
예시: 
vesslctl volume create \
  --name training-data \
  --storage gcs-us-central1 \
  --teams ml-team,data-team \
  --description "ImageNet training dataset"

​
ls

Object volume 내의 파일 목록을 조회해요. Cluster volume은 지원되지 않아요. 
vesslctl volume ls <slug> --prefix /
플래그약어설명
--prefix조회할 경로 프리픽스. 루트 전체를 보려면 /를 지정하세요.
예시: 
vesslctl volume ls training-data-abc123 --prefix checkpoints/

​
token

Object volume에 직접 접근하기 위한 임시 S3 호환 자격 증명을 가져와요. 엔드포인트, 버킷 이름, 액세스 키, 시크릿 키가 반환돼요. Cluster volume은 지원되지 않아요. 
vesslctl volume token <slug>
예시: 
vesslctl volume token training-data-abc123
S3를 지원하는 도구(aws s3 cp, DVC, 커스텀 데이터 파이프라인 등)와 연동할 때 유용해요.

​
update

기존 Volume의 메타데이터를 업데이트해요. 아래 플래그 중 최소 하나는 지정해야 해요. 
vesslctl volume update <slug> [flags]
플래그약어설명
--name새 Volume 이름
--description업데이트할 설명
--teams업데이트할 팀의 쉼표 구분 목록
예시: 
vesslctl volume update training-data-abc123 \
  --description "ImageNet + COCO combined dataset" \
  --teams ml-team,data-team,research

​
delete

Volume과 데이터를 영구적으로 삭제해요. 
vesslctl volume delete <slug>
플래그약어설명
--yes-y확인 프롬프트 건너뛰기
예시: 
vesslctl volume delete training-data-abc123 --yes

​
upload

로컬 파일을 Object volume에 업로드해요. Cluster volume은 지원되지 않아요. 
vesslctl volume upload <slug> <local_path>
플래그약어필수설명
--remote-prefix아니오Volume 내 경로 프리픽스 (예: datasets/training/)
--exclude아니오제외할 글로브 패턴 (예: *.pyc). 반복 사용 가능.
--dry-run아니오업로드하지 않고 파일 목록만 출력
--overwrite아니오기존 리모트 파일 덮어쓰기
예시: 
vesslctl volume upload training-data-abc123 ./local-dataset \
  --remote-prefix datasets/v1/ \
  --exclude "*.pyc" \
  --exclude "__pycache__"

​
download

Object volume의 파일을 로컬 디렉토리에 다운로드해요. Cluster volume은 지원되지 않아요. 
vesslctl volume download <slug> <local_path>
플래그약어필수설명
--remote-prefix아니오다운로드할 Volume 내 경로 프리픽스
--exclude아니오제외할 글로브 패턴. 반복 사용 가능.
--dry-run아니오다운로드하지 않고 파일 목록만 출력
--overwrite아니오기존 로컬 파일 덮어쓰기
예시: 
vesslctl volume download training-data-abc123 ./local-copy \
  --remote-prefix checkpoints/ \
  --overwrite