Skip to content

تثبيت إصدار Node

إحدى أقوى ميزات Volta هي القدرة على تثبيت إصدارات محددة من الأدوات لمشروعك، مما يضمن استخدام الجميع الذين يعملون على المشروع نفس سلسلة الأدوات تمامًا.

لماذا تثبيت الإصدارات؟

  • التناسق: الجميع في الفريق يستخدم نفس الإصدار
  • إعادة الإنتاج: بيئة البناء تطابق بيئة التطوير
  • الموثوقية: لا مفاجآت من سلوك الأدوات غير المتوقع
  • الانضمام: أعضاء الفريق الجدد يحصلون تلقائيًا على الإعداد الصحيح

كيفية تثبيت Node.js

لتثبيت إصدار محدد من Node.js لمشروعك:

bash
volta pin node@16.14.2

هذا الأمر:

  1. يحمل ويثبت Node.js 16.14.2 (إذا لم يكن موجودًا بالفعل)
  2. يحدث package.json الخاص بك باستخدام قسم volta
  3. يجعل المشروع يستخدم Node.js 16.14.2 عند تشغيل node في دليل المشروع

سيحتوي package.json الخاص بك الآن على:

json
{
  "volta": {
    "node": "16.14.2"
  }
}

تثبيت مديري الحزم

يمكنك أيضًا تثبيت إصدارات محددة من مديري الحزم:

bash
volta pin npm@8.5.0
volta pin yarn@1.22.18
volta pin pnpm@7.0.0

هذا يضمن استخدام الجميع نفس إصدار مدير الحزم، مما يمنع عدم تناسق ملفات القفل ومشاكل الإصدارات الأخرى.

بعد تثبيت npm، سيبدو package.json الخاص بك كما يلي:

json
{
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0"
  }
}

استخدام الأدوات المثبتة

بمجرد تثبيت الأداة، لا حاجة لأوامر إضافية. فقط انتقل إلى دليل مشروعك وشغل الأوامر كالمعتاد:

bash
# هذه ستستخدم الإصدارات المثبتة لمشروعك
node --version
npm --version

يكتشف Volta تلقائيًا متى تكون في دليل بإصدارات مثبتة ويستخدمها بدلاً من أدواتك الافتراضية.

تحديث الإصدارات المثبتة

لتحديث الإصدارات المثبتة:

bash
volta pin node@latest
volta pin npm@latest

أو تحديد إصدار جديد:

bash
volta pin node@18

أفضل الممارسات

متى تثبت

  • للتطبيقات الإنتاجية: ثبت دائمًا Node ومدير الحزم الخاص بك
  • للمكتبات/الحزم: إذا كان الكود الخاص بك يعتمد على ميزات Node محددة، ثبت Node
  • للأدوات/المرافق: ثبت الحد الأدنى من إصدار Node المطلوب للميزات

اختيار الإصدار

  • للتطبيقات، اختر إصدار LTS (دعم طويل المدى) من Node
  • للمكتبات، استخدم أقدم إصدار Node تريد دعمه
  • حدث الإصدارات بانتظام للاستفادة من إصلاحات الأمان

تكامل CI/CD

تأكد من أن خط أنابيب CI/CD الخاص بك يحترم الإصدارات المثبتة:

  • استخدم Volta GitHub Action في سير عمل GitHub
  • لأنظمة CI الأخرى، ثبت Volta، وسيستخدم تلقائيًا الإصدارات المثبتة