volta pin

O comando volta pin irá atualizar o arquivo package.json do projeto para usar a versão selecionada da ferramenta. Ele tem a seguinte sintaxe:

Fixar runtime ou gerenciador de pacotes do seu projeto

Uso:
    volta pin [FLAGS] <tool[@version]>...

Flags:
        --verbose    Habilitar diagnósticos detalhados
        --quiet      Prevenir saída desnecessária
    -h, --help       Imprimir informações de ajuda

Argumentos:
    <tool[@version]>...    Ferramenta a ser fixada, como `node@lts` ou `yarn@^1.14`.

Notavolta pin só se aplica ao Node e gerenciadores de pacotes (por exemplo, npm ou Yarn). Para dependências, você deve usar npm install ou yarn add para atualizar versões selecionadas.

Exemplos

Fixando Node.js

# Fixar a versão LTS mais recente do Node
volta pin node

# Fixar uma versão específica do Node
volta pin node@16.14.2

# Fixar intervalo de versão do Node
volta pin node@16

Quando você fixa uma versão do Node.js, o Volta adiciona uma seção volta no arquivo package.json do projeto:

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

Fixando Gerenciadores de Pacotes

# Fixar a versão mais recente do npm
volta pin npm

# Fixar uma versão específica do Yarn
volta pin yarn@1.22.19

# Fixar pnpm (se flag de funcionalidade habilitada)
VOLTA_FEATURE_PNPM=1 volta pin pnpm@7.0.0

Fixar gerenciadores de pacotes os adiciona à seção volta no package.json:

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

Casos de Uso

O comando volta pin é crucial para:

• Criar ambiente de desenvolvimento consistente em sua equipe
• Garantir que todos que trabalham no projeto usem a mesma versão do Node.js e gerenciador de pacotes
• Prevenir problemas de "funciona na minha máquina"
• Documentar com qual versão do Node.js seu projeto é compatível

Efeitos da Fixação

Quando você fixa uma ferramenta:

1. Se você ainda não tem a ferramenta, ela é automaticamente instalada
2. A versão é escrita na seção volta do package.json
3. Qualquer pessoa que trabalhe no projeto usando Volta automaticamente usará a versão especificada
4. Sistemas CI/CD que usam Volta usarão a versão correta

Ferramentas fixadas têm prioridade sobre versões padrão de ferramentas definidas com volta install.

Detalhes do package.json

A seção volta no package.json pode incluir:

{
  "volta": {
    "node": "16.14.2",    // versão exata
    "npm": "^8.5.0",      // intervalo semver
    "yarn": "1.22.19",    // versão exata
    "pnpm": "7.0.0"       // se suporte ao pnpm estiver habilitado
  }
}

Especificadores de versão podem ser:

• Versão exata: 16.14.2
• Versão principal: 16
• Versão principal.secundária: 16.14
• Intervalo semver: ^16.14.0
• Tags: lts, latest