Skip to content

Установщики

Подробная информация о том, как работают установщики и как создать собственный пользовательский установщик/распространения для размещённых установок.

Текущие установщики

По состоянию на Volta 0.7.0 все официальные установщики работают одинаково:

  1. Распаковывают двоичные файлы Volta
  2. Вызывают volta setup с использованием распакованного двоичного файла volta (для получения дополнительной информации см. volta setup)

Установщик Windows

Установщик Windows распаковывает все двоичные файлы в Program Files\Volta и добавляет эту папку в системную переменную окружения Path. Он также создаёт прокладки в этой директории для следующих инструментов:

  • node
  • npm
  • npx
  • yarn

Установщик Unix

Установщик Unix распаковывает все двоичные файлы в ~/.volta/bin, поэтому они устанавливаются только для конкретного пользователя.

Пропуск настройки Volta

Если вы хотите запустить установщик, но не хотите, чтобы volta setup изменил ваши файлы конфигурации скриптов, вы можете передать опцию --skip-setup установщику:

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

WARNING

В настоящее время мы не поддерживаем пропуск volta setup в Windows.

Github CI

Для удобства мы предоставляем пользовательский Github action, который автоматически загрузит Volta, кэширует его и загрузит инструменты закреплённых версий из package.json вашего проекта.

Установка старых версий

Скрипт установщика по умолчанию, предоставляемый get.volta.sh, поддерживает установку только Volta 1.1.0 и выше. Если вы хотите установить более старую версию, вы можете установить её в Unix, используя следующий скрипт, заменив 1.0.8 на версию, которую вы хотите установить:

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

Для Windows вы можете загрузить и установить файл установщика .msi для конкретной версии.

WARNING

Volta не поддерживает понижение версии, поэтому для понижения версии вам нужно полностью удалить Volta, а затем установить более низкую версию.

Пользовательские установщики

Чтобы создать пользовательский установщик/метод распространения, есть два обязательных шага и один необязательный:

Распространение двоичных файлов

Сами двоичные файлы должны быть доставлены на целевую машину. volta.manifest в файлах релиза перечислит необходимые двоичные файлы. По состоянию на Volta 0.7.0 необходимые файлы:

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

Все эти двоичные файлы должны быть распространены в одной директории, и эта директория должна быть в PATH, чтобы вызовы команды volta работали.

Директория прокладок

Директория прокладок Volta также должна быть добавлена в PATH, чтобы прокладки также работали как ожидается. Директория прокладок находится в $VOLTA_HOME/bin (%VOLTA_HOME%\bin в Windows), где VOLTA_HOME по умолчанию:

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

Обновления PATH могут управляться вручную, если это необходимо, или можно вызвать volta setup (как это делают официальные установщики, как описано выше).

Пользовательская основная директория Volta (необязательно)

Если вы хотите использовать другую директорию для данных Volta, отличную от стандартного VOLTA_HOME, перечисленного в предыдущем разделе, вам нужно установить переменную окружения VOLTA_HOME в эту директорию. Если эта переменная установлена, volta setup будет по-прежнему работать правильно для пользовательской директории данных.