JenkinsQueueJob@2 - مهمة مهمة قائمة انتظار Jenkins v2

استخدم هذه المهمة لوضع مهمة في قائمة الانتظار على خادم Jenkins.

بناء الجملة

# Jenkins queue job v2
# Queue a job on a Jenkins server.
- task: JenkinsQueueJob@2
  inputs:
    serverEndpoint: # string. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #isMultibranchJob: false # boolean. Job is of multibranch pipeline type. Default: false.
    #multibranchPipelineBranch: # string. Required when isMultibranchJob = true. Multibranch pipeline branch. 
    #captureConsole: true # boolean. Capture console output and wait for completion. Default: true.
    #capturePipeline: true # boolean. Optional. Use when captureConsole = true. Capture pipeline output and wait for pipeline completion. Default: true.
  # Advanced
    #isParameterizedJob: false # boolean. Alias: parameterizedJob. Parameterized job. Default: false.
    #jobParameters: # string. Optional. Use when parameterizedJob = true. Job parameters. 
    #failOnUnstableResult: false # boolean. Fail on unstable result. Default: false.
    #retryCount: '3' # string. Number of retries for failed connection. Default: 3.
    #delayBetweenRetries: '60' # string. Time between retries. Default: 60.

الإدخالات

serverEndpoint - اتصال خدمة Jenkins
string. مطلوب

يحدد اتصال الخدمة لمثيل Jenkins الخاص بك. انقر فوق الارتباط Manage لإنشاء اتصال خدمة Jenkins جديد.

jobName - اسم الوظيفة
string. مطلوب

اسم مهمة Jenkins إلى قائمة الانتظار. يجب أن يتطابق هذا تماما مع اسم الوظيفة على خادم Jenkins.

isMultibranchJob - الوظيفة من نوع البنية الأساسية لبرنامج ربط العمليات التجارية متعددة البرانش
boolean. القيمة الافتراضية: false.

هذه الوظيفة هي البنية الأساسية لبرنامج ربط العمليات التجارية متعددة البرانش. إذا تم تحديده، أضف اسم الفرع المناسب. يتطلب هذا الإدخال المكون الإضافي لخادم Team Foundation ل Jenkins v5.3.4 أو أحدث.

multibranchPipelineBranch - فرع البنية الأساسية لبرنامج ربط العمليات التجارية متعددة الفروع
string. مطلوب عند isMultibranchJob = true.

وضع مهمة البنية الأساسية لبرنامج ربط العمليات التجارية متعددة العلامات في قائمة الانتظار على الفرع المحدد. يتطلب هذا الإدخال المكون الإضافي لخادم Team Foundation ل Jenkins v5.3.4 أو أحدث.

captureConsole - التقاط إخراج وحدة التحكم وانتظار الاكتمال
boolean. القيمة الافتراضية: true.

إذا تم تحديده، يلتقط هذا الإدخال إخراج وحدة تحكم بناء Jenkins، وينتظر اكتمال بناء Jenkins، وينجح/يفشل بناء على نتيجة بناء Jenkins. وإلا، بمجرد أن تصطف مهمة Jenkins، تكتمل هذه المهمة بنجاح دون انتظار تشغيل بناء Jenkins.

capturePipeline - التقاط إخراج البنية الأساسية لبرنامج ربط العمليات التجارية وانتظار إكمال البنية الأساسية لبرنامج ربط العمليات التجارية
boolean. ‏‏اختياري. استخدم عندما captureConsole = true. القيمة الافتراضية: true.

إذا تم تحديدها، تلتقط هذه المهمة إخراج وحدة تحكم البنية الأساسية لبرنامج ربط العمليات التجارية لبنية Jenkins الكاملة، وتنتظر اكتمال مسار بناء Jenkins الكامل، وتنجح/تفشل استنادا إلى نتيجة مسار بناء Jenkins. وإلا، بمجرد اكتمال مهمة Jenkins الأولى، تكتمل هذه المهمة بنجاح دون انتظار تشغيل مسار بناء Jenkins الكامل.

isParameterizedJob - مهمة ذات معلمات
الاسم المستعار للإدخل: parameterizedJob. boolean. القيمة الافتراضية: false.

يحدد ما إذا كانت مهمة Jenkins تقبل المعلمات. استخدم هذا الإدخال حتى إذا تم استخدام جميع قيم المعلمات الافتراضية ولم يتم تحديد أي معلمات بالفعل.

