작업 실행

Turborepo는 자동으로 작업을 병렬화하고 캐시하여 저장소의 개발자 워크플로를 최적화합니다. 작업이 turbo.json에 등록되면 저장소에서 스크립트를 실행하기 위한 강력한 새 도구 세트를 사용할 수 있습니다:

turbo를 통해 작업을 실행하는 것은 개발 및 CI 파이프라인에서 저장소 전체에 걸쳐 워크플로를 실행하기 위한 하나의 모델을 얻기 때문에 강력합니다.

package.json에서 scripts 사용

자주 실행하는 작업의 경우 루트 package.json에 turbo 명령을 직접 작성할 수 있습니다.

./package.json
{
  "scripts": {
    "dev": "turbo run dev",
    "build": "turbo run build",
    "test": "turbo run test",
    "lint": "turbo run lint"
  }
}

Good to know: 

turbo는 turbo run의 별칭입니다. 하지만 향후 추가될 수 있는 turbo 하위 명령과의 충돌을 피하기 위해 package.json 및 CI 워크플로에서는 turbo run을 사용하는 것이 좋습니다.

그런 다음 패키지 관리자를 사용하여 이러한 스크립트를 실행할 수 있습니다.

Terminal
pnpm dev

루트 package.json에만 turbo 명령을 작성하세요. 패키지의 package.json에 turbo 명령을 작성하면 turbo를 재귀적으로 호출할 수 있습니다.

전역 turbo 사용

turbo를 전역으로 설치하면 터미널에서 직접 명령을 실행할 수 있습니다. 이는 필요한 것을 정확히 실행하기가 더 쉬워지므로 로컬 개발 경험을 향상시킵니다.

또한 전역 turbo는 CI 파이프라인에서 유용하며 파이프라인의 각 지점에서 실행할 작업을 최대한 제어할 수 있습니다.

Automatic Package Scoping

패키지의 디렉토리에 있을 때 turbo는 자동으로 해당 패키지의 Package Graph로 명령을 스코핑합니다. 즉, 패키지에 대한 필터를 작성하지 않고도 빠르게 명령을 작성할 수 있습니다.

Terminal
cd apps/docs
turbo build

위의 예에서 turbo build 명령은 turbo.json에 등록된 build 작업을 사용하여 docs 패키지에 대한 build 작업을 실행합니다.

Good to know: 

필터 사용은 Automatic Package Scoping을 재정의합니다.

동작 사용자 지정

run 하위 명령 문서에서 필요한 것에 맞게 turbo run의 동작을 조정하는 데 유용한 많은 플래그를 찾을 수 있습니다. 전역 turbo를 실행할 때 다음과 같은 워크플로를 사용하여 더 빠르게 진행할 수 있습니다:

  • 가장 일반적인 명령의 변형: package.json의 build 스크립트는 turbo build일 때 가장 유용하지만 현재 특정 패키지에만 관심이 있을 수 있습니다. turbo build --filter=@repo/ui를 사용하여 관심 있는 특정 패키지를 빠르게 필터링할 수 있습니다.
  • 일회성 명령: turbo build --dry와 같은 명령은 자주 필요하지 않으므로 package.json에 스크립트를 만들지 않을 것입니다. 대신 필요할 때마다 터미널에서 직접 실행할 수 있습니다.
  • turbo.json 구성 재정의: 일부 CLI 플래그에는 재정의할 수 있는 turbo.json의 동등한 플래그가 있습니다. 예를 들어 turbo.json에서 "outputLogs": "full"을 사용하도록 구성된 turbo build 명령이 있지만 현재 오류만 보고 싶을 수 있습니다. 전역 turbo를 사용하여 turbo lint --output-logs=errors-only를 사용하여 오류만 표시할 수 있습니다.

여러 작업 실행

turbo는 여러 작업을 실행할 수 있으며 가능한 한 병렬화합니다.

Terminal
turbo run build test lint check-types

