workspace 명령어(별칭: ws)를 사용하면 VESSL Cloud에서 인터랙티브 개발 환경을 관리할 수 있어요. Workspace는 데이터를 잃지 않고 일시정지하거나 다시 시작할 수 있는 영구 컴퓨트 세션을 제공해요.
list
현재 팀의 모든 Workspace를 조회해요.
| 플래그 | 기본값 | 설명 |
|---|
--all | false | 팀의 모든 Workspace 표시 (내 Workspace만이 아닌) |
show
특정 Workspace의 상세 정보를 표시해요.
vesslctl workspace show <slug>
| 인자 | 설명 |
|---|
slug | 조회할 Workspace slug |
create
지정된 클러스터, 리소스 스펙, 컨테이너 이미지로 새 Workspace를 생성해요.
vesslctl workspace create --name my-workspace --cluster <slug> --resource-spec <slug> --image <image>
| 플래그 | 약어 | 필수 | 설명 |
|---|
--name | | 예 | Workspace 이름 |
--cluster | | 예 | Workspace를 실행할 클러스터 슬러그 |
--resource-spec | | 예 | 리소스 스펙 슬러그 (GPU 종류, 수량, CPU, 메모리) |
--image | | 아니오 | 사용할 컨테이너 이미지 |
--object-volume | | 아니오 | Object volume 마운트 (SLUG:MOUNT_PATH, 반복 가능) |
--cluster-volume | | 아니오 | Cluster volume 마운트 (SLUG:MOUNT_PATH, 반복 가능) |
--init-script | | 아니오 | Workspace 시작 시 실행할 쉘 스크립트 |
vesslctl workspace create \
--name my-workspace \
--cluster <cluster-name> \
--resource-spec <spec-name> \
--image quay.io/vessl-ai/torch:2.9.1-cuda13.0.1-py3.13-slim
vesslctl cluster list와 vesslctl resource-spec list로 사용 가능한 클러스터와 GPU 스펙을 확인할 수 있어요.
start
일시정지된 Workspace를 다시 시작해요.
vesslctl workspace start <slug>
| 인자 | 설명 |
|---|
slug | 다시 시작할 Workspace slug |
pause
실행 중인 Workspace를 일시정지해요. 일시정지 중에는 과금이 중단되지만, 모든 데이터는 보존돼요.
vesslctl workspace pause <slug>
| 인자 | 설명 |
|---|
slug | 일시정지할 Workspace slug |
terminate
Workspace와 관련된 모든 데이터를 영구적으로 삭제해요.
vesslctl workspace terminate <slug>
| 플래그 | 약어 | 설명 |
|---|
--yes | -y | 확인 프롬프트 건너뛰기 |
vesslctl workspace terminate my-workspace-abc123 --yes
logs
Workspace의 로그를 확인해요.
vesslctl workspace logs <slug>
| 플래그 | 약어 | 기본값 | 설명 |
|---|
--limit | | 100 | 반환할 로그 줄 수 |
vesslctl workspace logs my-workspace-abc123 --limit 500
ssh
실행 중인 Workspace에 SSH 세션을 열어요.
vesslctl workspace ssh <slug>
| 플래그 | 약어 | 설명 |
|---|
--key | -i | SSH 개인 키 경로 |
vesslctl workspace ssh my-workspace-abc123 -i ~/.ssh/id_rsa