jobParameters - معلمات الوظيفة
string. ‏‏اختياري. استخدم عندما parameterizedJob = true.

يحدد معلمات الوظيفة، مع واحد لكل سطر، بتنسيق <parameterName>=<parameterValue>.

لتعيين معلمة إلى قيمة فارغة، وهو أمر مفيد لتجاوز قيمة افتراضية، اترك قيمة المعلمة. على سبيل المثال، حدد parameterName=.

المتغيرات مدعومة. لتعيين قيمة معلمة commitId إلى معرف تثبيت Git للبنية، على سبيل المثال، يمكنك استخدام: commitId=$(Build.SourceVersion). لمزيد من المعلومات، راجع الوثائق المتعلقة بالمتغيرات.

أنواع معلمات Jenkins المدعومة هي:

• Boolean
• Choice
• Password
• String

failOnUnstableResult - فشل على نتيجة غير مستقرة
boolean. القيمة الافتراضية: false.

يحدد صرامة تعريف النجاح، أو ما إذا كان يجب اعتبار عدم الاستقرار فشلا أم لا. false القيمة هي لإصدار غير صارم، وهي true لإصدار صارم. إذا تم تعيينها إلى true، يتم التعامل مع نتيجة بناء غير مستقرة على أنها فشل. وإلا، يتم التعامل مع النتيجة غير المستقرة على أنها نجاح.

retryCount - عدد عمليات إعادة المحاولة لفشل الاتصال
string. القيمة الافتراضية: 3.

يحدد مقدار عمليات إعادة محاولة الاتصال عند حدوث فشل أو خطأ في الاتصال.

delayBetweenRetries - الوقت بين عمليات إعادة المحاولة
string. القيمة الافتراضية: 60.

يحدد مقدار الوقت بين إعادة محاولة الاتصال عند حدوث خطأ. يتم تحديد هذه القيمة بالثوان.

خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

تحدد هذه المهمة متغيرات الإخراج التالية، والتي يمكنك استهلاكها في خطوات انتقال البيانات من الخادم والوظائف والمراحل.

JENKINS_JOB_ID
معرف مثيل مهمة Jenkins في قائمة الانتظار بواسطة هذه المهمة. استخدم هذا المتغير في مهمة Jenkins Download Artifacts لتنزيل البيانات الاصطناعية لمثيل الوظيفة المحدد هذا.

الملاحظات

استخدم هذه المهمة لوضع مهمة في قائمة الانتظار على خادم Jenkins.

المكون الإضافي ل Team Foundation Server

يمكنك استخدام المكون الإضافي ل Team Foundation Server (الإصدار 5.2.0 أو أحدث) لجمع الملفات تلقائيا من مساحة عمل Jenkins وتنزيلها في الإصدار.

لإعداده:

1. قم بتثبيت المكون الإضافي Team Foundation Server على خادم Jenkins.

2. على خادم Jenkins، لكل مهمة ترغب في جمع النتائج منها، أضف إجراء تجميع النتائج ل Azure Pipelines/TFS بعد الإنشاء ثم قم بتكوينه مع زوج واحد أو أكثر من نوع النتيجة وتضمين نمط الملف.

3. في مهمة قائمة انتظار Jenkins، تمكن مهمة الإنشاء إخراج وحدة تحكم الالتقاط وانتظر حتى الاكتمال لجمع النتائج من مهمة مستوى الجذر، أو إخراج مسار الالتقاط وانتظر اكتمال البنية الأساسية لبرنامج ربط العمليات التجارية لجمع النتائج من جميع مهام البنية الأساسية لبرنامج ربط العمليات التجارية.

سيتم تنزيل النتائج إلى $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results.zip واستخراجها إلى هذا الموقع. ستكون كل مجموعة من أنواع النتائج التي تم جمعها بواسطة المكون الإضافي، ضمن دليل نتائج الفريق، $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/. هذا هو الدليل حيث يمكن نشر نتائج البناء بواسطة مهام انتقال البيانات من الخادم (على سبيل المثال، نشر نتائج الاختبار، ونشر نتائج تغطية التعليمات البرمجية).

المتطلبات

المتطلبات	الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية	YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على	Agent, DeploymentGroup
المطالب	بلا
القدرات	لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر	أي
متغيرات Settable	أي
إصدار الوكيل	2.144.0 أو أحدث
فئة المهمة	البنية