용어집

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

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

Template (템플릿): 컨테이너 이미지와 런처 포트 설정 및 기본 리소스 값의 조합. 전체 공개 (관리자 소유, 모든 사용자에게 표시) 또는 사용자 소유 (생성자에게만 표시)로 설정할 수 있습니다.

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/ 경로가 없습니다.