pnpm 기반 의존성 중복 제거를 통한 디스크 공간 20GB 확보

Context

npm의 개별 프로젝트별 의존성 복제 방식으로 인한 과도한 디스크 공간 낭비 발생. 다수 프로젝트에서 중복되는 패키지가 각 프로젝트의 node_modules에 독립적으로 저장되는 비효율적 구조의 한계 분석.

Technical Solution

• Content-addressable store 도입을 통한 전역 단일 패키지 저장 구조 설계
• Symlinks, Hardlinks 및 APFS Reflinks를 활용한 물리적 복제 없는 의존성 참조 메커니즘 구현
• pnpm env 기능을 통한 Node version manager 통합으로 런타임 및 글로벌 도구의 중복 저장 제거
• devEngines와 engine-strict 설정을 통한 프로젝트별 런타임 버전 강제 및 일관성 확보
• npx only-allow pnpm 적용을 통한 패키지 매니저 혼용 방지 및 환경 정규화

Impact

• 의존성 중복 제거를 통해 실질적인 디스크 공간 20GB 확보
• 프로젝트당 평균 500MB 규모의 node_modules 중복 제거로 스토리지 효율 극대화

Key Takeaway

단순 도구 교체가 아닌 저장 구조의 추상화(Virtual Store)를 통해 리소스 낭비를 줄이고 환경 일관성을 확보하는 엔지니어링 효율화 사례.