docker/README.md

vkgs-sim 개발 이미지

로컬 개발 환경(scripts/local_setup.sh 가 만드는 micromamba 환경 vkgs)을 같은 버전 그대로 담은 Docker 이미지. 로컬 개발은 그대로 두고, 같은 환경을 다른 기계나 다른 사람에게 옮길 때 쓴다.

무엇	어디서
컴파일러 gcc 12 · CUDA 12.1 nvcc · Vulkan 로더/헤더 · glslc · cmake · Tracy 의존성	docker/conda-lock.txt (conda 잠금)
torch 2.4.1+cu121 · torchvision 0.19.1 · gsplat 1.4.0 (확장 미리 빌드)	docker/Dockerfile
나머지 파이썬 패키지	docker/requirements.lock.txt (pip 잠금, --no-deps)
소스 · 설정 · outputs · cache	이미지에 없음 — 실행 때 저장소를 호스트와 같은 경로로 bind-mount

ArtiFixer 추론 환경(micromamba artifixer)은 들어 있지 않다.

쓰기

docker compose build dev                       # 이미지 dzqf0000/vulkansim:1.0 (처음 약 20~30분)
xhost +local:                                  # 창 뷰어를 쓸 때 (호스트에서 한 번)
docker compose run --rm dev vkgs-doctor        # CUDA · Vulkan · 데이터셋 점검
docker compose run --rm dev bash               # 셸 — 안에서 바로 nusim, cmake, pytest

안에서 처음 한 번 뷰어를 빌드한다:

cmake -S src/vkgs -B build -GNinja && cmake --build build

• build/ 는 호스트의 build-docker/ 로 가려진다. 호스트 build/ 는 호스트 conda 컴파일러 경로를 담은 CMake 캐시라 같이 쓰면 서로 깨진다. nusim 은 <저장소>/build/vkgs_viewer 를 찾으므로 안에서는 경로가 그대로다.
• 저장소를 호스트와 같은 경로($PWD)로 마운트한다. outputs/gs_day/*/segments.txt 같은 파일이 절대 경로를 담고 있다.
• nuScenes 원본은 :ro 로 마운트된다 (NUSCENES_ROOT, 기본은 호스트 NAS 경로).
• 컨테이너 사용자는 uid 1000 — outputs/ 에 만든 파일이 호스트 사용자 소유가 된다.
• GPU 는 하나(8 GB)다. 호스트에서 학습·ArtiFixer 가 돌고 있으면 컨테이너 안 뷰어도 메모리 부족으로 실패한다.

잠금 파일 다시 뽑기 (로컬 환경에 패키지를 더했을 때)

~/.local/bin/micromamba env export -n vkgs --explicit > docker/conda-lock.txt
# pip 잠금: pip 로 설치된 것만 (conda 가 넣은 파이썬 패키지 · torch · gsplat · nusim 제외)
~/micromamba/envs/vkgs/bin/python - > docker/requirements.lock.txt <<'E'
import importlib.metadata as m
skip = {"nusim", "gsplat", "torch", "torchvision", "triton", "pip", "setuptools", "wheel",
        "nuscenes-devkit", "lpips", "piq"}
rows = sorted((f"{d.metadata['Name']}=={d.version}" for d in m.distributions()
               if (d.read_text("INSTALLER") or "").strip() == "pip"
               and d.metadata["Name"].lower() not in skip and not d.metadata["Name"].lower().startswith("nvidia-")),
              key=str.lower)
print("# docker/Dockerfile 이 --no-deps 로 넣는 pip 패키지 — 로컬 vkgs 환경에서 뽑은 것")
print("\n".join(rows))
E
docker compose build dev