Driftr: адмініструемы калібруемы манеджэр версій Node па аднойчыні пасля таго, як развіцце Volta зупінілася

Менеджэр версій должны быць непазначальным

Дзеўнаць гадоў Volta састаяў непазначальным у багатых настройках Node: пазначылі версію для кожнага праекту, запісалі node, і запускаўся правы бінарны файл. Не было nvm use, не было хукіў у шэле, якія б завантажвалі рэсурсы з кожнага запуску, мала колькасць проблем з “нечыстым Node” у CI. Потым рэпазітарый Volta затых — малая колькасць змян, застой у планах развітку, нерашаныя запіты. Менеджар, які не можа сочыць за новымі выданнямі Node, перастае быць зручным і становіцца абаронай.

Рашэнням, якое стало Driftr, была падтрымка модэлю shim Volta і яго перабудова ў падтрымваны інструмент на Go з дадатковымі функцыямі карыстоўвання сераўнамі.

Хорашыя камандаравы знікаюць пасля наладкі. Большасць — няўсёле. З nvm запуск праекта значыць памятаць nvm use; забывчына коштуе часу на дэбагаванне, які на самай працы быў наследкам несувярэннасці версій. Хукі шэлу, якія автаматычна перэключаюцца пад cd, парсуюць .nvmrc пад кожным запытам і сповалююць працэздатнасць тэрміналу. fnm — гэта быстрэйшая версія на мове Rust, якая выкорыстоўвае той самы модэль хуків і PATH.

Volta выкорыстоўваў заменнікі: маленькія элементы на PATH, якія працавалі аднойчы. Калі запускалася програма node, яна звязывалася з такім заменніком, які выбіраў правы бінарны файл. Не было додатковых зусіль пад кожны запыт, не было рызыка забыць перэключыцца. Калі Volta застаўся без розвітку, метай не была змена модэля — гэта быў той самы модэль, які працаваў і ўсё далей развіваўся.

Калі камандарав версій перастае падтрымвацца

Фраза «Ён яшчэ працюе» недасткі для гэтай катагорыі. Задача заключаецца у стэжэнні за зменяючымся об’ектам: новыя мажорныя версіі, фарматы індэкса выпускаў, чэксумы, працэс падпісвання і архітэктуры (Apple Silicon заўтрака перэтворыў версіі arm64 на стандарт). Менеджар, які не падтрымваны, паступова не можа обрабатваць новыя выпускі, пропускае певныя платформы або ніколі не вносіць правакі ў шляхі завантажэння. Самэ гэта робіць чаканне на бездзейнае крыніцы паслабленым планам для цэнтру інструментальнага ланцуга.

Што такое Driftr

Driftr — гэта менеджар на адной засадзе шымов для node, npm, npx, pnpm, pnpx і yarn, напісаны на Go. Вы канфігуруеце версіі, фіксаваеце ў кожным праекце і звычайна запускаеце інструменты; шымы выбіраюць відпаведны бінарны файл.

Кождадзённыя каманды застаюцца простымі:

# Install a version. A bare tool name installs the latest release.
driftr install node
driftr install pnpm@9
driftr install yarn@1

# Pin a version to the current project
driftr pin node@24# See what would actually run, and why
driftr which node# Then just use your tools. The shims resolve the pin.
node -v      # v24.x.x, because this project is pinned
pnpm install # uses the pinned pnpm

Фіксацыі знаходзяцца ў файле .driftr.toml:

[tools]
node = "24.16.0"
pnpm = "9.15.0"

Альбо пад ключам driftr у файле package.json:

{
  "name": "my-app",
  "driftr": { "node": "24.16.0" }
}

За межамі фіксаваных структураў дыяўчы ўніверсальны стандартны значэнне. Няма хукав у шэле, няма дапамогі праз кожны запыт.

Як працюе рашэнне

Пры введзенні node адбываецца перагляд гэтага парадку і выбіраецца першы варыянт:

