Documentation Index
Fetch the complete documentation index at: https://docs.cloud.vessl.ai/llms.txt
Use this file to discover all available pages before exploring further.
일시정지된 Workspace에서도 자세한 정보 확인하기
이번 업데이트부터 일시정지된 Workspace에서도 실행 중일 때와 동일하게 init script, 컨테이너 이미지, 마운트된 Volume, Compute Specs, Pricing Summary가 그대로 보여요. Metrics 탭도 일시정지 상태에서 바로 열어볼 수 있어요. Active volumes 목록에는 어떤 Volume이 어디서 쓰이고 있는지 한눈에 확인할 수 있는 새 컬럼이 추가됐어요.
Key updates
- 일시정지 상태에서도 상세 정보 표시: Workspace를 Pause로 잠시 멈춰도 init script, 컨테이너 이미지, 마운트된 Volume, Compute Specs, Pricing Summary가 그대로 남아 있어요. 다시 켜기 전에 설정을 한 번 더 확인하기 편해요.
- 일시정지 상태에서도 Metrics 탭 사용 가능: Metrics 탭이 일시정지 상태에서도 열려 있어서, 굳이 다시 켜지 않아도 마지막 실행의 CPU, 메모리, GPU 사용량을 다시 살펴볼 수 있어요.
- Active volumes 목록의 새 컬럼: Active volumes 목록에 Workload count, Created by, Last attached 컬럼이 추가됐어요. 사용하지 않는 Volume을 찾거나, 누가 만들었고 마지막으로 언제 쓰였는지 빠르게 확인할 수 있어요.

