Turborepo turbo.json build outputs 빌드결과물 경로

turbo.json

터보레포로 구축한 프로젝트의 루트 디렉토리의 turbo.json 파일은 위와 같다.

착각했던 것

turbo.json 

{ 
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"]
    },
    ...
 }

이걸 보고 빌드 결과물의 outputs이 루트 디렉토리의 dist에도 저장되겠구나 생각했다.
근데 turbo run build를 하고 아무리 찾아봐도 루트 디렉토리에 dist 폴더가 보이지않았다;;
루트에서 빌드를 하고나면, 워크스페이스 작업물인 패키지, 하위 프로젝트들의 빌드 결과물이 루트에도 묶여서 dist 폴더에 저장이 된다고 착각했던 것이다.

빌드 Outputs 경로

빌드 결과물은 각 워크스페이스의 dist 디렉토리에 각자 저장되는 것이다.
모노레포의 루트 디렉토리는 개별 워크스페이스들에서 산출된 빌드 결과물을 포함하고 있지는 않다. 루트디렉토리는 전반적인 설정을 위한 디렉토리이고, package.json을 통해 전체 모노레포의 의존성을 관리한다.

Build Outputs Location

/my-monorepo
  /apps
    /app1
      /dist       <-- Build outputs for app1
      package.json
      vite.config.js
    /app2
      /dist       <-- Build outputs for app2
      package.json
      vite.config.js
  /packages
    /shared
      package.json
  turbo.json
  package.json

 

터보레포 Configuration

그럼 위의 `turbo.json` 파일에서 build 에 `outputs` 을 설정해준 코드가 하는 역할은 무엇일까?
build 실행시 전체 모노레포에서 해당 dist 파일을 찾아 Turborepo에게 관련 디렉토리에 있는 파일은 모두 캐싱처리하고, 최적화하라고 명령하는 것이다.
즉, 빌드시 워크스페이스(패키지, apps1, apps2…)의 dist 파일들을 캐싱해서 바뀐게 있으면 .cache>turbo에  새로 저장하고, 바뀐게 없으면 그대로두어서 터보레포 내부적으로 성능을 최적화시킨다.

참고

https://turbo.build/repo/docs/reference/configuration#pipeline

Configuration – Turborepo

https://turbo.build/repo/docs/reference/configuration#outputs

Configuration – Turborepo

https://turbo.build/repo/docs/core-concepts/caching/what-to-cache

What to Cache? – Turborepo