메인 콘텐츠로 건너뛰기

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.

ssh-key 명령(별칭: ssh-keys)으로 VESSL Cloud 계정에 등록된 SSH 공개 키를 관리할 수 있어요. 키는 슬러그(slug, 고유 식별자)로 참조해요. 이 슬러그를 vesslctl workspace create --ssh-key에 전달하면 새 Workspace에 사용할 키를 지정할 수 있어요.

​
list

계정에 등록된 모든 SSH 키를 조회해요. 
vesslctl ssh-key list
출력에는 각 키의 슬러그, 이름, 지문(fingerprint), 생성 시각이 표시돼요. 다른 명령에 사용할 슬러그를 그대로 복사해서 쓰면 돼요.
컬럼설명
SLUG키 고유 식별자. --ssh-key 플래그에 전달해요.
NAME키를 추가할 때 지정한 이름
FINGERPRINT공개 키의 SHA-256 지문
CREATED키 등록 시각(RFC 3339 형식)

​
add

새 SSH 공개 키를 등록해요. 기존 공개 키 파일을 업로드하거나, 서버에서 키페어를 새로 생성할 수도 있어요. 
vesslctl ssh-key add --name <name> --public-key-file <path>
플래그필수설명
--name예키를 식별할 이름(예: macbook-personal)
--public-key-file조건부공개 키 파일 경로(보통 ~/.ssh/id_ed25519.pub 또는 ~/.ssh/id_rsa.pub). --generate를 쓰지 않으면 필수예요.
--generate조건부서버에서 키페어를 새로 생성해요. 개인 키는 한 번만 출력되고 서버에 저장되지 않으니 반드시 저장해 두세요. --public-key-file과 함께 사용할 수 없어요.
예시: 기존 공개 키 업로드 
vesslctl ssh-key add \
  --name macbook-personal \
  --public-key-file ~/.ssh/id_ed25519.pub
예시: 서버에서 키페어 새로 생성 
vesslctl ssh-key add --name temporary-runner --generate
명령이 성공하면 새로 등록된 키의 슬러그가 출력돼요. 이 슬러그를 vesslctl workspace create --ssh-key <ssh-key-slug>에 사용하면 돼요.
--generate 옵션은 개인 키를 터미널에 단 한 번 출력하고 서버에 저장하지 않아요. 출력 결과를 즉시 파일(예: ~/.ssh/<key-name>)로 저장하고 chmod 600으로 권한을 잠가 두세요. 세션을 닫으면 키를 다시 받을 수 없어요.

​
delete

계정에 등록된 SSH 공개 키를 삭제해요. 삭제할 키는 슬러그로 지정해요. 
vesslctl ssh-key delete <ssh-key-slug>
플래그약어설명
--yes-y확인 프롬프트 건너뛰기
예시: 
vesslctl ssh-key delete macbook-personal-abc123 --yes
키를 삭제해도 VESSL Cloud 계정에서만 제거돼요. 그 키를 사용 중인 Workspace는 종료(terminate)될 때까지 그 키로 SSH 접속을 계속 허용해요.