VESSL Cloud Documentation

이 문서는 멤버를 위한 가이드에요. 조직을 처음 만든 분이라면 관리자 권한도 함께 가지고 있어요. 이 가이드를 마친 후 관리자 퀵스타트도 함께 읽어보세요.

계정 만들기

cloud.vessl.ai에서 계정을 만들고 이메일 인증으로 활성화해 주세요.

프로필 완성하기

이메일 인증이 끝나면 ID(사용자명)를 입력하고, Occupation과 Use case를 선택해 주세요. 이용약관 동의와 연령 확인 체크박스를 선택한 뒤 Let’s get started! 버튼을 눌러주세요.

ID, Occupation, Use case를 입력하고 약관에 동의하는 프로필 완성 화면

조직 만들기

조직 이름을 입력하고 Create 버튼을 눌러 Workspace를 설정해 주세요.

대시보드 둘러보기

조직을 만들면 메인 Workspaces 대시보드로 이동해요. 여기서 모든 컴퓨팅 환경을 관리할 수 있어요.

결제 수단 등록하기

Workspace를 만들기 전에 결제 수단을 등록해 주세요. 사이드바에서 Organization > Billing으로 이동한 뒤 Manage payment method를 눌러 카드를 등록하고, Add credits로 크레딧을 충전하면 돼요.

카드 등록과 크레딧 충전을 안내하는 Organization Billing 페이지

스토리지 볼륨 만들기

VESSL Cloud는 세 가지 스토리지를 제공해요. 처음부터 용도에 맞는 스토리지를 고르면 I/O 병목으로 작업이 느려지거나 데이터를 잃는 일을 피할 수 있어요.

스토리지	속도	Pause 시 데이터	언제 써요?
Cluster storage	빠름(CephFS/NVMe)	보존돼요.	코드, 가상환경 등 pause 후에도 유지되어야 하는 파일. `/root`에 마운트
Object storage	느린 편(S3 기반)	보존돼요.	데이터셋, 모델 체크포인트, 팀이나 클러스터 간 공유 파일. `/shared`에 마운트
Temporary storage	빠름(로컬 디스크)	삭제돼요.	임시 작업용이에요. pause/terminate 하면 전부 사라져요.

Temporary storage만 쓰면 pause 하는 순간 코드와 데이터가 전부 사라져요. 중요한 작업을 시작하기 전에 반드시 Cluster storage 또는 Object storage 볼륨을 하나 이상 연결해 주세요.

이 퀵스타트에서는 Object storage 볼륨을 만들어 볼게요. 관리자가 Cluster storage를 아직 준비하지 않았더라도 바로 쓸 수 있어요. 사이드바에서 Object storage를 클릭하고 Create new volume 버튼을 눌러주세요. Volume name과 Description을 입력해서 Object storage 볼륨을 만들면 돼요.

이름과 설명을 입력해 새 볼륨을 만드는 멤버용 Object storage 페이지

Cluster storage 볼륨은 조직 관리자가 관리해요. 팀에 Cluster storage가 할당되어 있다면, 사이드바의 Cluster storage에서도 볼륨을 만들 수 있어요.

Cluster storage는 /root에 마운트하세요. 코드, ~/.cache, pip/conda 패키지가 pause 후에도 유지돼요.
Object storage는 /shared에 마운트하세요. Object storage는 속도가 느리고 파일시스템 동작이 달라서 /root는 VESSL Cloud에서 Object storage 마운트 경로로 허용되지 않아요. Cluster storage 마운트 경로와 겹치는 경로도 마찬가지로 막혀요.
Cluster storage는 리전에 종속돼요. Workspace를 만들 때 선택한 GPU와 같은 리전의 볼륨만 연결할 수 있어요.

Workspace 만들기

사이드바에서 Workspaces 탭으로 이동한 다음 New Workspace 버튼을 눌러주세요.이름을 입력하고 리소스 스펙에서 GPU 제품, 리전, GPU 수량을 선택해 주세요. 방금 만든 Object storage 볼륨을 연결하고 Create를 누르면 돼요.

GPU 제품·리전·수량을 고르고 Object storage를 연결하는 New Workspace 생성 폼

이제 이 Workspace에서 바로 Jupyter Notebook을 실행할 수 있어요.

Workspace 살펴보기

Connect, Details, Logs, Metrics 탭이 있는 Workspace 상세 페이지

Connect: Workspace 상세 페이지에서 Connect 탭을 열면 Jupyter(포트 8888) 또는 SSH(포트 22)로 접속할 수 있어요. 자세한 내용은 Connect 페이지를 참고해 주세요.
Details: GPU, 스토리지, 이미지 등 스펙을 확인할 수 있어요.
Logs: 컨테이너 로그를 실시간으로 볼 수 있어요.
Metrics: CPU, GPU, 메모리 사용량을 그래프로 확인할 수 있어요.

JupyterLab에서 코드 실행하기

Workspace 상세 페이지에서 Connect 탭을 열고 JupyterLab 버튼을 눌러주세요.

JupyterLab과 SSH로 Workspace에 접속할 수 있는 Connect 탭

JupyterLab이 열리면 Notebook → Python 3(ipykernel)을 선택해서 새 노트북을 만들고 아래 코드를 실행해 보세요.

print("Hello, VESSL Cloud!")

출력이 잘 나온다면 환경 설정이 모두 끝난 거예요.

SSH로 접속하고 싶다면 Connect 탭에서 SSH 키를 만들거나 선택한 뒤, 접속 명령어를 복사해서 쓰면 돼요.

정리하기(Clean up)

비용이 더 나가지 않게 하려면, 사이드바의 Workspaces 탭으로 이동해서 실행 중인 Workspace의 케밥 메뉴(점 세 개)를 누르세요. Pause를 눌러서 잠깐 멈추거나, Terminate를 눌러서 완전히 삭제할 수 있어요.

Workspace 케밥 메뉴에서 Pause 또는 Terminate를 선택해 비용을 정리하는 모습

Paused 상태에서는 컴퓨팅 비용은 안 나가지만, 스토리지 비용(Cluster storage: $0.20/GiB/월)은 계속 청구돼요. 비용을 완전히 멈추려면 Terminated 상태로 만들어야 해요.일시정지(Pause)하면 임시 스토리지(Temporary storage)에 있는 데이터는 사라지니 주의해 주세요.

완전히 삭제하려면 케밥 메뉴에서 Terminate를 누르고 Workspace 이름을 입력해서 삭제를 확정해 주세요.

Documentation Index