메인 콘텐츠로 건너뛰기

​
Jupyter

워크스페이스 상세 페이지의 Connect 탭에서 Jupyter 노트북에 바로 접속할 수 있어요.
워크스페이스 Jupyter 열기 스크린샷
  • 포트 번호를 누르거나 Open Jupyter 버튼을 클릭하면 브라우저에서 바로 새 창이 열려요.
  • 별도로 설정할 것은 없어요.

​
SSH

터미널에서 SSH 명령어를 입력해서 접속할 수도 있어요.
워크스페이스 SSH 연결 스크린샷

​
터미널로 접속하는 방법

  1. 워크스페이스 상세 페이지에서 Connect 탭을 열고 SSH 접속 명령어를 찾아보세요.
  2. 복사 아이콘을 눌러서 명령어를 복사해 주세요.
  3. 터미널에 복사한 명령어를 붙여넣으세요.
  4. /path/to/key 부분만 내 컴퓨터에 있는 실제 비밀 키(private key) 파일 경로로 바꿔서 실행하면 돼요.
SSH로 접속하려면 먼저 계정 설정에 SSH 키가 등록되어 있어야 해요. 아직 등록하지 않았다면 SSH 키 설정 문서를 참고해 주세요.

​
VS Code Remote-SSH로 접속하기

VS Code를 주로 쓴다면 Remote - SSH 확장으로 워크스페이스에 바로 접속할 수 있어요.
  1. VS Code 확장 Remote - SSH를 설치해 주세요.
  2. 워크스페이스 상세 페이지에서 Connect 탭을 열고 SSH 접속 명령어를 복사해 주세요.
  3. VS Code에서 Command Palette를 열고 Remote-SSH: Add New SSH Host...를 실행해 주세요.
  4. 복사한 SSH 명령어를 붙여넣으세요.
  5. -i 뒤에 있는 비밀 키(private key) 경로를 내 로컬에 저장된 키 파일 경로로 바꿔주세요.
  6. SSH config 파일을 선택하라는 안내가 나오면 (보통) ~/.ssh/config를 선택해 주세요.
  7. Remote-SSH: Connect to Host...를 실행하고, 방금 추가한 Host를 선택해 접속하면 돼요.
VS Code Command Palette에서 Remote-SSH 호스트 추가
같은 클러스터에 있는 워크스페이스를 여러 개 추가하면 도메인이 동일할 수 있어요(예: capella.cloud.vessl.ai). 이 경우 ~/.ssh/config에 중복된 항목이 생길 수 있어요.이 문제를 피하려면, 워크스페이스마다 Host(별칭)를 고유하게 만들어 주세요(예: capella.cloud.vessl.ai-<workspace_name>). HostName은 실제 도메인으로 유지하고, 복사한 명령어에 있는 워크스페이스별 Port 값을 사용하면 돼요.
Host 별칭을 구분하지 않아서 중복될 수 있는 SSH config 예시
Host 별칭에 구분자를 추가한 SSH config 예시
예시 ~/.ssh/config: 
Host capella.cloud.vessl.ai-<workspace_name>
  HostName capella.cloud.vessl.ai
  User root
  Port 32154
  IdentityFile /your/local/path/to/<key-name>

Host capella.cloud.vessl.ai-<workspace_name_2>
  HostName capella.cloud.vessl.ai
  User root
  Port 38712
  IdentityFile /your/local/path/to/<key-name>

​
커스텀 포트 (Custom Ports)

워크스페이스를 만들 때 Custom Ports를 열었다면, 워크스페이스 상세 페이지의 Connect 탭에서 접속 정보를 확인할 수 있어요.
  • Internal Port: 워크스페이스 내부에서 실행 중인 서비스의 포트 번호예요.
  • External Link/Port: 외부에서 접속할 수 있는 주소예요.
제공된 링크를 클릭하거나 주소를 복사해서 내 앱이나 서비스에 접속해 보세요.