이 명령은 모든 작업을 실행하며 작업 정의에 따라 스크립트를 가능한 한 빨리 실행할 수 있는 위치를 자동으로 감지합니다.

작업 순서

turbo test lint는 turbo lint test와 정확히 동일한 작업을 실행합니다.

한 작업이 다른 작업의 실행을 차단하도록 하려면 작업 구성에서 해당 관계를 표현하세요.

필터 사용

캐싱은 동일한 작업을 두 번 수행하지 않도록 하여 빠르게 유지하지만 the Task Graph의 하위 집합만 실행하도록 작업을 필터링할 수도 있습니다.

--filter API 참조에는 필터링에 대한 많은 고급 사용 사례가 있지만 가장 일반적인 사용 사례는 아래에서 설명합니다.

패키지별 필터링

패키지별 필터링은 현재 작업 중인 패키지에 대해서만 작업을 실행하는 간단한 방법입니다.

Terminal
turbo build --filter=@acme/web

--filter를 사용하지 않고도 CLI 명령에서 패키지에 대한 특정 작업으로 직접 필터링할 수도 있습니다:

Terminal
# `web` 패키지에 대한 `build` 작업 실행
turbo run web#build
 
# `web` 패키지에 대한 `build` 작업과 `docs` 패키지에 대한 `lint` 작업 실행
turbo run web#build docs#lint

디렉토리별 필터링

저장소에는 관련 패키지가 함께 그룹화된 디렉토리 구조가 있을 수 있습니다. 이 경우 해당 디렉토리에 대한 glob을 캡처하여 turbo를 해당 패키지에 집중할 수 있습니다.

Terminal
turbo lint --filter="./packages/utilities/*"

종속자를 포함하도록 필터링

특정 패키지에서 작업할 때 패키지와 해당 종속자에 대한 작업을 실행할 수 있습니다. ... 마이크로 구문은 패키지를 변경하고 해당 변경 사항이 종속자를 손상시키지 않도록 할 때 유용합니다.

Terminal
turbo build --filter=...ui

종속성을 포함하도록 필터링

범위를 패키지 및 해당 종속성으로 제한하려면 패키지 이름에 ...를 추가합니다. 이는 지정된 패키지와 해당 패키지가 의존하는 모든 패키지에 대해 작업을 실행합니다.

Terminal
turbo dev --filter=web...

소스 제어 변경 사항별 필터링

필터를 사용하여 소스 제어의 변경 사항을 기반으로 작업을 실행하는 것은 변경 사항의 영향을 받는 패키지에 대해서만 작업을 실행하는 좋은 방법입니다. 소스 제어 필터는 []로 래핑해야 합니다.

  • 이전 커밋과 비교: turbo build --filter=[HEAD^1]
  • 메인 브랜치와 비교: turbo build --filter=[main...my-feature]
  • SHA를 사용하여 특정 커밋 비교: turbo build --filter=[a1b2c3d...e4f5g6h]
  • 브랜치 이름을 사용하여 특정 커밋 비교: turbo build --filter=[your-feature...my-feature]

일반적으로 캐싱에 의존하여 저장소를 빠르게 유지할 수 있습니다. Remote Caching을 사용하는 경우 변경되지 않은 패키지에 대해 캐시를 히트할 수 있습니다.

필터 결합

더욱 구체적으로 하려면 필터를 결합하여 Task Graph의 진입점을 더욱 세분화할 수 있습니다.

Terminal
turbo build --filter=...ui --filter={./packages/*} --filter=[HEAD^1]

여러 필터는 합집합으로 결합됩니다. 즉, Task Graph에는 필터 중 하나와 일치하는 작업이 포함됩니다. 필터의 고급 사용에 대한 자세한 내용은 --filter API 참조를 참조하세요.

다음 단계

저장소에서 작업을 실행하기 시작하면 작업이 더 빠르게 실행되는 것을 알 수 있습니다. 다음으로 캐싱과 turbo가 동일한 작업을 두 번 수행하지 않도록 하는 방법을 탐색합니다.

Previous

Task 구성하기

Next

캐싱