1. явнае пераканстанне (выкарыстоўваецца паляч driftr run)
2. файл праекта .driftr.toml
3. ключам driftr у файле package.json
4. універсальны стандартны значэнне

Частковыя фіксацыі рашуюцца разумна: node@24 означае найновейшую версію 24.x, якая была установлена; node@latest адбірае інформацыю з офіцыйнага каталогу. Полны код 24.16.0 выкарыстоўваецца толькі тады, калі трэба точна фіксаваная версія.

Чаму шымы, і чаму Go

Шымы абэрнуюць дапамогу праз кожны запыт

Шым — гэта маленькій віконуемы файл з назвайцю інструмента — ~/.driftr/bin/node у PATH. Калі запускаецца node, працюе шым, які запытае рэзалвера, якую версію хочаць гэты катэгорыя, а пасля перадае задачу далей. Бездзейныя шэлы не плацяюць нічога: без функцый пры запытанні, без сканавання .nvmrc пад cd, без перапісвання PATH. Косць з’яўляецца толькі калі запускаецца інструмент. Самэй гэтая асіметрыя ў тым, што холадныя тэрміналы знову становяцца швыракімі пасля выйшчы з менеджэраў, базаваных на хукі: шэл больш не плаціць за правілы версій на кожны раз, калі перазапускаецца прымус.

Функцыя Go і syscall.Exec дазволяюць перадачу задачы за мілісекунду

Шым располагаецца пры кожным запуску команды, таму важна яго „гарачая“ дорага. Стварэнне Node як падрабічнага працэсу залішае обгорткавы процэс на весь час жыцця команды — дадзейны PID, памяць, некалькі проблемных сігналаў. Driftr вызывае syscall.Exec пасля аналізу, заменяючы образ процэса шыма на справжні бінарны файл. Не застаёцца жадной обгорткавай процэсу; калі запускаецца код корыстніка, PID ўжо ёсць node. Надтачка становіцца апошні мілісэкунду, і саме так выглядае „невызначальная“ дзейнасць.

Звычкі надзеямасці

Прыткія завантажэння пераканальваюцца з офіцыяльным файлам SHASUMS256.txt пры першай прабеўцы з’явіцца надзею; калі вырашаюцца не адпаведна, кэшаваны архіў вычысляецца, ўнаследке чаго прабывы завантажэння адбываюцца чыста. У разе незусім успешнага адкрывання файлоў дыктарыі з напалову запісанымі версіямі вычысляюцца, ўнаследке чаго яны ніколі не будуць вазьваныя падатлымі да інсталяцыі. Паказаныя корыстніку памылкі завершаюцца точным камандам на выправленне, напрыклад Run 'driftr install node@24.1.0'. Спіс залежнасцей намеравана застаецца короткім — Cobra для парсінгу праз CLI, адна бібліятэка TOML і стандартныя пакеты Go для завантажэння, гэшавання, архіваў і замены процэсаў. Усе, што мусі выканацца перад кожным вызывам node, должна запярэчыць наявнасці занадто большога графа модуляў.

Driftr перыякае прэтварацца ў менеджэр пакетаў

Неправільныя версіі Node выклікаюць раздражэнне. Вага папакi node_modules заполняе дыскі: дзесяткi праектаў кожны з якіх маюць тыяжэлыя структуры паветра ў кілагабайтах, заполненыя дублюючыміся файламі react, typescript і lodash. У каталогах домашніх папак таксама знаходзяцца дзесяткі габайтаў копій.

pnpm ўжо зберагае пакеты аднойчы ў глобальным хранільніку з адрэсаванням кантэнту і стварае жорсткія зв’язкi ў праекты — часта скорачаючы колькасць дубляў у розмерэ 68 ГБ да 11 ГБ у спяльным хранільніку. Іх адымленне сповольняецца таму, што крок налаштавання лёгка праігнораваць.

