TurboRepo와 PNPM

코드베이스가 커지고 서비스가 복잡해질수록, 개발팀은 효율적인 코드 관리 방식에 대한 고민에 빠지게 됩니다. 여러 프로젝트와 라이브러리를 하나의 저장소에서 관리하는 모노레포(Monorepo)가 그 강력한 대안으로 떠오르고 있죠.

모노레포는 코드 공유와 일관성 측면에서 분명한 이점을 제공하지만, 초기에는 '느린 빌드 속도'와 '비효율적인 종속성 관리'라는 고질적인 문제점을 안고 있었습니다.

하지만 이제는 다릅니다. TurboRepo (빌드 시스템)와 PNPM (패키지 매니저)이라는 혁신적인 툴링(Tooling)조합이 모노레포의 단점을 완벽하게 해소하며, 개발자 경험을 극대화하는 새로운 표준을 제시하고 있습니다.

이 글에서는 이 두 가지 핵심 도구가 어떻게 모노레포의 성능을 획기적으로 개선하고, 실무에서 어떻게 적용할 수 있는지 구체적인 가이드를 제공합니다.

---

TurboRepo 고성능 빌드 시스템 ✨

TurboRepo는 Vercel에서 개발한 고성능 빌드 시스템으로, 모노레포 환경에서 발생하는 가장 큰 문제인 느린 빌드 시간을 해결하기 위해 설계되었습니다. 그 핵심은 두 가지 강력한 기능에 있습니다.

 🧠 증분 빌드와 캐싱의 마법

기존 CI/CD 파이프라인의 문제는 작은 코드 수정에도 모든 프로젝트를 처음부터 다시 빌드하는 비효율성이었습니다. TurboRepo는 이를 캐싱(Caching) 기술로 해결합니다.

1. 빌드 결과 캐싱: TurboRepo는 이전에 실행했던 빌드/테스트/린트 등의 작업 결과를 해시(Hash) 기반으로 저장합니다.
2. 변경된 부분만 실행: 다음 실행 시, 프로젝트의 코드나 종속성 파일에 변경 사항이 없는 경우 (즉, 해시가 동일한 경우), 작업을 건너뛰고 캐시된 결과물을 즉시 재사용합니다.

이 증분 빌드 (Incremental Builds) 덕분에, 개발자는 로컬에서든 CI 환경에서든 변경된 프로젝트에만 집중하여 작업을 처리할 수 있으며, 전체 빌드 시간이 획기적으로 단축됩니다.

🌐 원격 캐싱으로 팀 전체의 속도 향상

TurboRepo의 진정한 힘은 원격 캐싱 (Remote Caching)에서 나옵니다.

• 캐시 공유: 클라우드 저장소(Vercel Artifacts, AWS S3 등)에 캐시된 빌드 결과물을 업로드하고 다운로드할 수 있습니다.
• 협업 효율 증대: A 개발자가 특정 브랜치에서 빌드한 결과를 B 개발자가 다운로드하여 바로 사용할 수 있습니다. 이는 CI 환경에서도 마찬가지입니다. 신규 팀원이 프로젝트를 클론하거나, 새로운 CI 잡이 실행될 때 불필요한 재빌드를 최소화하여 팀 전체의 온보딩 및 파이프라인 속도를 동시에 끌어올립니다.

간결한 설정: turbo.json

TurboRepo의 설정은 매우 간단하고 직관적입니다. 루트 디렉토리의 turbo.json 파일 하나로 모든 [Workspace] 프로젝트의 실행 방식을 정의할 수 있습니다.

// turbo.json
{
  "$schema": "https://turbo.build/schema.json",
  "pipeline": {
    "build": {
      "dependsOn": ["^build"], // 상위 종속 패키지부터 빌드
      "outputs": [".next/**", "dist/**"] // 캐싱할 빌드 결과물 지정
    },
    "test": {
      "dependsOn": ["build"],
      "cache": true
    },
    // ...
  }
}

---

PNPM: 종속성 관리의 혁신과 디스크 공간 절약 ✅

