vesslctl은 VESSL Cloud의 커맨드라인 인터페이스예요. 터미널에서 Workspace, Batch Job, Storage, 팀 설정 등을 관리할 수 있어요.
왜 vesslctl인가요?
- 개발과 학습을 하나의 도구로: 인터랙티브 Workspace에서 개발하고, Batch Job으로 학습을 실행하는 걸 같은 CLI에서 할 수 있어요
- 팀을 위해 만들어졌어요: 조직과 팀 범위 지정으로 워크로드, Volume, 과금이 필요한 곳에서 격리돼요
- 유연한 Storage: 클러스터 간 접근이 필요하면 Object storage, 고성능 로컬 I/O가 필요하면 Cluster storage를 선택하고, 어떤 워크로드에든 Volume을 마운트할 수 있어요
- AI 네이티브: VESSL Cloud docs를 Claude Code, Cursor 등 MCP 호환 도구에 연결하면 AI 어시스턴트가 정확한 CLI 문서를 참조해요. AI 도구와 함께 사용하기를 확인하세요
- 스크립트 친화적: 쉘 스크립트로 명령어를 조합해서 하이퍼파라미터 탐색, 데이터 파이프라인, 자율 실험 루프를 만들 수 있어요
설치
지원 환경 — macOS 15 이상, Ubuntu 20.04 이상, Windows 10 이상. 그 외 별도 환경 의존성은 없어요.
글로벌 플래그
모든 명령어에서 사용할 수 있는 플래그예요:| 플래그 | 약어 | 설명 |
|---|---|---|
--org | 기본 조직을 오버라이드해요 | |
--team | -t | 기본 팀을 오버라이드해요 |
--output | -o | 출력 형식: table (기본값), json, 또는 csv |
기본값 설정
로그인하면vesslctl이 기본 조직과 팀을 선택하라고 안내해요. 언제든 변경할 수 있어요:
쉘 자동완성
탭 자동완성을 켜는 가장 쉬운 방법은install 서브커맨드예요. 쉘을 자동으로 감지하고 적절한 위치에 스크립트를 설치해 줘요:
~/.zshrc에 fpath 설정이 필요한 경우 안내 메시지를 띄워 줘요.
수동 설정
수동 설정
직접 completion 스크립트를 관리하고 싶다면:
업데이트
vesslctl을 최신 버전으로 유지하세요:
명령어 개요
| 명령어 | 설명 |
|---|---|
workspace | GPU Workspace 관리 (생성, SSH, 일시정지, 종료) |
job | Batch Job 제출 및 관리 |
volume | Storage Volume 관리 |
storage | Storage 백엔드 조회 및 관리 |
org | 조직 전환 및 관리 |
team | 팀 전환 및 관리 |
cluster | 클러스터 조회 |
resource-spec | GPU/CPU 리소스 설정 조회 (별칭: rs) |
tag | Job에 부착할 태그 생성·조회·관리 |
skill | AI 코딩 에이전트용 vesslctl 스킬 설치 |
config | CLI 설정 및 인증 관리 |
auth | 로그인, 로그아웃, 인증 상태 확인 |
billing | 크레딧 잔액과 소모율 조회 |
completion | 쉘 자동완성 — install로 자동 설정, 또는 bash|zsh|fish로 수동 생성 |
update | vesslctl 최신 버전으로 업데이트 |
install | vesslctl을 PATH 디렉토리에 설치 |