متغيرات بيئة وقت تشغيل Azure Batch
تقوم خدمة Azure 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 | اسم حساب الدفعة الذي تنتمي إليه المهمة. | جميع المهام. | mybatchaccount |
AZ_BATCH_ACCOUNT_URL | عنوان URL لحساب الدفعة. | جميع المهام. | 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 عند إضافة المهمة . يتم استخدام قيمة الرمز المميز في واجهات برمجة تطبيقات "الدُفعة" كبيانات اعتماد لإنشاء عميل "دفعة"، كما هو الحال في BatchClient.Open() .NET API. لا يدعم الرمز المميز الشبكات الخاصة. | جميع المهام. | رمز الوصول المميز لـ OAuth2 |
AZ_BATCH_CERTIFICATES_DIR | دليل ضمن دليل عمل المهمة الذي يتم تخزين الشهادات به من أجل عُقد حوسبة Linux. لا ينطبق متغير البيئة هذا على عُقد حوسبة Windows. | جميع المهام. | /mnt/batch/tasks/workitems/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 | معرف الوظيفة التي تنتمي إليها المهمة. | جميع المهام باستثناء مهمة البدء. | batchjob001 |
AZ_BATCH_JOB_PREP_DIR | المسار الكامل لدليل مهمة إعداد الوظيفة على العقدة. | جميع المهام باستثناء مهمة البدء ومهمة إعداد الوظيفة. تتوفر فقط إذا تم تكوين الوظيفة باستخدام مهمة إعداد الوظيفة. | C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation |
AZ_BATCH_JOB_PREP_WORKING_DIR | المسار الكامل لدليل عمل مهمة إعداد الوظيفة على العقدة. | جميع المهام باستثناء مهمة البدء ومهمة إعداد الوظيفة. تتوفر فقط إذا تم تكوين الوظيفة باستخدام مهمة إعداد الوظيفة. | C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation\wd |
AZ_BATCH_MASTER_NODE | عنوان IP ومنفذ عقدة حساب تشغيل المهمة الأساسية لمهمة متعددة المثيلات. لا تستخدم المنفذ المحدد هنا لاتصال MPI أو NCCL - محجوز لخدمة Azure Batch. استخدم المتغير MASTER_PORT بدلاً من ذلك، إما عن طريق تعيينه بقيمة تم تمريرها عبر وسيطة سطر الأوامر (المنفذ 6105 هو خيار افتراضي جيد)، أو باستخدام القيمة التي يعينها التعلم الآلي عند قيامه بذلك. | مهام فرعية وأساسية متعددة المثيلات. | 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، يعد محرك الإدخال جزءاً من الأجهزة ومحركات الأقراص. | تمتلك جميع المهام بما في ذلك مهمة البدء حق الوصول إلى المستخدم، نظراً لأن المستخدم على دراية بأذونات الإدخال الخاصة بالدليل المدخل. | في Ubuntu، على سبيل المثال، الموقع هو: /mnt/batch/tasks/fsmounts |
AZ_BATCH_NODE_ROOT_DIR | المسار الكامل لجذر جميع دلائل Batch على العقدة. | جميع المهام. | C:\user\tasks |
AZ_BATCH_NODE_SHARED_DIR | المسار الكامل للدليل المُشارك على العقدة. لدى جميع المهام التي تنفذ على العقدة إمكانية القراءة/الكتابة في هذا الدليل. لا تمتلك المهام التي تنفذ على العُقد الأخرى إمكانية الوصول عن بعد إلى هذا الدليل (فهو ليس دليل شبكة "مُشارك"). | جميع المهام. | C:\user\tasks\shared |
AZ_BATCH_NODE_STARTUP_DIR | المسار الكامل لدليل مهمة البدء على العقدة. | جميع المهام. | C:\user\tasks\startup |
AZ_BATCH_POOL_ID | معرف المجموعة التي تعمل عليها المهمة. | جميع المهام. | batchpool001 |
AZ_BATCH_TASK_DIR | المسار الكامل لدليل المهمة على العقدة. يحتوي هذا الدليل على stdout.txt وstderr.txt للمهمة، وAZ_BATCH_TASK_WORKING_DIR. |
جميع المهام. | C:\user\tasks\workitems\batchjob001\job-1\task001 |
AZ_BATCH_TASK_ID | معرف المهمة الحالية. | جميع المهام باستثناء مهمة البدء. | task001 |
AZ_BATCH_TASK_SHARED_DIR | مسار دليل مطابق للمهمة الأساسية وجميع المهام الفرعية لمهمة متعددة المثيلات. المسار موجود على كل عقدة تقوم بتشغيل المهمة متعددة المثيلات، ولديها إمكانية القراءة/الكتابة في أوامر المهمة التي يتم تشغيلها على تلك العقدة (كلاً من أمر التنسيق و أمر التطبيق. لا تتمتع المهام الفرعية أو المهمة الأساسية التي يتم تنفيذها على العُقد الأخرى بإمكانية الوصول عن بُعد إلى هذا الدليل (فهو ليس دليل شبكة "مُشارك"). | مهام فرعية وأساسية متعددة المثيلات. | C:\user\tasks\workitems\multiinstancesamplejob\job-1\multiinstancesampletask |
AZ_BATCH_TASK_WORKING_DIR | المسار الكامل لدليل عمل المهمة على العقدة. تتمتع المهمة الجاري تشغيلها حالياً بإمكانية القراءة/الكتابة في هذا الدليل. | جميع المهام. | C:\user\tasks\workitems\batchjob001\job-1\task001\wd |
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 |
الخطوات التالية
- تعرف على كيفية استخدام متغيرات البيئة باستخدام "الدُفعة".
- تعرف على معلومات حول الملفات والدلائل في "الدُفعة"
- تعرف على المهام متعددة المثيلات.