مشاركة عبر

متغيرات بيئة وقت تشغيل Azure Batch

تعين خدمة Azure Batch متغيرات البيئة التالية على عقد الحوسبة. يمكنك الرجوع إلى متغيرات البيئة هذه في أسطر أوامر المهام، وفي البرامج والبرامج النصية التي يتم تشغيلها بواسطة أسطر الأوامر.

لمزيد من المعلومات حول استخدام متغيرات البيئة مع Batch، راجع إعدادات البيئة للمهام.

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

تكون متغيرات البيئة هذه مرئية فقط في سياق مستخدم المهمة، وهو حساب المستخدم على العقدة التي يتم تنفيذ مهمة ضمنها. لن ترى هذه المتغيرات عند الاتصال عن بعد بعقدة حساب عبر بروتوكول سطح المكتب البعيد (RDP) أو Secure Shell (SSH) وسرد متغيرات البيئة. وذلك لأن حساب المستخدم المستخدم للاتصال عن بعد ليس هو نفس الحساب الذي تستخدمه المهمة.

للحصول على القيمة الحالية لمتغير بيئة، قم بتشغيل cmd.exe على عقدة حساب Windows أو /bin/sh على عقدة Linux:

cmd /c set <ENV_VARIABLE_NAME>

/bin/sh -c "printenv <ENV_VARIABLE_NAME>"

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

لا تعمل أسطر الأوامر التي تنفذها المهام على عقد الحوسبة ضمن shell. وهذا يعني أنه لا يمكن لخطوط الأوامر هذه استخدام ميزات shell في الأصل مثل توسيع متغير البيئة (بما في PATHذلك ). لاستخدام مثل هذه الميزات، يجب استدعاء shell في سطر الأوامر. على سبيل المثال، قم بتشغيل cmd.exe على عقد حساب Windows أو /bin/sh على عقد Linux:

cmd /c MyTaskApplication.exe %MY_ENV_VAR%

/bin/sh -c "MyTaskApplication $MY_ENV_VAR"

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

إشعار

AZ_BATCH_AUTHENTICATION_TOKEN مهمل وسيتم إيقافه في 30 سبتمبر 2024. راجع الإعلان للحصول على التفاصيل والتنفيذ البديل.

