시스템 환경 변수

특정 환경 변수를 설정하여 Turborepo의 동작을 변경할 수 있습니다. 이는 다양한 환경과 머신에 대한 특정 구성을 만드는 데 유용할 수 있습니다.

시스템 환경 변수는 turbo 명령에 직접 제공된 플래그 값에 의해 항상 재정의됩니다.

변수설명
FORCE_COLOR터미널 로그에 색상을 강제로 표시합니다
TURBO_API

Remote Cache의 기본 URL을 설정합니다.

TURBO_BINARY_PATH

turbo 바이너리의 경로를 수동으로 설정합니다. 기본적으로 turbo는 바이너리를 자동으로 검색하므로 드문 경우에만 사용해야 합니다.

TURBO_CACHE

캐시 소스의 읽기 및 쓰기를 제어합니다.

--cache

와 동일한 구문을 사용합니다.

TURBO_CACHE_DIR--cache-dir

플래그를 사용하는 것과 유사하게 캐시 디렉토리를 설정합니다.

TURBO_CI_VENDOR_ENV_KEY

프레임워크 추론

에서 제외하려는 환경 변수의 접두사를 설정합니다. 참고: 이것은 사용자가 설정할 필요가 없으며 지원되는 플랫폼에서 자동으로 구성되어야 합니다.

TURBO_DANGEROUSLY_DISABLE_PACKAGE_MANAGER_CHECK

package.jsonpackageManager 필드 검사를 비활성화합니다. 이 검사를 비활성화하면

오류 및 예상치 못한 캐싱 동작

이 발생할 수 있습니다. 비활성화하려면 true 또는 1을 사용합니다.

TURBO_DOWNLOAD_LOCAL_ENABLED

로컬 버전이 없는 경우 전역 turbo가 올바른 로컬 버전을 설치하도록 활성화합니다.

TURBO_FORCE

true로 설정하면 모든 캐싱을 선택 해제하고 모든 작업을 전체적으로 실행하도록 강제합니다.

TURBO_GLOBAL_WARNING_DISABLED

전역 turbo가 사용할 로컬 버전을 찾을 수 없을 때 경고를 비활성화합니다.

TURBO_PRINT_VERSION_DISABLED

실행 중인 turbo 버전의 출력을 비활성화합니다.

TURBO_LOG_ORDER

로그 순서를 설정합니다. 허용되는 값은 groupeddefault 입니다.

TURBO_LOGIN

Remote Cache에 로그인하는 데 사용되는 URL을 설정합니다. 토큰을 동적으로 생성하는 엔드포인트를 구현하는 자체 호스팅 Remote Cache에만 필요합니다.

TURBO_NO_UPDATE_NOTIFIER

새 버전의 turbo를 사용할 수 있을 때 나타나는 업데이트 알림을 제거합니다. 에코시스템 규칙에 따라 NO_UPDATE_NOTIFIER도 사용할 수 있습니다.

TURBO_PLATFORM_ENV

지원되는 CI 환경(Vercel)에서 구성된 환경 변수 키의 CSV입니다. 참고: 이 변수는 제로 구성 환경 변수를 구현하려는 플랫폼을 위한 것입니다. 최종 사용자로서 이 변수를 사용하도록 의도되지 않았습니다.

TURBO_PLATFORM_ENV_DISABLED

turbo.json에 구성된 환경 변수를 지원되는 플랫폼에 설정된 환경 변수와 비교하는 검사를 비활성화합니다

TURBO_PREFLIGHT

모든 캐시 아티팩트 및 분석 요청 전에 preflight 요청 전송을 활성화합니다. 후속 업로드 및 다운로드는 리디렉션을 따릅니다. Remote Caching이 구성된 경우에만 적용됩니다.

TURBO_REMOTE_CACHE_READ_ONLY

Remote Cache에 쓰기를 방지하지만 읽기는 허용합니다.

TURBO_REMOTE_CACHE_SIGNATURE_KEY

비밀 키로 아티팩트에 서명합니다. 자세한 내용은

아티팩트 무결성 섹션

을 참조하세요.

TURBO_REMOTE_CACHE_TIMEOUT

turbo Remote Cache에서 아티팩트를 가져오는 시간 초과를 초 단위로 설정합니다.

TURBO_REMOTE_CACHE_UPLOAD_TIMEOUT

turbo Remote Cache에 아티팩트를 업로드하는 시간 초과를 초 단위로 설정합니다.

TURBO_REMOTE_ONLY모든 작업에 대해 로컬 파일 시스템 캐시를 항상 무시합니다.
TURBO_RUN_SUMMARY

작업을 실행할 때 실행 요약 을 생성합니다.

TURBO_SCM_BASE

base...head에서 변경된 내용을 계산할 때 --affected에서 사용하는 base

TURBO_SCM_HEAD

base...head에서 변경된 내용을 계산할 때 --affected에서 사용하는 head

TURBO_TEAM

저장소와 연결된 계정 이름입니다.

Vercel Remote Cache

를 사용하는 경우 이것은 팀의 슬러그입니다.

TURBO_TEAMID

저장소와 연결된 계정 식별자입니다.

Vercel Remote Cache

를 사용하는 경우 이것은 팀의 ID입니다.

TURBO_TELEMETRY_MESSAGE_DISABLED

원격 측정이 활성화되어 있음을 알려주는 메시지를 비활성화합니다.

TURBO_TOKEN

Remote Cache에 액세스하기 위한 인증용 Bearer 토큰입니다.

TURBO_UI

true 또는 1이 전달되면 TUI를 활성화하고, false 또는 0이 전달되면 비활성화합니다.

TURBO_CONCURRENCY

실행 또는 감시 모드에서

동시성

설정을 제어합니다.

TURBO_SSO_LOGIN_CALLBACK_PORT

인증 중 SSO 로그인 콜백 서버에 사용되는 기본 포트(9789)를 재정의합니다.

작업의 환경 변수

Turborepo는 작업이 실행되는 동안 다음 환경 변수를 작업 내에서 사용할 수 있도록 합니다:

변수설명
TURBO_HASH현재 실행 중인 작업의 해시입니다.
TURBO_IS_TUITUI를 사용할 때 이 변수는 true로 설정됩니다.
TURBO_IS_MFE마이크로프론트엔드를 사용할 때 이 변수는 애플리케이션의 microfrontends.json에 정의된 포트로 설정됩니다.