JobReleaseTask interface

الحزمة:

@azure/batch

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

الخصائص

commandLine	سطر الأوامر لمهمة إصدار الوظيفة. لا يعمل سطر الأوامر تحت shell، وبالتالي لا يمكن الاستفادة من ميزات shell مثل توسيع متغير البيئة. إذا كنت ترغب في الاستفادة من هذه الميزات، يجب استدعاء shell في سطر الأوامر، على سبيل المثال باستخدام "cmd /c MyCommand" في Windows أو "/bin/sh -c MyCommand" في Linux. إذا كان سطر الأوامر يشير إلى مسارات الملفات، فيجب أن يستخدم مسارا نسبيا (بالنسبة إلى دليل عمل المهمة)، أو استخدام متغير البيئة المقدم من Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
containerSettings	إعدادات الحاوية التي يتم تشغيل مهمة إصدار الوظيفة بموجبها. عند تحديد ذلك، يتم تعيين جميع الدلائل بشكل متكرر أسفل AZ_BATCH_NODE_ROOT_DIR (جذر دلائل Azure Batch على العقدة) في الحاوية، ويتم تعيين كافة متغيرات بيئة المهمة في الحاوية، ويتم تنفيذ سطر أوامر المهمة في الحاوية. قد لا تنعكس الملفات التي يتم إنتاجها في الحاوية خارج AZ_BATCH_NODE_ROOT_DIR على القرص المضيف، ما يعني أن واجهات برمجة تطبيقات ملف Batch لن تتمكن من الوصول إلى هذه الملفات.
environmentSettings	قائمة بإعدادات متغير البيئة لمهمة إصدار الوظيفة.
id	سلسلة تعرف مهمة إصدار الوظيفة بشكل فريد داخل الوظيفة. يمكن أن يحتوي المعرف على أي تركيبة من الأحرف الأبجدية الرقمية بما في ذلك الواصلات والتسطير السفلي ولا يمكن أن يحتوي على أكثر من 64 حرفا. إذا لم تحدد هذه الخاصية، تقوم خدمة Batch بتعيين قيمة افتراضية ل "jobrelease". لا يمكن أن يكون لمهمة أخرى في الوظيفة نفس معرف مهمة إصدار الوظيفة. إذا حاولت إرسال مهمة بنفس المعرف، ترفض خدمة Batch الطلب برمز الخطأ TaskIdSameAsJobReleaseTask؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 409 (تعارض).
maxWallClockTime	الحد الأقصى للوقت المنقضي الذي قد يتم فيه تشغيل مهمة إصدار الوظيفة على عقدة حساب معينة، يتم قياسها من وقت بدء المهمة. إذا لم تكتمل المهمة ضمن الحد الزمني، تنهيها خدمة الدفعة. القيمة الافتراضية هي 15 دقيقة. لا يجوز لك تحديد مهلة أطول من 15 دقيقة. إذا قمت بذلك، ترفضها خدمة Batch مع وجود خطأ؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 400 (طلب غير صحيح).
resourceFiles	قائمة بالملفات التي ستقوم خدمة Batch بتنزيلها إلى عقدة الحساب قبل تشغيل سطر الأوامر. يوجد حد أقصى لحجم قائمة ملفات الموارد. عند تجاوز الحد الأقصى للحجم، سيفشل الطلب وسيكون رمز خطأ الاستجابة RequestEntityTooLarge. إذا حدث ذلك، يجب تصغير حجم مجموعة ResourceFiles. يمكن تحقيق ذلك باستخدام ملفات .zip أو حزم التطبيقات أو حاويات Docker. توجد الملفات المدرجة ضمن هذا العنصر في دليل عمل المهمة.
retentionTime	الحد الأدنى من الوقت للاحتفاظ بدليل المهام لمهمة إصدار الوظيفة على عقدة الحساب. بعد هذا الوقت، قد تحذف خدمة Batch دليل المهام وكافة محتوياته. الافتراضي هو 7 أيام، أي سيتم الاحتفاظ بدليل المهام لمدة 7 أيام ما لم تتم إزالة عقدة الحساب أو حذف المهمة.
userIdentity	هوية المستخدم التي يتم تشغيل مهمة إصدار الوظيفة بموجبها. إذا تم حذفها، يتم تشغيل المهمة كمستخدم غير إداري فريد للمهمة.

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

commandLine

سطر الأوامر لمهمة إصدار الوظيفة. لا يعمل سطر الأوامر تحت shell، وبالتالي لا يمكن الاستفادة من ميزات shell مثل توسيع متغير البيئة. إذا كنت ترغب في الاستفادة من هذه الميزات، يجب استدعاء shell في سطر الأوامر، على سبيل المثال باستخدام "cmd /c MyCommand" في Windows أو "/bin/sh -c MyCommand" في Linux. إذا كان سطر الأوامر يشير إلى مسارات الملفات، فيجب أن يستخدم مسارا نسبيا (بالنسبة إلى دليل عمل المهمة)، أو استخدام متغير البيئة المقدم من Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

commandLine: string

قيمة الخاصية

string

containerSettings

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

containerSettings?: TaskContainerSettings

قيمة الخاصية

TaskContainerSettings

environmentSettings

قائمة بإعدادات متغير البيئة لمهمة إصدار الوظيفة.

environmentSettings?: EnvironmentSetting[]

قيمة الخاصية

EnvironmentSetting[]

id

سلسلة تعرف مهمة إصدار الوظيفة بشكل فريد داخل الوظيفة. يمكن أن يحتوي المعرف على أي تركيبة من الأحرف الأبجدية الرقمية بما في ذلك الواصلات والتسطير السفلي ولا يمكن أن يحتوي على أكثر من 64 حرفا. إذا لم تحدد هذه الخاصية، تقوم خدمة Batch بتعيين قيمة افتراضية ل "jobrelease". لا يمكن أن يكون لمهمة أخرى في الوظيفة نفس معرف مهمة إصدار الوظيفة. إذا حاولت إرسال مهمة بنفس المعرف، ترفض خدمة Batch الطلب برمز الخطأ TaskIdSameAsJobReleaseTask؛ إذا كنت تتصل بواجهة برمجة تطبيقات REST مباشرة، فإن رمز حالة HTTP هو 409 (تعارض).

id?: string

قيمة الخاصية

string

maxWallClockTime

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

maxWallClockTime?: string

قيمة الخاصية

string

resourceFiles

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

resourceFiles?: ResourceFile[]

قيمة الخاصية

ResourceFile[]

retentionTime

الحد الأدنى من الوقت للاحتفاظ بدليل المهام لمهمة إصدار الوظيفة على عقدة الحساب. بعد هذا الوقت، قد تحذف خدمة Batch دليل المهام وكافة محتوياته. الافتراضي هو 7 أيام، أي سيتم الاحتفاظ بدليل المهام لمدة 7 أيام ما لم تتم إزالة عقدة الحساب أو حذف المهمة.

retentionTime?: string

قيمة الخاصية

string

userIdentity

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

userIdentity?: UserIdentity

قيمة الخاصية

UserIdentity