ManualValidation@0 - مهمة التحقق اليدوي v0
استخدم هذه المهمة لإيقاف تشغيل مسار YAML مؤقتا لانتظار التفاعل اليدوي.
بناء الجملة
# Manual validation v0
# [PREVIEW] Pause a pipeline run to wait for manual interaction. Works only with YAML pipelines.
- task: ManualValidation@0
inputs:
notifyUsers: # string. Required. Notify users.
#instructions: # string. Instructions.
#onTimeout: 'reject' # 'reject' | 'resume'. On timeout. Default: reject.
الإدخالات
notifyUsers
- إعلام المستخدمين
string
. مطلوب
إرسال بريد إلكتروني معلق للتحقق اليدوي إلى مستخدمين محددين (أو مجموعات). يمكن فقط للمستخدمين الذين لديهم إذن إنشاء قائمة انتظار العمل على التحقق اليدوي. يمكنك إرسال بريد إلكتروني إلى مجموعة باستخدام بناء الجملة [org name]\group name
.
إدخال المهمة هذا مطلوب، ولكن يمكنك تحديد سلسلة فارغة إذا كنت لا تريد إعلام أي شخص، على سبيل المثال أثناء تشغيل الاختبار: notifyUsers: ''
.
instructions
- تعليمات
string
.
يحدد الإرشادات التي تظهر للمستخدم عند استئناف التدخل اليدوي أو رفضه. بناء على هذه التعليمات، سيتخذ المستخدم قرارا مستنيرا بشأن هذا التدخل اليدوي.
onTimeout
- في المهلة
string
. القيم المسموح بها: reject
، . resume
القيمة الافتراضية: reject
.
يرفض هذا التحقق اليدوي أو يستأنفه تلقائيا بعد أن يكون معلقا للمهلة المحددة، أو 30 يوما، أيهما سابق.
خيارات التحكم بالمهمة
تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.
متغيرات الإخراج
لا شيء
الملاحظات
استخدم هذه المهمة في مسار YAML لإيقاف التشغيل مؤقتا داخل مرحلة. يتم تنفيذ هذا عادة لتنفيذ خطوات أو إجراءات يدوية مختلفة ثم يتم استئناف التشغيل أو رفضه.
هام
هذه المهمة مدعومة فقط في مسارات YAML ولا يمكن استخدامها إلا في وظيفة بدون عامل لمسار YAML.
تتيح لك مهمة التحقق اليدوي إيقاف تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية مؤقتا ضمن مرحلة، عادة لتنفيذ بعض الخطوات أو الإجراءات اليدوية، ثم المتابعة مع البنية الأساسية لبرنامج ربط العمليات التجارية. على سبيل المثال، قد يحتاج المستخدم إلى التحقق يدويا من صحة تكوينات توزيع معينة قبل أن يبدأ المسار مهمة حسابية مكثفة طويلة الأمد.
يتضمن تكوين مهمة التحقق اليدوي معلمة تعليمات تستخدم لتوفير معلومات ذات صلة أو لتحديد الخطوات اليدوية التي ينفذها المستخدم أثناء الإيقاف المؤقت. يمكنك تكوين المهمة لإرسال إعلامات البريد الإلكتروني إلى المستخدمين ومجموعات المستخدمين عندما تكون في انتظار مراجعة وتحديد الاستجابة التلقائية (رفض أو استئناف) بعد حدوث مهلة قابلة للتكوين.
يمكنك تحديد قيمة المهلة للمهمة باستخدام المعلمة الاختيارية timeoutInMinutes
المتوفرة في خصائص المهمة الشائعة.
ملاحظة
لتشغيل المهمة بالكامل، timeoutInMinutes
يجب أن تكون قيمة المهمة (default = 60 minutes
) التي تحتوي على هذه المهمة أعلى من timeoutInMinutes
قيمة المهمة نفسها. راجع قيم مهلة الوظيفة الافتراضية.
تلميح
يمكنك استخدام المتغيرات لتحديد عناوين البريد الإلكتروني في المعلمة notifyUsers
.
عند تنشيط مهمة التحقق اليدوي أثناء البنية الأساسية لبرنامج ربط العمليات التجارية، فإنها تعرض شريط رسائل مع ارتباط يفتح مربع حوار التحقق اليدوي، الذي يحتوي على الإرشادات. بعد تنفيذ الخطوات اليدوية، يمكن للمسؤول أو المستخدم اختيار استئناف التشغيل أو رفضه. يمكن للمستخدمين الذين لديهم قائمة انتظار بناء الإذن على البنية الأساسية لبرنامج ربط العمليات التجارية استئناف التشغيل أو رفضه.
أمثلة
jobs:
- job: waitForValidation
displayName: Wait for external validation
pool: server
timeoutInMinutes: 4320 # job times out in 3 days
steps:
- task: ManualValidation@0
timeoutInMinutes: 1440 # task times out in 1 day
inputs:
notifyUsers: |
test@test.com
example@example.com
instructions: 'Please validate the build configuration and resume'
onTimeout: 'resume'
يستخدم timeoutInMinutes
هذا المثال خاصية مهمة شائعة متوفرة في جميع المهام.
المتطلبات
المتطلبات | الوصف |
---|---|
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية | YAML، الإصدار الكلاسيكي |
يعمل على | الخادم |
المطالب | بلا |
القدرات | لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة. |
قيود الأوامر | أي |
متغيرات Settable | أي |
إصدار الوكيل | جميع إصدارات العامل المدعومة. |
فئة المهمة | نشر |