Обновление с v1
Это руководство описывает переход с NVM for Windows v1 на v2. Установщик v2 переносит поддерживаемые установки v1 автоматически.
Поддерживаемые версии
Установщик v2 обновляет существующие установки v1.1.7 и новее. Он обнаруживает предыдущую установку, переносит настройки и объединяет версии Node.js в раскладку v2.
Удалите NVM for Windows версии старше 1.1.7 перед установкой v2. Такие версии не переносятся автоматически. Без резервной копии вы потеряете установки Node.js и настройки.
Встроенный updater v1 не устанавливает v2. Он применяет только минорные и patch-обновления в линейке v1.x.x. Для перехода на v2 используйте установщик v2 или winget.
Автоматическое обновление
- Скачайте community setup.exe или используйте winget.
- Запустите установщик от имени обычного пользователя. Не запускайте community-установщик от имени администратора.
- Следуйте мастеру.
Установщик:
- Обнаруживает предыдущую установку NVM for Windows
- Переносит настройки в хранилище предпочтений v2
- Объединяет версии Node.js в каталог хранения v2 (по умолчанию
%LOCALAPPDATA%\Author Software\nvm\installs) - Обновляет PATH и связанные переменные окружения для v2
Экраны мастера показывают ход миграции. См. Установщики для тихих ключей и предупреждений.
v2 поддерживает пользовательский каталог хранения Node.js (InstallRoot).
Задайте его в мастере или через nvm config после установки.
v2 не поддерживает пользовательский каталог программы NVM так, как это делал v1.
| Сборка | Каталог программы NVM |
|---|---|
| Community | %LOCALAPPDATA%\Author Software\nvm (фиксированный) |
| Certified | %ProgramFiles%\Author Software\nvm (фиксированный) |
Тихий community /DIR на другой путь игнорируется и останавливает установку с NVM4100.
Версии Node.js
Установленные версии Node.js из поддерживаемой установки v1 объединяются в хранилище v2.
При успешной копии повторная загрузка этих версий не нужна.
После установки откройте новый терминал и выполните nvm list, чтобы подтвердить версии.
Резервная копия в ограниченной среде
Во время миграции установщик копирует деревья версий Node.js и связанные файлы. Некоторые жёстко ограниченные среды блокируют или прерывают эти копии.
Если политика, антивирус или DLP могут блокировать копирование файлов, сначала сохраните хранилище Node.js из v1.
Скопируйте корень Node.js v1 (часто под %NVM_HOME% или ваш пользовательский путь) в безопасное место.
Восстанавливайте из этой копии только если миграция не удалась.
Winget
Winget — поддерживаемый путь установки community v2.
ID пакета изменился при переходе проекта в организацию nvm-windows.
| Путь установки | ID Winget |
|---|---|
| v1 (legacy) | CoreyButler.NVMforWindows |
| v2 (текущий) | AuthorSoftware.NVMWindows (moniker nvm-windows) |
Первое обновление с установки v1 через winget
Если v1 ставили через winget, один раз выполните:
winget install nvm-windows
Эта команда сбрасывает отслеживаемый ID пакета winget с CoreyButler.NVMforWindows на AuthorSoftware.NVMWindows.
Дальнейшие обновления идут обычным потоком winget upgrade.
winget upgrade nvm-windows
Пользователи установщика, которые позже переходят на winget
Если ставили через setup EXE (не winget), позже всё равно можно выполнить winget install nvm-windows.
Дальнейшие обновления тогда работают через стандартные операции winget upgrade.
Советы
- Для первой установки v2 предпочтите мастер setup EXE, если нужны экраны миграции и параметры хранилища.
- Если после сброса ID основной путь обновления — winget, для обновлений продукта
nvm upgradeне обязателен. Уведомления sync-инструмента по-прежнему могут сообщать о новой версии. - Не повышайте права для обычной community-установки через winget. См. Установщики.
Обновления на весь сайт
Для парка машин организации используйте certified-сборку. Certified-пакеты поддерживают MSI, Intune Win32 и развёртывание через Active Directory. Эти каналы — поддерживаемый путь для контролируемых обновлений на весь сайт.
- Скачайте certified-пакет из клиентского портала.
- Разверните через Ручное развёртывание, Intune или Active Directory.
- После установки примените лицензию и политики (Требования, Administrative Templates).
Если организация использовала NVM for Windows v1.1.7 или новее, certified MSI переносит существующую установку. Сначала удалите версии старше 1.1.7. Если вы создали собственное приложение Intune из v1.1.7 или новее, задайте Supersedence для Win32-приложения v2. См. Развёртывание через Microsoft Intune.
Community winget и community setup EXE рассчитаны на отдельные машины. Это не плоскость управления парком. Для развёртывания на весь сайт используйте certified-развёртывание.
Связанные материалы
| Тема | Документ |
|---|---|
| Community- и certified-установщики | Установщики |
| Тихие ключи community | Установщики — Тихая установка |
| Ручной certified MSI | Ручное развёртывание |
| Intune | Развёртывание через Microsoft Intune |
| Active Directory | Развёртывание через Active Directory |
| Обновления продукта в приложении | nvm upgrade |
| Выбор community vs certified | Выбор сборки |