2026년 4월 30일 업데이트
이번 업데이트부터vesslctl을 실행 중인 Workspace 안에서 별도 인증 없이 그대로 사용할 수 있어요. SSH 키와 추가 포트를 CLI에서 관리하고, 배치 잡에 커스텀 태그를 달아 정리할 수 있어요. 안정성 수정도 함께 들어갔어요.
Key updates
- Workspace 안에서 vesslctl 그대로 사용: JupyterLab 터미널이나 SSH 세션에서 별도 인증 없이
vesslctl명령을 바로 사용할 수 있어요. 자세한 내용은 Workspace 안에서 vesslctl 사용하기를 참고하세요. - CLI에서 SSH 키와 포트 지정:
vesslctl workspace create에--ssh-key와--port플래그가 추가됐어요. 키 관리는 새vesslctl ssh-key명령으로 할 수 있어요. workspace list에 slug 컬럼 추가: Workspace 목록 첫 번째 컬럼에 slug가 표시돼서, 다른 명령에 그대로 복사해서 쓸 수 있어요.- Job에 커스텀 태그 달기: Jobs 목록과 Job 상세에서 태그를 바로 추가하거나 제거하고, 목록에서 태그로 필터링할 수 있어요. 자세한 내용은 Job 목록 조회하기에서 다뤄요.
- 홈 대시보드에 Job 지표 표시: 활성 Job 수와 GPU 사용량이 Workspace와 함께 표시되고, idle 감지도 두 워크로드에 모두 적용돼요.
- Job terminate가 기록을 보존:
vesslctl job terminate로 Job을 멈춰도 설정, 로그, 메트릭이 그대로 남아 다시 살펴볼 수 있어요. 자세한 내용은 Job 정리하기를 참고하세요. - 더 매끄러운 온보딩: 크레딧이 0이어도 Workspace 생성 페이지에 진입할 수 있고(생성 자체는 충전 후 가능), 조직 생성 페이지도 더 깔끔한 흐름으로 리디자인됐어요.
- 안정성 수정: 신규 사용자에게 보낸 관리자 초대가 사라지던 문제, 조직 생성 시 검증 오류가 UI에 안 보이던 문제, Object storage에서 5 GiB를 넘는 파일이 손상되던 문제를 수정했어요.
배치 잡(Job) 출시
VESSL Cloud에서 학습·추론 배치 잡을 CLI로 제출하고, 콘솔에서 상태와 결과를 확인할 수 있어요. 선택한 클러스터와 리소스 스펙에서 명령어를 실행한 뒤 완료되면 종료되며, 로그·메트릭·종료 사유를 UI에서 바로 확인할 수 있어요.
Key updates
- CLI로 제출:
vesslctl job create로 한 줄에 배치 잡을 제출해요. 상태와 로그는 콘솔의 Jobs 섹션에서 확인할 수 있어요. - 이미지·명령어·환경 변수: 원하는 컨테이너 이미지를 그대로 사용하고, 실행 명령어와 환경 변수(예:
WANDB_API_KEY)를 지정해서 실험 추적에 활용할 수 있어요. - Volume 마운트: Object volume과 Cluster volume을 slug로 마운트해서 데이터셋, 체크포인트, 공유 아티팩트를 Job과 함께 쓸 수 있어요.
- 라이프사이클 가시성: queued → running → completed/terminated 상태 전환을 추적하고, 실패 시 종료 사유를 확인할 수 있어요.
- 태그로 정리: Job에 태그를 달아서 조회와 필터링을 쉽게 할 수 있어요.
vesslctl CLI 문서
vesslctl 커맨드라인 도구의 전체 문서를 공개했어요. 이제 터미널에서 Workspace, 배치 잡, 스토리지, 팀 설정을 모두 관리할 수 있어요.
Key updates
- 설치 가이드: 한 줄 설치, 브라우저 기반 OAuth 로그인, 셸 자동완성 설정. CLI 개요를 참고하세요.
- CLI 퀵스타트: Workspace 생성, 데이터셋 업로드, 배치 잡 제출을 다루는 3가지 시나리오. CLI 퀵스타트를 참고하세요.
- 명령어 레퍼런스:
workspace,job,volume,storage,org,team,cluster,config,auth등 모든 명령어와 플래그 상세 문서. 명령어 레퍼런스를 참고하세요. - 치트 시트: 모든 명령어를 한 페이지에서 빠르게 확인할 수 있어요. 치트 시트를 참고하세요.
자원 선택 방식 개선
Workspace를 만들 때 하드웨어를 고르는 과정이 더 간편해졌어요. 기존의 긴 스펙 카드 목록 대신, GPU 제품, 리전, GPU 수량의 세 단계로 나눠서 선택할 수 있어요.
Key updates
- 단계별 선택: GPU 제품(예: A100 SXM, H100 SXM, CPU only)을 고르고, 리전을 선택한 뒤, GPU 수량을 정하면 돼요.
- 리전 기반 선택: 클러스터 이름 대신 리전 기준으로 리소스가 정리되어 Workspace가 어디서 실행되는지 쉽게 알 수 있어요.
- 가용 상태 한눈에 확인: GPU 수량 카드마다 가용 상태(High, Low)와 시간당 비용, vCPU, RAM, Temporary storage 정보가 함께 표시돼요.
Launch confirmation 모달
Workspace를 만들 때 persistent storage 설정에 따라 데이터 보존 여부를 안내하는 확인 모달이 추가되었어요.
- Persistent volume 미설정 시: 볼륨이 연결되지 않은 경우, pause 시 모든 파일이 영구 삭제된다는 경고를 표시해요. Cluster storage 볼륨 추가와 중요 파일을 마운트 경로에 저장할 것을 안내해요.