Модуль оптымізацыі Node ад Driftr не заменяе pnpm; ён актываўае практыкі спяльнага хранільніка, якія люды рэдка налаштовваюць вручную:

driftr node doctor     # analyze the current environment
driftr node optimize   # configure pnpm's shared store
driftr node clean      # reclaim space safely
driftr node report     # see project usage vs. shared store

driftr node doctor адмаўляе інфармацыю пра менеджэр пакетаў, статус Corepack, розмер локальных папак node_modules, месца розташавання хранільніка і тое, чыякі ўвімкнуты глобальны віртуальны хранільнік, а пасля прыказвае наступны крок:

Driftr Node Doctor

Project:              ~/projects/api
Package manager:      pnpm
Node.js:             24.16.0
pnpm:                9.15.0
node_modules:        1.8 GB
pnpm store:          ~/.driftr/stores/pnpm
global virtual store: disabledRecommendation
Enable pnpm shared storage to reduce duplicated dependency data.
Run: driftr node optimize

driftr node optimize актывае Corepack, наставляе pnpm на спяльны магазін, кераваны Driftr, і увёльняе глобальны вяртуальны магазін. Ён ідэмпатэнтны і выводзіць тое, што змянілася:

Optimizing pnpm shared dependency storage

corepack enabled
set store-dir = ~/.driftr/stores/pnpm
set enable-global-virtual-store = trueDone. Dependencies are now stored in the shared pnpm store.

driftr node clean па замовчанню выконвае тэставанне і моцьна змяніцца толькі з параметрам --yes:

Dry run
No changes made. Re-run with --yes to execute.

Would remove: ~/projects/api/node_modules (1.8 GB)
Would run:    pnpm install
Would run:    pnpm store prune

driftr node report парабялеўвае node_modules гэтага праекту з спяльным магазіном, не ствараючы фальшывых заяваў у стыле “вы захавалі 57 GB” — выгода стосуецца всей машыны.

Фармаванне мае значэнне: Driftr — гэта менеджэр асяроддзя, які автаматызуе хорашыя практыкі, якія ужо падтрымваюць лепшыя менеджэры пакетаў. Гэта меньшая задача, чым “заменіць pnpm”, і ён паслабляе выкарыстоўванне дыска, часы інсталяціі і непастойчывасць, не зменяючы повсякдзённыя працэсы.

Як Driftr парабялеўвае

Tool                    nvm         fnm          Volta         Driftr
Mechanism               shell hook  hook / PATH  shims         shims
Per-prompt overhead     yes         small        none          none
Language                shell       Rust         Rust          Go
Whole toolchain         no          no           yes           yes
Per-project pin file    .nvmrc      .node-ver…   package.json  .driftr.toml
Checksum verification   partial     yes          yes           yes
Dep-storage optimize    no          no           no            yes
Actively maintained     yes         yes          stalled       yes

Серэд усіх аспектаў выдзеляецца оптымізацыя зберохвату залежнасцей — большасць керуючых ігноруе яе, таму што не розглядаюць сябе як інструменты для керування серэдавым.

Як яго запусціць

Автансоўны код, рэгулярныя выпускі, Homebrew або скрыпт для інсталяцыі:

# Homebrew (macOS / Linux)
brew install driftrlabs/driftr/driftr
driftr setup

# or the install script
curl -fsSL https://driftr.dev/install.sh | sh

driftr setup стварае неабходныя файлы і налаштаванні PATH; driftr doctor пераконваецца ў правільной інсталяцыі. Падтрымка macOS і Linux, архітэктуры x64 і arm64, выпускі з контрольнымі сумамі і падпісямі Sigstore, мінімальныя залежнасці, ў рэзультаце чаго інструменты, якія знаходзяцца на пачатку PATH, застаюць непазначальнымі.

