Skip to content

volta pin

volta pin 명령은 선택한 도구 버전을 사용하도록 프로젝트의 package.json 파일을 업데이트합니다. 구문은 다음과 같습니다:

bash
프로젝트의 런타임 또는 패키지 매니저 고정

사용법:
    volta pin [FLAGS] <tool[@version]>...

플래그:
        --verbose    자세한 진단 활성화
        --quiet      불필요한 출력 방지
    -h, --help       도움말 정보 출력

인수:
    <tool[@version]>...    고정할 도구, 예: `node@lts` 또는 `yarn@^1.14`.

참고volta pin은 Node와 패키지 매니저(예: npm 또는 Yarn)에만 작동합니다. 의존성의 경우 선택한 버전을 업데이트하려면 npm install 또는 yarn add를 사용해야 합니다.

예제

Node.js 고정

bash
# 최신 LTS 버전 Node 고정
volta pin node

# 특정 버전의 Node 고정
volta pin node@16.14.2

# Node 버전 범위 고정
volta pin node@16

Node.js 버전을 고정하면 Volta가 프로젝트의 package.json 파일에 volta 섹션을 추가합니다:

json
{
  "volta": {
    "node": "16.14.2"
  }
}

패키지 매니저 고정

bash
# 최신 npm 버전 고정
volta pin npm

# 특정 버전의 Yarn 고정
volta pin yarn@1.22.19

# pnpm 고정 (기능 플래그가 활성화된 경우)
VOLTA_FEATURE_PNPM=1 volta pin pnpm@7.0.0

패키지 매니저를 고정하면 package.jsonvolta 섹션에 추가됩니다:

json
{
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0"
  }
}

사용 시나리오

volta pin 명령은 다음에 중요합니다:

  • 팀 내에서 일관된 개발 환경 만들기
  • 프로젝트에서 작업하는 모든 사람이 동일한 Node.js 버전과 패키지 매니저를 사용하도록 보장
  • "내 컴퓨터에서는 작동"하는 문제 방지
  • 프로젝트가 어떤 Node.js 버전과 호환되는지 문서화

고정의 효과

도구를 고정하면:

  1. 해당 도구가 없는 경우 자동으로 설치됩니다
  2. 버전이 package.jsonvolta 섹션에 기록됩니다
  3. Volta를 사용하여 프로젝트에서 작업하는 모든 사람이 자동으로 지정된 버전을 사용합니다
  4. Volta를 사용하는 CI/CD 시스템이 올바른 버전을 사용합니다

고정된 도구는 volta install로 설정된 기본 도구 버전보다 우선합니다.

package.json 세부사항

package.jsonvolta 섹션에는 다음이 포함될 수 있습니다:

json
{
  "volta": {
    "node": "16.14.2",    // 정확한 버전
    "npm": "^8.5.0",      // Semver 범위
    "yarn": "1.22.19",    // 정확한 버전
    "pnpm": "7.0.0"       // pnpm 지원이 활성화된 경우
  }
}

버전 지정자는 다음이 될 수 있습니다:

  • 정확한 버전: 16.14.2
  • 주 버전: 16
  • 주.부 버전: 16.14
  • Semver 범위: ^16.14.0
  • 태그: lts, latest