متغيرات البيئة

يتبع Volta عدة متغيرات بيئة تتحكم في سلوكه. هذه الصفحة كمرجع لجميع متغيرات البيئة المتاحة وتأثيرها.

متغيرات البيئة الأساسية

VOLTA_HOME

يحدد الدليل الذي يخزن فيه Volta بياناته، بما في ذلك الأدوات والملفات المحملة.

• القيمة الافتراضية:
  • Unix: $HOME/.volta
  • Windows: %LOCALAPPDATA%\Volta
• مثال: VOLTA_HOME=/opt/volta

VOLTA_LOGLEVEL

يتحكم في مستوى تفصيل مخرجات سجلات Volta.

• القيم الصالحة: error، warn، info، verbose، debug
• القيمة الافتراضية: info
• مثال: VOLTA_LOGLEVEL=debug volta install node

VOLTA_SKIP_SETUP

عند تعيينه إلى 1، يمنع Volta من تعديل ملفات تكوين shell أثناء التثبيت.

• القيم الصالحة: 0، 1
• القيمة الافتراضية: 0
• مثال: VOLTA_SKIP_SETUP=1 bash -c "$(curl https://get.volta.sh)"

أعلام الميزات

VOLTA_FEATURE_PNPM

يتم دعم pnpm في Volta.

• القيم الصالحة: 0، 1
• القيمة الافتراضية: 0
• مثال: VOLTA_FEATURE_PNPM=1 volta install pnpm

تكوين الشبكة

VOLTA_NETWORK_TIMEOUT_SECS

يحدد مهلة العمليات الشبكية (بالثواني).

• القيمة الافتراضية: 60
• مثال: VOLTA_NETWORK_TIMEOUT_SECS=120 volta install node

HTTP_PROXY / HTTPS_PROXY

متغيرات البيئة القياسية للوكيل التي يستخدمها Volta للطلبات الشبكية.

• مثال:
  • HTTP_PROXY=http://proxy.example.com:8080
  • HTTPS_PROXY=http://proxy.example.com:8080

NO_PROXY

قائمة مفصولة بفواصل للخوادم التي يجب تجاوز الوكيل لها.

• مثال: NO_PROXY=localhost,127.0.0.1,.example.com

متغيرات التثبيت

VOLTA_LATEST_VERSION

يجبر برنامج تثبيت Volta على استخدام إصدار محدد بدلاً من أحدث إصدار.

• مثال: VOLTA_LATEST_VERSION=1.0.5 bash -c "$(curl https://get.volta.sh)"

VOLTA_TARGET_PROFILE

يحدد ملف تكوين shell الذي يجب أن يعدله برنامج التثبيت.

• القيمة الافتراضية: كشف تلقائي بناءً على shell الحالي
• مثال: VOLTA_TARGET_PROFILE=$HOME/.bashrc

متغيرات خاصة بالمنصة

VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK

الحد الأدنى لإصدار Volta المتوافق لفحص التحديث في إشعارات التحديث.

• مثال: VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK=1.0.5

متغيرات خاصة بـ Windows

هذه المتغيرات تستخدم فقط على أنظمة Windows:

VOLTA_REDIRECT_STDERR

عند تعيينه إلى 1، يعيد توجيه مخرجات stderr إلى stdout على Windows.

• القيم الصالحة: 0، 1
• القيمة الافتراضية: 0

الاستخدام المتقدم

VOLTA_UNSAFE_DIAGNOSTIC

للتصحيح؛ يتم تشغيل تشخيص متقدم قد يكون غير مستقر.

• القيم الصالحة: أي سلسلة نصية
• مثال: VOLTA_UNSAFE_DIAGNOSTIC=timing volta install node

VOLTA_STDIN_FILE_PASSTHROUGH

عند تعيينه، سيستخدم Volta مسار هذا الملف بدلاً من stdin لتنفيذ السكريبت.

• مثال: VOLTA_STDIN_FILE_PASSTHROUGH=/tmp/script.js volta run node

أمثلة التكوين

بيئة التطوير

لإعداد التطوير مع سجلات مفصلة:

export VOLTA_HOME=$HOME/.volta
export VOLTA_LOGLEVEL=verbose
export PATH=$VOLTA_HOME/bin:$PATH

خط أنابيب CI/CD

لبيئة التكامل المستمر:

export VOLTA_HOME=$HOME/.volta
export VOLTA_LOGLEVEL=error
export VOLTA_NETWORK_TIMEOUT_SECS=300
export PATH=$VOLTA_HOME/bin:$PATH

شبكة المؤسسة

لبيئة بها خوادم وكيل:

export VOLTA_HOME=$HOME/.volta
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1,.internal.example.com
export PATH=$VOLTA_HOME/bin:$PATH