volta run
أمر volta run سيشغل الأمر الذي توفره، باستخدام إصدارات الأدوات المحددة في سطر الأوامر. له الصيغة التالية:
bash
تشغيل أمر باستخدام إصدارات مخصصة من Node و npm و/أو Yarn
الاستخدام:
volta run [FLAGS] [OPTIONS] <command> [--] [args]...
الأعلام:
--bundled-npm إجبار npm على استخدام الإصدار المرفق مع Node
--no-yarn تعطيل Yarn
--verbose تمكين التشخيص المفصل
--quiet منع المخرجات غير الضرورية
-h, --help طباعة معلومات المساعدة
الخيارات:
--node <version> تعيين إصدار Node مخصص
--npm <version> تعيين إصدار npm مخصص
--yarn <version> تعيين إصدار Yarn مخصص
--env <NAME=value>... تعيين متغيرات البيئة (يمكن استخدامها عدة مرات)
المعاملات:
<command> الأمر المراد تشغيله
<args>... المعاملات المراد تمريرها للأمركيف يعمل
أي أداة لم يتم تحديد إصدارها مباشرة سيتم تحديد إصدارها من خلال كشف السياق العادي لـ Volta، باستخدام الإصدارات المثبتة في المشروع أو الإصدارات الافتراضية.
ملاحظة يجب أن تكون إعدادات الإصدار قبل الأمر الذي تريد تشغيله. أي شيء بعد الأمر سيُعتبر معاملات ولن يتم قراءته بواسطة Volta.
أمثلة
تشغيل بإصدار Node محدد
bash
# تشغيل npm test باستخدام Node 14
volta run --node 14 npm test
# تشغيل سكريبت بأحدث Node 16
volta run --node 16 node script.jsتشغيل بإصدارات مديري الحزم المخصصة
bash
# تشغيل بإصدار npm محدد
volta run --npm 7.10.0 npm install
# تشغيل بإصدار Yarn محدد
volta run --yarn 1.22.10 yarn add expressدمج إصدارات الأدوات
bash
# تشغيل بإصدارات Node و npm محددة
volta run --node 14.17.0 --npm 6.14.13 npm install
# تشغيل بـ Node 16 و Yarn 1.22.10
volta run --node 16 --yarn 1.22.10 yarn buildاستخدام npm المرفق أو تعطيل Yarn
bash
# إجبار استخدام إصدار npm المرفق مع Node
volta run --bundled-npm npm install
# تعطيل Yarn في البيئة
volta run --no-yarn some-commandتعيين متغيرات البيئة
bash
# تعيين متغير بيئة واحد
volta run --env DEBUG=true npm test
# تعيين عدة متغيرات بيئة
volta run --env NODE_ENV=production --env DEBUG=false node server.jsحالات الاستخدام
أمر volta run مناسب لـ:
- الاختبار بإصدارات مختلفة: اختبار الكود الخاص بك ضد إصدارات مختلفة من Node.js دون تغيير الإعدادات الافتراضية أو المشروع
- المهام لمرة واحدة: تشغيل أوامر بإصدارات محددة من الأدوات لمهام متخصصة
- بيئات CI/CD: استخدام في خطوط أنابيب التكامل المستمر للاختبار ضد إصدارات متعددة من Node.js
- تثبيت التبعيات: تثبيت التبعيات باستخدام إصدارات محددة من npm أو Yarn
- تغييرات البيئة المؤقتة: تشغيل أوامر بمتغيرات بيئة معدلة دون التأثير على الإعدادات العالمية
الأنماط الشائعة
الاختبار عبر إصدارات Node متعددة
bash
# الاختبار بـ Node 14
volta run --node 14 npm test
# الاختبار بـ Node 16
volta run --node 16 npm test
# الاختبار بـ Node 18
volta run --node 18 npm testتشغيل أوامر NPX بإصدارات محددة
bash
# تشغيل create-react-app بإصدار Node محدد
volta run --node 16 npx create-react-app my-app
# تنفيذ مترجم TypeScript بإصدار Node محدد
volta run --node 14 npx tscتنفيذ السكريبتات
bash
# تشغيل سكريبت البناء ببيئة محددة
volta run --env NODE_ENV=production node build.js