용어집

Workspace (워크스페이스): 특정 사용자 전용 영속성 Podman 컨테이너로, CPU, 메모리, GPU 할당량과 권고 디스크 알림이 적용됩니다. 사용자나 관리자가 중지할 때까지 계속 실행됩니다.

Launcher (런처): podman exec로 실행 중인 워크스페이스 내부에서 시작되는 서비스 (JupyterLab, code-server, LabPod Terminal, TensorBoard, MLflow). 런처를 시작하거나 중지해도 워크스페이스가 재시작되지 않습니다.

Workspace template (워크스페이스 템플릿): 컨테이너 이미지와 런처 포트 설정, 기본 리소스 값의 조합입니다. 관리자 UI에서는 Workspace templates, 사용자 본인 소유 목록은 My workspace templates로 표시됩니다. 전체 공개(관리자 소유, 모든 사용자에게 표시) 또는 사용자 소유(생성자에게만 표시)로 설정합니다. 기존 API와 CLI의 명령 및 필드에는 짧은 기술 식별자인 template과 workspace_type이 남아 있지만, 제품 용어는 워크스페이스 템플릿으로 통일합니다.

Shared mount (공유 마운트): 모든 워크스페이스에 마운트되는 관리자 설정 호스트 경로 (일반적으로 읽기 전용). 대용량 데이터셋을 중복 없이 공유할 때 사용합니다.

User-declared port (사용자 선언 포트): 사용자가 워크스페이스 내부의 사용자 정의 프로세스 (Gradio, Streamlit 등)를 위해 예약하는 이름 붙은 포트 슬롯. LabPod 리버스 프록시의 /ws/<workspace-id>/_user/<name>/에서 접근합니다. 이 네임스페이스는 런처 경로와 분리됩니다.

Discovered container (발견된 컨테이너): 사용자가 호스트에서 LabPod 외부의 Podman으로 직접 시작한 컨테이너. LabPod가 읽기 전용 안전 및 용량 화면에 표시하지만 워크스페이스는 아닙니다. LabPod 프록시, 런처, 터미널, 로그, 선언 포트, 생명주기 기능을 제공하지 않습니다.

Rootless Podman: 각 컨테이너가 root가 아닌 소유 Linux 사용자로 실행되는 데몬리스 컨테이너 런타임. LabPod는 모든 워크스페이스 컨테이너에 rootless Podman을 사용합니다.

keep-id: --userns=keep-id Podman 플래그. 컨테이너 UID를 호스트 UID와 일치시켜, 워크스페이스 내에서 생성된 파일이 호스트에서 자연스러운 소유권을 갖도록 합니다.

CDI (Container Device Interface): 하드웨어 디바이스를 컨테이너에 전달하기 위한 표준 인터페이스. LabPod는 CDI를 사용하여 전체 NVIDIA GPU를 워크스페이스에 할당합니다: --device nvidia.com/gpu=<index>.

Fractional GPU (분할 GPU): 여러 워크스페이스가 하나의 물리적 GPU를 동시에 공유할 수 있는 소프트웨어 파티셔닝 모드. 각 워크스페이스는 메모리와 컴퓨팅 비율을 선언합니다. LABPOD_GPU_SHARING_LIB_PATH를 통해 구성된 GPU 공유 런타임 라이브러리가 필요합니다.

MIG (Multi-Instance GPU): A100 및 H100 GPU에서 사용 가능한 NVIDIA 하드웨어 파티셔닝. 하나의 물리적 GPU를 메모리와 컴퓨팅이 분리된 독립 슬라이스로 분할합니다. nvidia-smi를 사용하여 운영자가 사전에 설정합니다.

Idle nudge (유휴 알림): 워크스페이스가 idle_nudge_days 연속 일수 동안 유휴 상태이면 홈 페이지에 표시되는 배지입니다. 표시 전용이며, LabPod는 유휴 워크스페이스를 자동 중지하지 않습니다.

/ws/ reverse proxy (/ws/ 리버스 프록시): 브라우저 요청을 워크스페이스 컨테이너로 라우팅하는 LabPod 내장 HTTP 프록시. 런처는 /ws/<workspace-id>/<launcher>/, 사용자 선언 포트는 /ws/<workspace-id>/_user/<name>/ 경로를 사용합니다. 모든 워크스페이스 트래픽은 LabPod 세션 쿠키로 전달됩니다. 외부 Podman 컨테이너에는 /ws/c:<container>/ 또는 /ws/_discovered/ 경로가 없습니다.