ssh-key 명령(별칭: ssh-keys)으로 VESSL Cloud 계정에 등록된 SSH 공개 키를 관리할 수 있어요. 키는 슬러그(slug, 고유 식별자)로 참조해요. 이 슬러그를 vesslctl workspace create --ssh-key에 전달하면 새 Workspace에 사용할 키를 지정할 수 있어요.
list
계정에 등록된 모든 SSH 키를 조회해요.
출력에는 각 키의 슬러그, 이름, 지문(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 접속을 계속 허용해요.