- Persistent volume 설정 시: 마운트된 경로를 표시하고, 해당 경로 내부의 파일은 pause 시에도 보존되지만 경로 바깥의 파일은 보존되지 않는다는 점을 안내해요.
대시보드, GPU 가용 상태, Workspace 메트릭
개인 사용자와 조직 관리자를 위한 전용 대시보드가 추가되고, Workspace 생성 시 GPU 가용 상태를 확인할 수 있게 되었어요.
Key updates
- 홈 대시보드: 소속 팀의 워크로드 현황, GPU 사용률, 비용을 한 화면에서 확인하세요. Under-utilization 알림으로 리소스 최적화를 도와줘요. 홈 대시보드를 확인해 보세요.
- 조직 대시보드: 조직 전체의 GPU 사용률, 비용 추이, 팀별 현황, Idle 워크로드를 모니터링하세요. 조직 대시보드를 확인해 보세요.
- GPU 가용 상태 표시: Workspace를 만들 때 리소스 스펙 카드마다 가용 상태(High, Low, Checking)가 표시돼요. 대기 시간을 미리 파악할 수 있어요. Workspace 만들기를 참고해 주세요.
- Workspace 메트릭 개선: 기존 메트릭에 VRAM 사용량과 GPU 온도가 추가되었어요. 시간 범위 셀렉터(1h-7d)와 디스플레이 설정으로 유연하게 모니터링할 수 있어요. 메트릭 모니터링하기를 확인해 보세요.
새로운 스토리지 체계
더 빠르고 안정적인 스토리지 환경을 위해 체계를 개편했어요.Key updates
- Workspace volume → Cluster storage: 클러스터 내 고가용성 분산 스토리지(CephFS/NVMe)로, 같은 클러스터의 여러 Workspace에서 공유할 수 있어요. Terminate 후에도 데이터가 유지돼요.
- Shared volume → Object storage: 기존 S3 기반 공유 스토리지가 Object storage로 명칭이 변경되었어요. 기능 변경은 없어요.
- Terminate 후에도 데이터 유지: 코드, 가상환경, 데이터가 Workspace를 종료해도 그대로 남아요.
- 클러스터 내 공유: 같은 클러스터의 여러 Workspace에서 동시에 마운트 가능(RWX).
- 고가용성: 분산 구조로 노드 장애에도 데이터가 보호돼요.
- 가격: Cluster storage $0.20/GiB/월.
- 마이그레이션: 기존 Workspace volume 데이터는 Cluster storage로 마이그레이션할 수 있어요. support@vessl.ai로 문의해 주세요.
SSH 키 다운로드 방식 변경
기존에는 SSH 키를 생성하면 파일 저장 위치를 선택하는 다이얼로그가 열렸어요. 이 때문에 나중에 Workspace에 연결할 때 키를 어디에 저장했는지 잊어버리는 경우가 많았어요. 이제 SSH 키는~/Downloads 폴더에 바로 다운로드되고, SSH 연결 가이드에서 키 경로를 안내해요.Key updates
- ~/Downloads로 바로 다운로드: SSH 키가 파일 선택 다이얼로그 없이 기본 다운로드 폴더에 자동으로 저장돼요.
- SSH 연결 가이드에 키 경로 안내 추가: SSH 연결 탭에서 “usually in
~/Downloads” 안내가 표시되어 키 파일 위치를 쉽게 찾을 수 있어요.
더 나은 네비게이션과 팀 협업
관리자 메뉴 구조를 통합하고, 팀의 Workspace와 멤버 정보를 확인할 수 있도록 개선했어요.Key updates
- 통합된 관리자 메뉴: 관리자 메뉴가 이제 메인 네비게이션에 통합되어 관리 기능을 더 쉽게 찾고 접근할 수 있어요.

- 팀 멤버의 Workspace 조회: 기존에는 내 Workspace만 조회 가능했어요. 이제는 같은 팀 멤버의 Workspace도 조회할 수 있고, 어떤 팀 멤버가 어떤 Workspace에서 작업 중인지 확인할 수 있어요.

- Top bar에서 팀 멤버 조회: Top bar 옆에서 누가 내 팀에 속해있는지 바로 확인할 수 있어요. 함께 작업 중인 멤버를 한눈에 볼 수 있어요.


