워크스페이스 시작 방법

이 문서는 새 워크스페이스를 만들 때 바로 따라 할 수 있는 체크리스트입니다. 개념 설명은 워크스페이스 및 템플릿을 참고하세요.

워크스페이스 만들기

1. 워크스페이스 홈에서 Create를 클릭합니다.
2. 템플릿을 고릅니다.
   • 전역 템플릿은 관리자가 유지합니다.
   • My templates는 직접 만들거나 가져온 비공개 템플릿입니다.
3. 워크스페이스 이름을 입력하거나 추천 이름을 그대로 둡니다.
4. 기본 리소스 값을 확인합니다.
5. CPU, 메모리, GPU, 폴더, 환경 변수를 바꾸려면 Advanced를 펼칩니다.
6. Create를 클릭합니다.

템플릿을 선택해도 다운로드가 시작되지는 않습니다. 레지스트리 이미지가 없으면 양식에서 Pull을 제안하고 다운로드 전에 확인을 받습니다. Dockerfile 기반 개인 템플릿은 Templates → My templates에서 Build를 사용합니다. 관리자 빌드 전역 템플릿은 Pull하면 준비된 이미지를 내 저장소로 복사합니다. 아직 준비되지 않았다면 관리자에게 build를 요청하세요.

CPU와 메모리 선택

Advanced에서 다음 값을 설정합니다.

• CPU: 워크스페이스가 사용할 수 있는 CPU 코어 수입니다.
• Memory: GB 단위의 RAM 제한입니다.

전처리나 dataloader 작업이 많으면 CPU를 늘리고 큰 데이터셋이나 노트북, 모델 로딩에는 메모리를 늘립니다. 서버가 cgroup v1에서 실행 중이면 UI가 CPU와 메모리 제한이 강제되지 않는다고 알려줍니다.

GPU 선택

GPU 컨트롤은 관리자가 켠 기능과 내 할당량에 따라 달라집니다.

모드	사용 시점
No GPU	코드 편집, 데이터 전처리, CPU 전용 작업을 할 때
Whole GPU	전체 장치 성능이나 호환성이 필요할 때
Shared GPU (HAMi)	메모리와 연산량 제한이 있는 GPU 일부만 필요할 때
MIG slice	서버에 MIG 지원 GPU가 있고 격리된 slice 크기가 필요할 때

전체 GPU가 모두 사용 중이어도 워크스페이스를 먼저 만들고 GPU가 비었을 때 시작할 수 있습니다. 템플릿이 GPU를 필수로 요구하고 내 할당량이 없으면 create 버튼이 비활성화됩니다.

폴더 추가

모든 워크스페이스는 호스트의 ~/work를 컨테이너 안의 /work로 자동 마운트합니다. 다른 폴더를 추가하려면:

1. More options - environment variables, folders를 펼칩니다.
2. Folders를 클릭합니다.
3. 관리자가 제공한 공유 마운트 preset을 유지하거나 체크 해제합니다.
4. 내 폴더를 추가하려면 Add folder를 클릭합니다.
5. 파일 선택기에서 호스트 폴더를 고릅니다.
6. Path inside workspace를 설정합니다. 예: /mnt/<내-사용자명>/my-project. LabPod은 내 폴더에 이처럼 쓸 수 있는 경로를 제안합니다. /work와 /home/<you>는 예약 경로입니다.
7. 워크스페이스가 해당 폴더에 써야 하는 경우가 아니라면 Read-only를 켜 둡니다.
8. Done을 클릭합니다.

폴더 변경은 워크스페이스가 시작될 때 적용됩니다. 이미 실행 중인 워크스페이스의 폴더 설정을 바꿨다면 중지한 뒤 다시 시작하세요.

환경 변수 추가

환경 변수는 컨테이너가 시작할 때 주입할 값을 지정합니다.

1. More options - environment variables, folders를 펼칩니다.
2. Add environment variable을 클릭합니다.
3. 이름과 값을 입력합니다.
4. 워크스페이스를 만듭니다.

예:

HF_HOME=/work/.hf-cache
WANDB_MODE=offline
CUDA_VISIBLE_DEVICES=0

오래 쓰는 비밀값은 템플릿에 넣지 않는 것이 좋습니다. 템플릿 환경 변수는 해당 템플릿에서 만든 모든 워크스페이스에 재사용됩니다. 워크스페이스별 토큰은 워크스페이스 설정에 넣고 필요 없어지면 교체하세요.

시작하고 열기

생성이 끝나면 워크스페이스 상세 페이지를 열고 Start를 클릭합니다. LabPod은 컨테이너를 실행하고 리소스 제한과 폴더 마운트, 환경 변수, 선택한 GPU를 적용합니다.

워크스페이스가 실행 중이면:

• 셸을 열려면 LabPod Terminal의 Open을 클릭합니다.
• JupyterLab, code-server, TensorBoard, MLflow 같은 launcher는 Start로 켭니다.
• 실행 중인 launcher의 Open을 클릭해 앱을 엽니다.

나중에 설정 변경

워크스페이스가 중지된 상태에서 상세 페이지의 Settings를 클릭합니다. 리소스, 폴더, 환경 변수를 바꿀 수 있습니다. 템플릿 자체는 고정되므로 다른 템플릿이 필요하면 새 워크스페이스를 만드세요.

중지 또는 삭제

컴퓨트를 더 쓰지 않을 때는 Stop을 클릭합니다. /work 파일과 워크스페이스 home은 stop/start 후에도 유지됩니다.

해당 워크스페이스가 더 이상 필요 없을 때만 Delete를 클릭합니다. Delete는 워크스페이스 설정을 삭제합니다. 워크스페이스별 home 디렉터리는 삭제되지 않고 계정 아래의 복구 가능한 위치로 보관(archive)됩니다. /work 디렉터리는 삭제하지 않습니다.