Команды, які расследуюць можлівасць пераходу, таксама должны запісаць у віглядзе скрыптав ці нудныя пераконтроўкі. Пасля установкі неабходна пераканацца, што which node вказуе на каталог shim, пераканацца, што driftr which node правільна адпаведае джэру піну, і пераканацца, што чыстая абляца без файлав праекту все равно запускаецца за стандартным глобальным налашчэнням. Гэтыя тры пераконтроўкі дапамагаюць быстрэй выявіць памылкі ў парадку PATH, чым зноў чытаць дасведчэнні.

На машынах з колькама распрацоўшчыкамі .driftr.toml (альбо блок driftr у package.json) неабходна зберагаць так сама, як і налашчэнні двыжка. Образы CI все ўсё могу выкорыстоўваць базовы Node, але локальныя shim-файлы тады будуць адпаведаць таму, што заявлена ў рэпазітарыі, а не таму, што засталося пасля пярэдньага brew upgrade. Яго можна спалучыць з працэсам оптымізацыі, каб ноутбукі больш не стваралі прыватныя копіі тых сабе ж архіваў рэжыстры.

Калі падаець завантажэнне праз няверныя рэзультаты пераконтроўкі чэксума, спрыймайце гэта як сігнал абавязкова пераглянуць корпаратыўныя проксі або кэш-сховішчы, перш чым прабаваць знову за дапамогою параметра --force. Функцыя выдалення і павторнага завантажэння існуе таму, каб заражаны частковы файл ніколі не стаў “готовай установкай”. Аператары, якія копіююць дыстрыбуцыі Node, должны зберагаць SHASUM-вярнікі разам з архіваў, якія яны выдаюць.

На завершанне, памятайце, чым гэты інструмент не ёсць. Ён не заменіць семантыку файлу блокавання вашага менеджэра пакетаў, не створыць новага алгорытму установкі і не будзе вечна маскаваць сабэйную настройку pnpm — ён проста увімкне тыя настройкі, якія большасць людзей ніколі не выклікае. Гэта чыстасць пазбягляе неадэкватных аспакоўкаў, калі баг знаходзіцца ў самам pnpm або Corepack, а не ў шым-шарэ.

Заканчэнне

Driftr існуе таму, што адміністратар паверэглаўных шымов перастаў выдаваць абнаўленні. Яго перзбудова таксама расклічвала аўтаматызацыю хранення залежнасцяў, якая неабходная для ўседзённой працы з Node і якая рэдка канфігуруецца. Зафіксавайце версію, запустыце node, парадкавайце храненне pnpm, а потым проста забудзіце пра адміністратара. Праект знаходзіцца на github.com/DriftrLabs/Driftr.

Калі перыяд тыхасці Volta вас абярогаў, калі хукі nvm здаюцца надто складнымі, або калі дубліраваныя папкі node_modules спрацоўваюць рэсурсы ноутбука, то самэ гэтае аўдытарыя, якой належаць гэтыя шымы і команды для оптымаізацыі. Канфігуруйце раз; пасля чаго нехай рашэнні і спяльнае хранення не ствараюць проблем.

Касовыя нарабатанні павінны здавацца нуднымі: клонуеце рэпозытарый, павераецеся файлам з настройкамі, запускаеце тэсты, праходзіце да наступнага крока. Цікавая работа выконвалася толькі раз — пад установкай, пад оптымізацыей, а таксама кожны раз, калі Node выходзіць з новай версіяй, якую трэба дадаць. Усё, што відбываецца межы гэтымі моментамі, павінна выглядаць як звычны node і звычны pnpm; гэта самэе тое, чыраму правілы размешчаюцца ў шымах і спяльных хранілішчах, а не ў людскай памяці.

У дакументах з інструкцыямі для новых спецялістаў неабходна задокументаваць стандартныя настройкі Node, якіх чакае ваша команда, каб новыя працавнікі не стваралі «чатвертага менеджэра» вось у першы ж дзень. Для таго, што запускаецца перад кожным камандам, адпаведнасць важней за новасць.