모노레포의 효율적인 관리를 위해서는 고성능 빌드 시스템만큼이나 효율적인 패키지 매니저가 필수적입니다. PNPM (Performant NPM)은 Node.js 생태계에서 [종속성 관리]의 패러다임을 바꾼 혁신적인 도구입니다.

하드 링크와 심볼릭 링크의 원리

기존 NPM이나 Yarn Classic은 모노레포의 각 프로젝트마다 node_modules를 설치하여 패키지 중복 설치와 디스크 용량 낭비 문제를 야기했습니다. PNPM은 이를 다음과 같은 방식으로 해결합니다.

1. 콘텐츠 주소 지정 가능 저장소: PNPM은 설치된 패키지를 시스템의 전역 저장소에 단 한 번만 물리적으로 저장합니다 (하드 링크).
2. 심볼릭 링크 연결: 각 프로젝트의 node_modules 폴더에는 실제 물리적 파일 대신, 전역 저장소에 있는 원본 패키지를 가리키는 심볼릭 링크 (Symlink)만 생성됩니다.

이 방식은 수십 개의 프로젝트가 수백 MB에 달하는 패키지들을 단 하나의 물리적 복사본만 공유하게 만듭니다. 결과적으로 설치 속도가 매우 빨라지고, 디스크 공간을 획기적으로 절약하여 개발 환경을 쾌적하게 유지합니다.

2.2. PNPM Workspace를 통한 [코드 공유]

PNPM은 [Workspace] 기능을 통해 모노레포 내부의 라이브러리를 매우 쉽게 관리하고 공유할 수 있게 합니다.

1. pnpm-workspace.yaml: 루트 폴더에서 모든 앱과 라이브러리 폴더를 정의하여 PNPM이 이를 하나의 [Workspace]로 인식하게 합니다.

   # pnpm-workspace.yaml
   packages:
     - 'apps/*'       # 모든 애플리케이션 정의
     - 'libs/*'       # 모든 내부 라이브러리 정의
   

2. 로컬 패키지 참조: 앱 프로젝트의 package.json에서 내부 라이브러리(예: @my-org/ui)를 workspace:* 버전으로 정의하면, PNPM이 이를 로컬의 심볼릭 링크로 연결하여 즉시 개발에 사용할 수 있게 합니다.

이는 라이브러리 수정 시 별도의 배포 과정 없이, 앱에서 수정 사항을 즉시 반영하고 테스트할 수 있어 코드 공유의 편리성과 효율성을 극대화합니다.

---

TurboRepo + PNPM 시너지: 모노레포의 완성 🛠️

TurboRepo와 PNPM의 조합은 단순한 합이 아닌, 서로의 약점을 보완하며 모노레포 아키텍처를 완성하는 강력한 시너지를 만듭니다.

툴	역할	모노레포 개선 효과
PNPM	효율적인 패키지 설치 및 종속성 관리	빠른 설치 속도, 디스크 공간 절약
TurboRepo	고성능 빌드 시스템 및 캐싱	획기적인 빌드/테스트 시간 단축

이 조합을 통해 얻는 실질적인 이점은 다음과 같습니다.

1. 개발 환경 설정의 간소화: PNPM이 모든 종속성을 통합 관리하며 깔끔한 node_modules 구조를 제공합니다.
2. 신속한 피드백 루프: 로컬 환경에서 TurboRepo 캐시를 통해 수정된 부분에 대한 빌드/테스트만 빠르게 실행하여 개발 효율을 높입니다.
3. 효율적인 CI/CD 파이프라인: CI/CD에서 캐시를 재사용하고 병렬 처리를 통해, 복잡한 대규모 프로젝트의 빌드 시간을 몇 분 단위로 단축시킬 수 있습니다.

---

두 툴의 결합은 모노레포의 근본적인 문제점을 해결하고, 코드의 일관성, 재사용성, 그리고 궁극적인 개발 속도를 모두 만족시키는 이상적인 아키텍처입니다.

여러분의 팀은 이 두 툴 중 어떤 것을 먼저 도입해 보셨나요? PNPM의 설치 속도와 TurboRepo의 캐싱 기능 중, 실무에서 가장 큰 효용을 느꼈던 부분은 무엇이었는지 댓글로 경험을 공유해 주세요!