StartTask interface

الحزمة:

@azure/arm-batch

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

الخصائص

commandLine	لا يعمل سطر الأوامر تحت shell، وبالتالي لا يمكن الاستفادة من ميزات shell مثل توسيع متغير البيئة. إذا كنت ترغب في الاستفادة من هذه الميزات، يجب استدعاء shell في سطر الأوامر، على سبيل المثال باستخدام "cmd /c MyCommand" في Windows أو "/bin/sh -c MyCommand" في Linux. مطلوب إذا تم تحديد أي خصائص أخرى من startTask.
containerSettings	عند تحديد هذا، يتم تعيين جميع الدلائل بشكل متكرر أسفل AZ_BATCH_NODE_ROOT_DIR (جذر دلائل Azure Batch على العقدة) في الحاوية، ويتم تعيين جميع متغيرات بيئة المهمة في الحاوية، ويتم تنفيذ سطر أوامر المهمة في الحاوية.
environmentSettings	قائمة بإعدادات متغير البيئة لمهمة البدء.
maxTaskRetryCount	تعيد خدمة Batch محاولة مهمة إذا كانت التعليمة البرمجية للخروج الخاصة بها غير صفرية. لاحظ أن هذه القيمة تتحكم بشكل خاص في عدد مرات إعادة المحاولة. ستجرب خدمة Batch المهمة مرة واحدة، وقد تعيد المحاولة حتى هذا الحد. على سبيل المثال، إذا كان الحد الأقصى لعدد مرات إعادة المحاولة هو 3، فإن Batch يحاول المهمة حتى 4 مرات (محاولة أولية واحدة و3 محاولات). إذا كان الحد الأقصى لعدد مرات إعادة المحاولة هو 0، لا تعيد خدمة Batch محاولة المهمة. إذا كان الحد الأقصى لعدد مرات إعادة المحاولة هو -1، تعيد خدمة Batch محاولة المهمة دون حد. الافتراضي هو 0
resourceFiles	قائمة بالملفات التي ستقوم خدمة Batch بتنزيلها إلى عقدة الحساب قبل تشغيل سطر الأوامر.
userIdentity	إذا تم حذفها، يتم تشغيل المهمة كمستخدم غير إداري فريد للمهمة.
waitForSuccess	إذا كانت true وفشلت مهمة البدء على عقدة حساب، تعيد خدمة Batch محاولة مهمة البدء حتى الحد الأقصى لعدد إعادة المحاولة (maxTaskRetryCount). إذا لم تكتمل المهمة بنجاح بعد جميع عمليات إعادة المحاولة، فإن خدمة Batch تحدد عقدة الحساب غير قابلة للاستخدام، ولن تقوم بجدولة المهام إليها. يمكن الكشف عن هذا الشرط عبر حالة العقدة وتفاصيل خطأ الجدولة. إذا كانت خاطئة، فلن تنتظر خدمة Batch حتى تكتمل مهمة البدء. في هذه الحالة، يمكن أن تبدأ المهام الأخرى في التنفيذ على عقدة الحساب بينما لا تزال مهمة البدء قيد التشغيل؛ وحتى إذا فشلت مهمة البدء، فستستمر جدولة المهام الجديدة على العقدة. الإعداد الافتراضي صحيح.

تفاصيل الخاصية

commandLine

لا يعمل سطر الأوامر تحت shell، وبالتالي لا يمكن الاستفادة من ميزات shell مثل توسيع متغير البيئة. إذا كنت ترغب في الاستفادة من هذه الميزات، يجب استدعاء shell في سطر الأوامر، على سبيل المثال باستخدام "cmd /c MyCommand" في Windows أو "/bin/sh -c MyCommand" في Linux. مطلوب إذا تم تحديد أي خصائص أخرى من startTask.

commandLine?: string

قيمة الخاصية

string

containerSettings

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

containerSettings?: TaskContainerSettings

قيمة الخاصية

TaskContainerSettings

environmentSettings

قائمة بإعدادات متغير البيئة لمهمة البدء.

environmentSettings?: EnvironmentSetting[]

قيمة الخاصية

EnvironmentSetting[]

maxTaskRetryCount

تعيد خدمة Batch محاولة مهمة إذا كانت التعليمة البرمجية للخروج الخاصة بها غير صفرية. لاحظ أن هذه القيمة تتحكم بشكل خاص في عدد مرات إعادة المحاولة. ستجرب خدمة Batch المهمة مرة واحدة، وقد تعيد المحاولة حتى هذا الحد. على سبيل المثال، إذا كان الحد الأقصى لعدد مرات إعادة المحاولة هو 3، فإن Batch يحاول المهمة حتى 4 مرات (محاولة أولية واحدة و3 محاولات). إذا كان الحد الأقصى لعدد مرات إعادة المحاولة هو 0، لا تعيد خدمة Batch محاولة المهمة. إذا كان الحد الأقصى لعدد مرات إعادة المحاولة هو -1، تعيد خدمة Batch محاولة المهمة دون حد. الافتراضي هو 0

maxTaskRetryCount?: number

قيمة الخاصية

number

resourceFiles

قائمة بالملفات التي ستقوم خدمة Batch بتنزيلها إلى عقدة الحساب قبل تشغيل سطر الأوامر.

resourceFiles?: ResourceFile[]

قيمة الخاصية

ResourceFile[]

userIdentity

إذا تم حذفها، يتم تشغيل المهمة كمستخدم غير إداري فريد للمهمة.

userIdentity?: UserIdentity

قيمة الخاصية

UserIdentity

waitForSuccess

إذا كانت true وفشلت مهمة البدء على عقدة حساب، تعيد خدمة Batch محاولة مهمة البدء حتى الحد الأقصى لعدد إعادة المحاولة (maxTaskRetryCount). إذا لم تكتمل المهمة بنجاح بعد جميع عمليات إعادة المحاولة، فإن خدمة Batch تحدد عقدة الحساب غير قابلة للاستخدام، ولن تقوم بجدولة المهام إليها. يمكن الكشف عن هذا الشرط عبر حالة العقدة وتفاصيل خطأ الجدولة. إذا كانت خاطئة، فلن تنتظر خدمة Batch حتى تكتمل مهمة البدء. في هذه الحالة، يمكن أن تبدأ المهام الأخرى في التنفيذ على عقدة الحساب بينما لا تزال مهمة البدء قيد التشغيل؛ وحتى إذا فشلت مهمة البدء، فستستمر جدولة المهام الجديدة على العقدة. الإعداد الافتراضي صحيح.

waitForSuccess?: boolean

قيمة الخاصية

boolean