설치

다음을 사용하여 Turborepo를 몇 분 안에 시작하세요:

Terminal

pnpm dlx create-turbo@latest

스타터 리포지토리에는 다음이 포함됩니다:

스타터에 대한 자세한 내용은 GitHub의 기본 스타터용 README를 참조하세요. 도구 관심사에 더 잘 맞는 예제를 사용할 수도 있습니다.

`turbo` 설치

turbo는 전역 및 리포지토리에 모두 설치할 수 있습니다. 빠르고 편리한 워크플로우 및 리포지토리에서 작업하는 모든 개발자를 위한 안정적인 turbo 버전을 활용할 수 있도록 두 가지 방법 모두 설치하는 것을 강력히 권장합니다.

turbo의 전역 설치는 로컬 워크플로우에 유연성과 속도를 제공합니다.

Terminal

pnpm add turbo --global

전역으로 설치하면 터미널에서 turbo를 통해 스크립트를 실행하여 리포지토리 내에서 사용할 일회성 명령을 빠르게 실행할 수 있습니다. 예를 들어:

turbo build: 리포지토리의 의존성 그래프를 따라 build 스크립트 실행
turbo build --filter=docs --dry: docs 패키지의 build 태스크 개요를 빠르게 출력(실행하지 않고)
turbo generate: Generator를 실행하여 리포지토리에 새 코드 추가
cd apps/docs && turbo build: docs 패키지와 그 의존성에서 build 스크립트 실행. 자세한 내용은 자동 패키지 범위 지정 섹션을 참조하세요.

Good to know:

turbo는 turbo run의 별칭입니다. 예를 들어, turbo build와 turbo run build는 모두 build 태스크를 실행합니다.

여러 전역 설치 방지

이전에 전역 turbo를 설치한 경우 예기치 않은 동작을 피하기 위해 기존 설치와 동일한 패키지 매니저를 사용해야 합니다. turbo bin을 사용하여 이전에 사용한 패키지 매니저를 빠르게 확인할 수 있습니다.

CI 파이프라인을 생성할 때 전역 turbo를 활용할 수도 있습니다. 자세한 내용은 CI 구성 가이드를 참조하세요.

리포지토리에서 다른 개발자와 협업할 때 의존성 버전을 고정하는 것이 좋습니다. 리포지토리의 루트에 devDependency로 추가하여 turbo로 이를 수행할 수 있습니다:

Terminal

pnpm add turbo --save-dev --ignore-workspace-root-check

전역 설치된 turbo를 계속 사용하여 명령을 실행할 수 있습니다. 전역 turbo는 리포지토리의 로컬 버전이 있는 경우 해당 버전으로 위임됩니다.

이를 통해 두 설치의 장점을 모두 얻을 수 있습니다: 터미널에서 명령을 쉽게 실행하면서 리포지토리의 모든 개발자가 일관되게 사용할 수 있도록 고정된 버전을 유지할 수 있습니다.