اسم المتغير وصف توافر مثال
AZ_BATCH_ACCOUNT_NAME اسم حساب Batch الذي تنتمي إليه المهمة. كافة المهام. حساب mybatchaccount
AZ_BATCH_ACCOUNT_URL عنوان URL لحساب Batch. كافة المهام. https://myaccount.westus.batch.azure.com
AZ_BATCH_APP_PACKAGE بادئة لجميع متغيرات بيئة حزمة التطبيق. على سبيل المثال، إذا تم تثبيت الإصدار "1" من التطبيق "FOO" على تجمع، يتم AZ_BATCH_APP_PACKAGE_FOO_1 متغير البيئة (على Linux) أو AZ_BATCH_APP_PACKAGE_FOO#1 (على Windows). يشير AZ_BATCH_APP_PACKAGE_FOO_1 إلى الموقع الذي تم تنزيل الحزمة فيه (مجلد). عند استخدام الإصدار الافتراضي من حزمة التطبيق، استخدم متغير البيئة AZ_BATCH_APP_PACKAGE بدون أرقام الإصدار. إذا كان في Linux، وكان اسم حزمة التطبيق هو "Agent-linux-x64" والإصدار هو "1.1.46.0، فإن اسم البيئة هو في الواقع: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0، باستخدام التسطير السفلي والأحرف الصغيرة. لمزيد من المعلومات، راجع تنفيذ التطبيقات المثبتة لمزيد من التفاصيل. أي مهمة مع حزمة تطبيق مقترنة. تتوفر أيضا لجميع المهام إذا كانت العقدة نفسها تحتوي على حزم تطبيقات. AZ_BATCH_APP_PACKAGE_FOO_1 (Linux) أو AZ_BATCH_APP_PACKAGE_FOO#1 (Windows)
AZ_BATCH_AUTHENTICATION_TOKEN رمز مصادقة يمنح حق الوصول إلى مجموعة محدودة من عمليات خدمة الدفعات. متغير البيئة هذا موجود فقط إذا تم تعيين authenticationTokenSettings عند إضافة المهمة. يتم استخدام قيمة الرمز المميز في واجهات برمجة التطبيقات الدفعية كبيانات اعتماد لإنشاء عميل Batch، كما هو الحال في BatchClient.Open() .NET API. لا يدعم الرمز المميز الشبكات الخاصة. كافة المهام. الرمز المميز للوصول إلى OAuth2
AZ_BATCH_CERTIFICATES_DIR دليل داخل دليل عمل المهمة حيث يتم تخزين الشهادات لعقد حساب Linux. لا ينطبق متغير البيئة هذا على عقد حساب Windows. كافة المهام. /mnt/دفعة/مهام/عناصر العمل/batchjob001/job-1/task001/certs
AZ_BATCH_HOST_LIST قائمة العقد المخصصة لمهمة متعددة المثيلات بالتنسيق nodeIP,nodeIP. المهام الأساسية والفرعية متعددة المثيلات. 10.0.0.4,10.0.0.5
AZ_BATCH_IS_CURRENT_NODE_MASTER تحديد ما إذا كانت العقدة الحالية هي العقدة الرئيسية لمهمة متعددة المثيلات. القيم المُحتملة هي true وfalse. المهام الأساسية والفرعية متعددة المثيلات. true
AZ_BATCH_JOB_ID معرف الوظيفة التي تنتمي إليها المهمة. كافة المهام باستثناء مهمة البدء. الدفعة001
AZ_BATCH_JOB_PREP_DIR المسار الكامل لدليل مهمة إعداد الوظيفة على العقدة. جميع المهام باستثناء مهمة البدء ومهمة إعداد الوظيفة. يتوفر فقط إذا تم تكوين المهمة مع مهمة إعداد وظيفة. AZ_BATCH_JOB_PREP_DIR
AZ_BATCH_JOB_PREP_WORKING_DIR المسار الكامل لدليل عمل مهمة إعداد الوظيفة على العقدة. جميع المهام باستثناء مهمة البدء ومهمة إعداد الوظيفة. يتوفر فقط إذا تم تكوين المهمة مع مهمة إعداد وظيفة. AZ_BATCH_JOB_PREP_WORKING_DIR
AZ_BATCH_MASTER_NODE عنوان IP ومنفذ عقدة الحساب التي يتم تشغيل المهمة الأساسية لمهمة متعددة المثيلات عليها. لا تستخدم المنفذ المحدد هنا لاتصال MPI أو NCCL - فهو محجوز لخدمة Azure Batch. استخدم المتغير MASTER_PORT بدلا من ذلك، إما عن طريق تعيينه بقيمة تم تمريرها من خلال وسيطة سطر الأوامر (المنفذ 6105 هو خيار افتراضي جيد)، أو استخدام القيمة التي يعينها AML إذا كان الأمر كذلك. المهام الأساسية والفرعية متعددة المثيلات. 10.0.0.4:6000
AZ_BATCH_NODE_ID معرف العقدة التي تم تعيين المهمة إليها. كافة المهام. TVM-1219235766_3-20160919T172711Z
AZ_BATCH_NODE_IS_DEDICATED إذا ، trueفإن العقدة الحالية هي عقدة مخصصة. إذا كانت false، فهي عقدة Azure Spot. كافة المهام. true
AZ_BATCH_NODE_LIST قائمة العقد المخصصة لمهمة متعددة المثيلات بالتنسيق nodeIP;nodeIP. المهام الأساسية والفرعية متعددة المثيلات. 10.0.0.4;10.0.0.5
AZ_BATCH_NODE_MOUNTS_DIR المسار الكامل لموقع تحميل نظام الملفات على مستوى العقدة حيث توجد جميع دلائل التحميل. تستخدم مشاركات ملفات Windows حرف محرك أقراص، لذلك بالنسبة إلى Windows، يعد محرك الأقراص جزءا من الأجهزة ومحركات الأقراص. جميع المهام بما في ذلك مهمة البدء لها حق الوصول إلى المستخدم، نظرا لأن المستخدم على علم بأذونات التحميل للدليل الذي تم تحميله. AZ_BATCH_NODE_MOUNTS_DIR
AZ_BATCH_NODE_ROOT_DIR المسار الكامل لجذر جميع دلائل Batch على العقدة. كافة المهام. AZ_BATCH_NODE_ROOT_DIR
AZ_BATCH_NODE_SHARED_DIR المسار الكامل للدليل المشترك على العقدة. جميع المهام التي تنفذ على عقدة لها حق الوصول للقراءة/الكتابة إلى هذا الدليل. لا تتمتع المهام التي يتم تنفيذها على العقد الأخرى بإمكانية الوصول عن بعد إلى هذا الدليل (إنه ليس دليل شبكة "مشترك"). كافة المهام. AZ_BATCH_NODE_SHARED_DIR
AZ_BATCH_NODE_STARTUP_DIR المسار الكامل لدليل مهمة البدء على العقدة. كافة المهام. AZ_BATCH_NODE_STARTUP_DIR
AZ_BATCH_POOL_ID معرف التجمع الذي تعمل عليه المهمة. كافة المهام. الدفعة001
AZ_BATCH_TASK_DIR المسار الكامل لدليل المهام على العقدة. يحتوي هذا الدليل على stdout.txt و stderr.txt للمهمة AZ_BATCH_TASK_WORKING_DIR. كافة المهام. AZ_BATCH_TASK_DIR
AZ_BATCH_TASK_ID معرف المهمة الحالية. كافة المهام باستثناء مهمة البدء. المهمة001
AZ_BATCH_TASK_SHARED_DIR مسار دليل متطابق للمهمة الأساسية وكل مهمة فرعية لمهمة متعددة المثيلات. المسار موجود على كل عقدة يتم تشغيل المهمة متعددة المثيلات عليها، ويمكن الوصول إليها للقراءة/الكتابة لأوامر المهام التي تعمل على تلك العقدة (كل من أمر التنسيق والأمر التطبيق. لا تتمتع المهام الفرعية أو المهمة الأساسية التي يتم تنفيذها على العقد الأخرى بإمكانية الوصول عن بعد إلى هذا الدليل (إنه ليس دليل شبكة "مشترك"). المهام الأساسية والفرعية متعددة المثيلات. AZ_BATCH_TASK_SHARED_DIR
AZ_BATCH_TASK_WORKING_DIR المسار الكامل لدليل عمل المهمة على العقدة. المهمة قيد التشغيل حاليا لديها حق الوصول للقراءة/الكتابة إلى هذا الدليل. كافة المهام. AZ_BATCH_TASK_WORKING_DIR
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES الحد الحالي لمساحة القرص التي سيتم وضع علامة على الجهاز الظاهري عليها ك DiskFull. كافة المهام. 1000000
CCP_NODES قائمة العقد وعدد الذاكرات الأساسية لكل عقدة التي يتم تخصيصها لمهمة متعددة المثيلات. يتم سرد العقد والذاكرات الأساسية بالتنسيق numNodes<space>node1IP<space>node1Cores<space>
node2IP<space>node2Cores<space> ...، حيث يتبع عدد العقد عنوان IP عقدة واحد أو أكثر وعدد الذاكرات الأساسية لكل منها.		 المهام الأساسية والفرعية متعددة المثيلات. 2 10.0.0.4 1 10.0.0.5 1

مهم

تعتبر القيم الدقيقة لمسارات متغيرات البيئة تفاصيل التنفيذ وتخضع للتغيير. استخدم متغيرات البيئة التي توفرها الدفعة بدلا من محاولة إنشاء تمثيلات مسار أولي.

يحدد الجدول التالي قيم كل قيمة متغير بيئة postfix بعد قيمة AZ_BATCH_NODE_ROOT_DIR، راجع AZ_BATCH_NODE_ROOT_DIR لمزيد من المعلومات.

اسم متغير البيئة دليل قيمة متغير البيئة Postfix
AZ_BATCH_NODE_STARTUP_DIR startup
AZ_BATCH_NODE_SHARED_DIR shared
AZ_BATCH_NODE_MOUNTS_DIR fsmounts

تختلف دلائل الوظائف بين الوظيفة أحادية التشغيلوجدول الوظائف. يحدد الجدول التالي قيم دليل الوظيفة في جدول الوظائف والمهمة أحادية التشغيل.

نوع الوظيفة Postfix قيمة دليل الوظيفة بعد AZ_BATCH_NODE_ROOT_DIR
مهمة workitems\{job name}\job-1
جدول الوظائف workitems\{job schedule name}\{job name}

يحدد الجدول التالي قيم كل قيمة متغير بيئة postfix بعد دليل الوظيفة.

اسم متغير البيئة دليل قيمة متغير البيئة Postfix بعد دليل الوظيفة
AZ_BATCH_TASK_WORKING_DIR {task name}\wd
AZ_BATCH_TASK_DIR {task name}
AZ_BATCH_TASK_SHARED_DIR {task name}
AZ_BATCH_JOB_PREP_DIR {job prepration task name}
AZ_BATCH_JOB_PREP_WORKING_DIR {job prepration task name}\wd

الخطوات التالية

  • Last updated on