워크스페이스 플랫폼 운영 방법

이 체크리스트는 설치 후 LabPod 호스트를 운영할 때 자주 쓰는 관리자 페이지를 다룹니다.

공유 마운트 추가

데이터셋, 모델 가중치, 수업 자료, 공유 scratch 공간에는 공유 마운트를 사용합니다.

1. LabPod 밖에서 호스트 디렉터리를 만들고 소유권과 권한을 설정합니다.
2. /admin/shared-mounts를 엽니다.
3. New mount를 클릭합니다.
4. Name, Host path, Container path를 설정합니다.
5. 데이터셋이나 모델 가중치는 Read-only를 켜 둡니다.
6. 저장합니다.

이 마운트는 새로 만드는 워크스페이스에 적용됩니다. 실행 중인 워크스페이스에는 stop/start 후에 바뀐 마운트가 반영됩니다.

관리자가 설정할 수 있는 host path를 제한하려면 /etc/labpod/labpod.env에 LABPOD_SHARED_MOUNT_ROOTS를 설정하고 labpod.service를 재시작합니다.

이미지 pull, prune, 삭제

전역 템플릿이 쓰는 공유 이미지는 /admin/images에서 관리합니다.

1. /admin/images를 엽니다.
2. 템플릿을 enable하기 전에 필요한 이미지 ref를 pull합니다.
3. 같은 페이지에서 pull/build 로그를 확인합니다.
4. active container, reclaim, sharing, 추적되지 않은 컨테이너 정보를 확인할 때는 Manage를 사용합니다. 이 선택 항목을 확인하기 전에도 이미지 목록은 빠르게 표시됩니다.
5. 디스크 여유가 부족해지면 쓰지 않는 layer를 prune합니다.
6. 특정 tagged image를 shared store 또는 사용자 store에서 제거해야 할 때는 Delete images를 사용합니다.

사용자가 직접 빌드하거나 pull한 이미지는 각 사용자의 루트리스 저장소에 남습니다. 공유 pull은 공유 이미지 저장소가 설정돼 있으면 그 저장소를 씁니다.

Prune과 delete는 다른 작업입니다. Prune은 저장소 전체에서 dangling 상태의 untagged layer만 제거합니다. Delete images는 이름이 있는 이미지 하나를 제거합니다. 워크스페이스가 아직 해당 이미지를 참조하면 LabPod가 강제 삭제 전에 경고합니다. 삭제 후에는 이미지가 다시 pull되거나 rebuild되기 전까지 그 워크스페이스가 다음 시작 시 실패할 수 있습니다.

Compliance 검토

Opt-in 템플릿이나 레지스트리를 enable하기 전에 /admin/compliance를 사용합니다.

1. 대기 중인 템플릿 EULA를 검토합니다.
2. 레지스트리 약관을 검토합니다.
3. 연구실에서 사용할 수 있는 항목만 승인합니다.
4. 템플릿이나 이미지 페이지로 돌아가 build/pull 작업을 이어갑니다.

이 승인 내역은 감사 로그에 기록됩니다.

런타임 설정 조정

서비스 재시작 없이 바꿀 수 있는 설정은 /admin/runtime에서 편집합니다.

• Crash notification에 표시할 server nickname.
• 새 start에 적용되는 CPU/MEM cgroup enforcement.
• HAMi/MIG 모드용 GPU sharing switch.
• Idle indicator window.
• Idle nudge days.
• Usage sample과 session retention.
• 감사 로그 보관 기간. 감사 기록은 기본값으로 무기한 보관하며 양수 값을 설정하면 오래된 기록을 영구적으로 제거합니다.

실행 중인 워크스페이스는 시작할 때 사용한 flag를 그대로 유지합니다. 바뀐 runtime 동작을 적용하려면 워크스페이스를 stop/start해야 합니다.

사용량과 변경 이력 확인

/admin/resources는 사용자, 워크스페이스, GPU, disk usage, image storage, idle candidate 같은 실시간 host 상태를 보여줍니다.

/admin/usage는 일별 CPU/GPU rollup과 CSV export를 제공합니다.

/admin/audit은 “누가 무엇을 바꿨는가”를 확인할 때 씁니다. 사용자 생성, policy 변경, 템플릿 변경, 이미지 작업, 워크스페이스 lifecycle, 로그인 실패를 기록합니다.

라이선스 관리

현재 trial 또는 signed license 상태는 /admin/license에서 확인합니다(인증된 모든 사용자가 상태를 볼 수 있습니다). activation request 복사와 .lic 파일 설치는 root 계정만 할 수 있습니다.

동일한 CLI 명령:

Ubuntu / Debian Rocky / RHEL / AlmaLinux / Fedora

sudo labpod admin license show
sudo labpod admin license request
sudo labpod admin license verify ./license.lic
sudo labpod admin license install ./license.lic

# Run these as root
labpod admin license show
labpod admin license request
labpod admin license verify ./license.lic
labpod admin license install ./license.lic