지원 정책

패키지 관리자

핵심 turbo 기능은 JavaScript 생태계의 패키지 관리자와 해당 Workspace 및 lockfile 형식 구현에 의존합니다.

패키지 관리자지원 여부
pnpm 8+
npm 8+
yarn 1+예 (Yarn Plug'n'Play 포함)
bun 1.2+Beta

패키지 관리자는 자체 릴리스 일정, 버그 및 기능을 가지고 있습니다. 새로운 주요 버전을 따라가려고 노력하지만 즉시 지원을 릴리스하지 못할 가능성이 높습니다.

플랫폼

turbo는 일반적으로 Debian 기반 Linux 배포판, macOS 및 Windows에서 x86_64 및 ARM 64 아키텍처 모두에서 지원됩니다. 구체적으로, npm을 통해 다음 바이너리를 빌드하고 제공합니다:

  • turbo-darwin-64 (Intel 칩을 사용하는 macOS)
  • turbo-darwin-arm64 (Apple Silicon을 사용하는 macOS)
  • turbo-linux-64
  • turbo-linux-arm64
  • turbo-windows-64*
  • turbo-windows-arm64*

*: Windows C Runtime Libraries 필요

Node.js

핵심 turbo 기능은 시스템의 활성 Node.js 버전에 의존하지 않지만, create-turbo, turbo-ignoreeslint-config-turbo와 같은 Turborepo 생태계의 일부 패키지는 의존합니다. 이러한 기능의 경우 Node.js의 Active 및 Maintenance LTS 버전을 지원할 예정입니다.

Turborepo의 예제도 이러한 Node.js 버전에서 작동할 것으로 예상됩니다.

버전 관리

Git으로 버전 관리되는 리포지토리와 버전 관리가 전혀 없는 리포지토리를 지원합니다. 다른 버전 관리 시스템은 무시됩니다.

파일 해싱에 Git을 사용하므로 git이 없는 리포지토리는 다르게 수행되고 동작할 수 있습니다.

LTS 정책

Turborepo의 주요 버전은 다음 주요 버전의 릴리스 날짜로부터 2년 동안 지원됩니다.

이전 버전의 중요한 보안 수정에 필요한 변경 사항은 백포트됩니다. 이러한 상황은 드물며 중대한 변경 사항이더라도 semver-minor 릴리스로 제공됩니다.

가능한 한 최신 버전의 Turborepo를 사용하실 것을 강력히 권장합니다.

주요 버전릴리스 날짜지원 종료 날짜
2.x2024년 6월 4일
1.x2021년 12월 9일2026년 6월 4일

릴리스 단계

Turborepo의 안정 빌드는 시맨틱 버저닝(semver)을 따르며 릴리스되기 전에 철저하게 테스트됩니다.

Turborepo는 또한 개발의 초기 단계에서 릴리스될 수 있는 특정 API를 제공합니다. 이는 얼리 어답터가 귀중한 피드백을 제공하고 핵심 팀이 안정적인 릴리스 전에 API에 대한 확신을 얻을 수 있도록 하기 위한 것입니다. 사전 안정 버전으로 제공되는 API는 가능한 한 문서와 turbo 자체에서 그렇게 표시됩니다.

모든 API가 모든 단계에서 릴리스되는 것은 아닙니다. 기능의 복잡성, 가능한 사용 사례 및 API의 초기 사용자로부터의 피드백과 같은 요소를 고려하여 기능에 대한 확신을 바탕으로 API의 단계를 결정하기 위해 최선의 판단을 사용합니다.

Turborepo 핵심 팀은 기능을 조기에 사용하는 모든 사용자에게 감사드리며 제공해주시는 모든 피드백에 대해 감사를 표합니다.

Stable

API가 안정성에 도달하면 프로덕션에서 사용할 준비가 된 것으로 간주됩니다. 안정 버전으로 표시된 API는 주요 릴리스에서만 하위 호환되는 방식으로 변경됩니다.

  • 안정적인 API가 향후 주요 릴리스에서 중대한 변경 사항을 가질 예정인 경우, 마이그레이션 및 다음 단계를 돕기 위한 경고 및 문서가 제공됩니다.
  • 안정적인 API가 향후 주요 릴리스에서 제거될 예정인 경우, 향후 제거에 대한 조기 통지를 제공하기 위해 Deprecated로 표시됩니다.

Beta

Beta API는 안정적인 릴리스 전에 신뢰성에 대한 더 많은 확신이 필요합니다. Beta 단계에서는 기능의 전체 디자인에 대해 확신하고 있으며 상대적으로 적은 변경으로 기능을 안정 버전으로 승격할 수 있을 것으로 예상합니다. 드문 경우지만 API가 중대한 변경을 필요로 할 수 있으며 semver의 적용을 받지 않습니다.

얼리 어답터가 Beta API를 사용하여 기능의 디자인과 안정성에 대한 확신을 얻도록 권장합니다. 위험 허용 범위에 따라 적절하게 프로덕션에서 기능을 사용할 수 있습니다.

현재 Beta 단계에 있는 API:

  • 없음

Experimental

Experimental API는 안정성을 위해 필요한 필수 기능이 부족합니다. 기능의 디자인은 활발하게 개발 중인 것으로 간주되며 언제든지 변경될 수 있습니다.

안정성이 필수적이지 않은 사이드 프로젝트, 개념 증명 및 기타 환경에서 Experimental API를 테스트하는 데 도움을 주시길 권장합니다. 이를 통해 기능이 개발되는 동안 핵심 팀에 조기 피드백을 제공함으로써 API 개발을 지원할 수 있는 기회를 얻을 수 있습니다. 신뢰성이 필수적인 곳에서는 Experimental API를 사용하지 않는 것이 좋습니다.

현재 Experimental 단계에 있는 API:

Deprecated

Deprecated API는 제거 중입니다. 제거할 예정인 모든 기능에는 다음 단계와 기능이 제거될 것으로 예상되는 시기에 대한 정보가 포함된 기존 사용자를 위한 문서가 포함됩니다.

현재 deprecated된 API: