Instaladores

Detalhes sobre como os instaladores funcionam e como criar seus próprios instaladores personalizados/distribuições para instalação hospedada.

Instaladores Atuais

A partir do Volta 0.7.0, todos os instaladores oficiais funcionam da mesma forma:

1. Extrair os binários do Volta
2. Usar o binário volta extraído para chamar volta setup (veja volta setup para mais informações)

Instalador Windows

O instalador Windows extrai todos os binários para Program Files\Volta e adiciona essa pasta à variável de ambiente Path do sistema. Ele também criará shims nesse diretório para as seguintes ferramentas:

• node
• npm
• npx
• yarn

Instalador Unix

O instalador Unix extrai todos os binários para ~/.volta/bin, então eles são instalados apenas para o usuário específico.

Pular Configuração do Volta

Se você quiser executar o instalador mas não quiser que volta setup modifique seus scripts de configuração, você pode passar a opção --skip-setup para o instalador:

curl https://get.volta.sh | bash -s -- --skip-setup

WARNING

Atualmente não suportamos pular volta setup no Windows.

Github CI

Para conveniência, fornecemos uma action personalizada do Github que automaticamente baixará o Volta, o armazenará em cache e baixará as ferramentas com versões fixas no package.json do projeto.

Instalar Versões Antigas

O script de instalador padrão fornecido por get.volta.sh suporta apenas a instalação do Volta 1.1.0 e superior. Se você quiser instalar uma versão mais antiga, pode usar o seguinte script no Unix, substituindo 1.0.8 pela versão que deseja instalar:

curl https://raw.githubusercontent.com/volta-cli/volta/8f2074f423c65405dfba9858d9bcf393c38ffb45/dev/unix/volta-install.sh | bash -s -- --version 1.0.8

Para Windows, você pode baixar e instalar o arquivo .msi do instalador de uma versão específica.

WARNING

O Volta não suporta downgrade, então para fazer downgrade, você precisa desinstalar completamente o Volta e então instalar a versão inferior.

Instaladores Personalizados

Para criar instaladores personalizados/métodos de distribuição, há duas etapas obrigatórias e uma opcional:

Distribuir Binários

Os binários em si precisam ser transferidos para a máquina de destino. O arquivo volta.manifest na distribuição listará a lista de binários necessários. A partir do Volta 0.7.0, os arquivos necessários são:

• volta[.exe]
• volta-shim[.exe]
• volta-migrate[.exe]

Todos esses binários precisam ser distribuídos no mesmo diretório, e esse diretório deve estar no PATH para que as chamadas para o comando volta funcionem corretamente.

Diretório de Shims

O diretório de shims do Volta também precisa ser adicionado ao PATH para que os shims funcionem conforme esperado. O diretório de shims está localizado em $VOLTA_HOME/bin (Windows: %VOLTA_HOME%\bin), onde VOLTA_HOME é por padrão:

• Unix: ~/.volta
• Windows: %LOCALAPPDATA%\Volta

Se necessário, as atualizações do PATH podem ser gerenciadas manualmente, ou volta setup pode ser chamado (como os instaladores oficiais fazem, conforme descrito acima).

Diretório Principal Personalizado do Volta (Opcional)

Se você quiser usar um diretório diferente do VOLTA_HOME padrão listado na seção anterior para os dados do Volta, você precisa definir a variável de ambiente VOLTA_HOME para esse diretório. Se essa variável estiver definida, então volta setup ainda funcionará corretamente para o diretório de dados personalizado.