Skip to main content
vesslctl은 VESSL Cloud의 커맨드라인 인터페이스예요. 터미널에서 Workspace, Batch Job, Storage, 팀 설정 등을 관리할 수 있어요.

​
왜 vesslctl인가요?

  • 개발과 학습을 하나의 도구로: 인터랙티브 Workspace에서 개발하고, Batch Job으로 학습을 실행하는 걸 같은 CLI에서 할 수 있어요.
  • 팀을 위해 만들어졌어요: 조직과 팀 범위 지정으로 워크로드, Volume, 과금이 필요한 곳에서 격리돼요.
  • 스토리지 선택이 자유로워요: 클러스터 간 접근이 필요하면 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 이상. 그 외 별도 환경 의존성은 없어요.
1

vesslctl 설치

2

로그인

브라우저에서 OAuth 인증 페이지가 열려요. 브라우저를 사용할 수 없는 환경에서는 이메일/비밀번호 로그인으로 전환돼요.
3

설치 확인

​
글로벌 플래그

모든 명령어에서 사용할 수 있는 플래그예요:

​
기본값 설정

로그인하면 vesslctl이 기본 조직과 팀을 선택하라고 안내해요. 언제든 변경할 수 있어요:
현재 설정을 확인하려면:

​
환경 변수

vesslctl은 아래 환경 변수를 읽어요. 플래그가 환경 변수보다 우선하고, 환경 변수가 설정 파일보다 우선해요:
VESSL Cloud Workspace 내부에서는 vesslctl이 SIDECAR_INITIAL_ACCESS_TOKEN으로 미리 인증돼 있어요. vesslctl auth status로 확인해 보세요. Workspace 터미널에서는 vesslctl auth login을 따로 실행하지 않아도 돼요.

​
셸 자동완성

탭 자동완성을 켜는 가장 쉬운 방법은 install 서브커맨드예요. 셸을 자동으로 감지하고 적절한 위치에 스크립트를 설치해 줘요:
멱등성이 보장돼서 CLI 업데이트 후 다시 실행해도 안전해요. zsh를 쓰면 ~/.zshrc에 fpath 설정이 필요한 경우 안내 메시지를 띄워 줘요.
직접 completion 스크립트를 관리하고 싶다면:

​
업데이트

vesslctl을 최신 버전으로 유지하세요:

​
명령어 개요