핵심 개념
다른 모든 페이지에서 사용하는 용어입니다. 각 용어는 해당 내용을 자세히 설명하는 페이지로 연결됩니다.
워크스페이스
섹션 제목: “워크스페이스”워크스페이스는 한 사용자에게 할당된 영속적인 Podman 컨테이너로, CPU, 메모리, GPU 할당량과 권고 디스크 알림이 적용됩니다. 사용자나 관리자가 중지할 때까지 실행 상태를 유지하며, 현재 릴리즈에서는 자동 중지 기능이 없습니다.
각 워크스페이스에는 다음이 포함됩니다:
- 컨테이너 이미지와 사용 가능한 앱을 정의하는 템플릿.
- 리소스 제한 (CPU 코어, 메모리, GPU) 및 권고 디스크 알림.
- 실행 중인 컨테이너 내에서 사용자가 시작하거나 중지하는 런처 (앱) 세트.
- 중지/시작 주기에 걸쳐 유지되는 개인 HOME 볼륨.
- 호스트의
~/work를 가리키는/work바인드 마운트. 코드와 데이터는 워크스페이스를 삭제해도 보존됩니다.
런처는 실행 중인 워크스페이스 내부에서 podman exec로 시작하는 서비스입니다. 런처를
시작하거나 중지해도 워크스페이스가 재시작되거나 다른 런처에 영향을 미치지 않습니다.
기본 제공 런처: JupyterLab, code-server (브라우저의 VS Code), LabPod Terminal, TensorBoard, MLflow. 사용 가능한 런처는 템플릿에 따라 다릅니다.
→ 앱 및 런처
템플릿
섹션 제목: “템플릿”템플릿은 컨테이너 이미지에 런처 구성과 리소스 기본값을 더한 것입니다. 관리자는 모든 사람이 사용할 수 있는 전역 템플릿을 등록하며, 사용자도 자신만의 사용자 소유 템플릿을 만들고 내보내기/가져오기 번들로 공유할 수 있습니다.
공유 마운트
섹션 제목: “공유 마운트”관리자가 구성한 호스트 경로(예: /data/datasets)로, 모든 워크스페이스에 마운트됩니다.
데이터셋을 복제하지 않고 모든 사용자가 대용량 데이터셋을 공유할 때 사용합니다.
GPU 모드
섹션 제목: “GPU 모드”LabPod는 관리자가 GPU별로 구성하는 세 가지 GPU 할당 모드를 지원합니다:
| 모드 | 의미 |
|---|---|
| GPU 전체 | Container Device Interface(CDI)로 워크스페이스당 NVIDIA GPU 하나 전체를 할당 |
| 분할 GPU | 소프트웨어 파티셔닝으로 여러 워크스페이스가 하나의 GPU를 공유 |
| MIG 슬라이스 | A100 또는 H100에서 하드웨어로 파티셔닝된 슬라이스 |
GPU를 요청하지 않는 워크스페이스는 CPU 전용으로 실행됩니다.
루트리스 Podman과 keep-id
섹션 제목: “루트리스 Podman과 keep-id”모든 워크스페이스는 루트리스 Podman을 사용해 소유자의 Linux 계정으로 실행됩니다. --userns keep-id
플래그가 호스트 UID와 컨테이너 UID를 일치시키므로, 워크스페이스 안에서 만든 파일도
호스트에서 소유권이 자연스럽고 SSH로 접근할 때 혼란이 없습니다.
리버스 프록시와 /ws/ URL
섹션 제목: “리버스 프록시와 /ws/ URL”LabPod 서버는 모든 워크스페이스 트래픽을 프록시합니다. 런처에서 열기를 클릭하면 URL이
http://<host>:24680/ws/<workspace-id>/jupyter/와 같은 형태가 됩니다. 모든 트래픽이
LabPod 세션 쿠키로 흐르므로 개별 앱에 따로 로그인할 필요가 없습니다.
사용자 선언 포트
섹션 제목: “사용자 선언 포트”워크스페이스 안에서 커스텀 서비스(Gradio, Streamlit 등)에 쓸 명명된 포트를 선언할 수 있습니다.
선언한 각 포트는 브라우저에서 접근할 수 있는 /ws/<id>/_user/<name>/ 프록시 경로를 갖습니다.
런처는 계속 /ws/<id>/<launcher>/ 경로를 사용하므로 선언 포트와 런처의 이름이 같아도 됩니다.
검색된 컨테이너
섹션 제목: “검색된 컨테이너”LabPod 외부에서 Podman으로 직접 시작한 컨테이너는 LabPod 워크스페이스가 아닙니다. LabPod는
이 컨테이너의 CPU, 메모리, GPU, 프로세스 사용량을 여유 용량으로 잘못 계산하지 않도록 읽기 전용
안전 및 용량 화면에 표시할 수 있습니다. 프록시 URL, 런처, 터미널, 로그, 사용자 선언 포트,
생명주기 작업은 제공하지 않습니다. 지원되는 워크스페이스가 필요하면 LabPod UI 또는
labpod ws create를 사용하십시오.
유휴 알림
섹션 제목: “유휴 알림”설정 가능한 일수 이상 워크스페이스가 유휴 상태이면 홈 페이지에 배지가 표시됩니다. 이는 표시 전용이며, 현재 릴리즈에서는 자동 중지 기능이 없습니다.
전체 용어집도 참고하세요.