결제 및 크레딧 가시성 개선
크레딧 부족 상황에서 Workspace 생성 동작을 더 안전하게 만들고, 결제 안내 메시지를 더 명확하게 보여주도록 개선했어요.
Key updates
- Credit 검증으로 Workspace 생성 방지: 크레딧이 없을 때 Workspace가 생성된 후 바로 종료되던 문제를 해결했어요. 이제 크레딧이 없으면 Workspace를 생성하기 전에 토스트 메시지로 크레딧 추가를 안내해요.
- 결제수단 등록 요청 배너: 결제수단이 등록되지 않았고 크레딧도 없는 경우, 결제수단 등록을 안내하는 배너가 표시돼요. 관리자는 배너를 통해 바로 결제수단을 등록할 수 있어요.
Workspace 히스토리 개선
Coming Soon에서 미리 안내했던 Workspace 히스토리 기능이 이제 제공돼요. 또 Workspace volume 마운트 경로 정책도 함께 정리했어요.Key updates
- 이벤트 피드(Event feed):
- Event history: Workspace Details 페이지에서 Workspace 이벤트를 타임라인으로 확인할 수 있어요. Running, 이미지 pulling(이미지 다운로드), Workspace 중지/종료 등 주요 상태와 이벤트를 확인하고, Out of Memory Killed(OOMKilled), 크레딧 부족, Temporary storage 초과 같은 종료 사유도 추적하세요.
- Terminated Workspace view: 종료(Terminated)된 Workspace가 24시간 뒤에 자동으로 삭제되지 않아요. View Terminated 토글을 켜서 언제든 기록을 확인하고, 원할 때 직접 삭제하세요.
- Workspace volume mount path: Workspace volume 마운트 경로는
/root($HOME)로 고정되어 변경할 수 없어요.
GPU 이미지 업데이트
CUDA와 Torch 이미지를 최신 버전으로 확장했어요.Key updates
-
CUDA 13.0.1 이미지:
quay.io/vessl-ai/cuda:13.0.1-py3.10-slimquay.io/vessl-ai/cuda:13.0.1-py3.11-slimquay.io/vessl-ai/cuda:13.0.1-py3.12-slimquay.io/vessl-ai/cuda:13.0.1-py3.13-slim
-
Torch 2.9.1(CUDA 13.0.1) 이미지:
quay.io/vessl-ai/torch:2.9.1-cuda13.0.1-py3.10-slimquay.io/vessl-ai/torch:2.9.1-cuda13.0.1-py3.11-slimquay.io/vessl-ai/torch:2.9.1-cuda13.0.1-py3.12-slimquay.io/vessl-ai/torch:2.9.1-cuda13.0.1-py3.13-slim
강력한 제어, 투명한 상태, 간편한 선택
볼륨을 직접 관리하고, Workspace 상태를 투명하게 확인하며, 리소스를 더 쉽게 선택할 수 있어요.Key updates
-
볼륨 직접 관리(User-managed volumes): Shared volume을 사용자가 직접 만들고 관리할 수 있어요.
- 관리자 할당 불필요: 관리자에게 쿼타(Quota)를 요청할 필요 없이 바로 볼륨을 생성하세요.
- 팀 공유: 만든 볼륨을 팀원들과 손쉽게 공유할 수 있어요.
-
스토리지 정책 변경(Storage pricing update):
- Pay-as-you-go: Workspace volume은 사용한 만큼 비용이 청구돼요(50GB당 시간당 $0.0070).
- 쿼타 제한 해제: Shared volume의 용량 제한(Quota)이 사라졌어요.
-
상태 가시성 개선(Workspace visibility):
- 상세 상태 표시: Workspace 상태가 명확하게 정의되었어요. Queued, Initializing, Running, Paused, Failed, Terminated 상태가 있고 “Queued”는 GPU 할당 대기 중, “Initializing”은 이미지 다운로드 중을 의미해요.
-
리소스 선택 간소화(Simplified resource selection):
- 클러스터 선택 제거: 더 이상 클러스터를 먼저 선택할 필요 없어요. 모든 클러스터의 리소스 스펙을 한 화면에서 확인하세요.
- 통합 리소스 뷰: 클러스터와 상관없이 사용 가능한 모든 GPU/CPU 옵션을 한눈에 볼 수 있어요.
더 직관적이고 강력해진 Workspace 생성
사용자 친화적으로 완전히 새로워진 Workspace 생성 과정을 소개해요. 이제 더 직관적인 흐름으로 필요한 설정을 놓치지 않고 진행할 수 있어요.Key updates
-
생성 단계 분리(UX 개편): 직관성을 높이기 위해 생성 과정을 세 단계로 나눴어요.
- Step 1(Select resource): 하드웨어 스펙을 선택해 보세요.
- Step 2(Deployment settings): 이미지, SSH 키, 포트, 볼륨 등 상세 설정을 진행해 보세요.
- Step 3(Review): 설정한 내용과 예상 비용을 최종적으로 확인하고 배포할 수 있어요.
- SSH Key 바로 생성: Workspace 생성 페이지에서 SSH Key를 즉시 생성하고 내 컴퓨터에 저장할 수 있어요. 생성된 키는 Settings > SSH Keys에서도 관리할 수 있어요.
-
Custom Ports 오픈: 이제 원하는 커스텀 포트를 직접 열 수 있어요.
- 내 로컬 환경과 동일한 포트 구성을 Workspace에도 적용해 보세요.
- 오픈한 포트 정보는 Detail > Connect 페이지에서 확인하고 접속할 수 있어요.

