VESSL Cloud Documentation

vesslctl은 bash, zsh, fish, PowerShell용 자동완성 스크립트를 함께 배포해요. 가장 빠른 방법은 vesslctl completion install이 쉘을 자동 감지해서 표준 위치에 스크립트를 설치하도록 두는 거예요.

completion install

$SHELL에서 현재 쉘을 감지해 적절한 경로에 자동완성 스크립트를 써요. 멱등성이 보장되니까 vesslctl을 업그레이드한 뒤에 다시 실행해도 안전해요.

vesslctl completion install

지원 쉘: bash, zsh, fish. PowerShell은 아래 수동 설정을 사용해 주세요. 기본 설치 경로:

쉘	경로
bash	`~/.local/share/bash-completion/completions/vesslctl`
zsh	`~/.zsh/completions/_vesslctl`
fish	`~/.config/fish/completions/vesslctl.fish`

설치 후에는 쉘을 재시작하거나 rc 파일을 source 해 주세요. zsh의 경우 ~/.zshrc에 자동완성 디렉토리가 등록돼 있지 않으면 인스톨러가 추가할 스니펫을 안내해 줘요:

fpath=(~/.zsh/completions $fpath)
autoload -U compinit; compinit

요청한 쉘의 자동완성 스크립트를 stdout으로 출력해요. 스크립트 위치를 직접 관리하고 싶을 때 사용해요.

vesslctl completion bash
vesslctl completion zsh
vesslctl completion fish
vesslctl completion powershell

수동 설정 예시:

vesslctl completion bash > /etc/bash_completion.d/vesslctl

인자와 플래그 값에도 자동완성이 적용돼요. 활성화한 후에는 --cluster, --resource-spec, --org 같은 플래그나 Workspace/Job slug 자리에서 Tab을 누르면 현재 조직과 팀의 실제 값이 후보로 떠요.