JenkinsDownloadArtifacts@2 - Jenkins تنزيل القطع الأثرية v2 مهمة

قم بتنزيل البيانات الاصطناعية التي تنتجها وظيفة Jenkins.

إشعار

يستخدم هذا الإصدار من المهمة Azure RBAC للاتصال بتخزين Azure. لمزيد من المعلومات، راجع تكوين Azure RBAC للوصول إلى تخزين Azure.

بناء الجملة

# Jenkins download artifacts v2
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@2
  inputs:
    jenkinsServerConnection: # string. Alias: serverEndpoint. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #jenkinsJobType: # string. Optional. Use when jobName = invalidjobName. Jenkins job type. 
    saveTo: 'jenkinsArtifacts' # string. Required. Save to. Default: jenkinsArtifacts.
  # Advanced
    jenkinsBuild: 'LastSuccessfulBuild' # 'LastSuccessfulBuild' | 'BuildNumber'. Required. Download artifacts produced by. Default: LastSuccessfulBuild.
    #jenkinsBuildNumber: '1' # string. Required when jenkinsBuild == BuildNumber. Jenkins build number. Default: 1.
    #itemPattern: '**' # string. Item Pattern. Default: **.
    #downloadCommitsAndWorkItems: false # boolean. Download Commits and WorkItems. Default: false.
    #startJenkinsBuildNumber: # string. Optional. Use when downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber. Download commits and work items from. 
    #artifactDetailsFileNameSuffix: # string. Optional. Use when downloadCommitsAndWorkItems == invalid. Commit and WorkItem FileName. 
  # Propagated Artifacts
    #propagatedArtifacts: false # boolean. Artifacts are propagated to Azure. Default: false.
    #artifactProvider: 'azureStorage' # 'azureStorage'. Required when propagatedArtifacts == notValid. Artifact Provider. Default: azureStorage.
    #ConnectedServiceNameARM: # string. Required when propagatedArtifacts == true. Azure Subscription. 
    #storageAccountName: # string. Required when propagatedArtifacts == true. Storage Account Name. 
    #containerName: # string. Required when propagatedArtifacts == true. Container Name. 
    #commonVirtualPath: # string. Optional. Use when propagatedArtifacts == true. Common Virtual Path.

المدخلات

اتصال خدمة jenkinsServerConnection - Jenkins
الاسم المستعار للإدخل: serverEndpoint. Person. مطلوب.

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

اسم مهمة jobName -
Person. مطلوب.

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

jenkinsJobType - نوع مهمة Jenkins
Person. اختياري. استخدم عند jobName = invalidjobName.

نوع وظيفة Jenkins ، يتم اكتشافه تلقائيا.

saveTo - حفظ إلى
Person. مطلوب. القيمة الافتراضية: jenkinsArtifacts.

سيتم تنزيل القطع الأثرية Jenkins وحفظها في هذا الدليل. سيتم إنشاء هذا الدليل إذا لم يكن موجودا.

jenkinsBuild - تنزيل البيانات الاصطناعية التي تنتجها
Person. مطلوب. القيم المسموح بها: LastSuccessfulBuild (آخر إصدار ناجح)، BuildNumber (رقم البناء). القيمة الافتراضية: LastSuccessfulBuild.

قم بتنزيل البيانات الاصطناعية التي تم إنتاجها بواسطة آخر إصدار ناجح، أو من مثيل إنشاء معين.

jenkinsBuildNumber - رقم بناء Jenkins
Person. مطلوب عند jenkinsBuild == BuildNumber. القيمة الافتراضية: 1.

قم بتنزيل القطع الأثرية التي ينتجها هذا البنية.

نمط عنصر itemPattern -
Person. القيمة الافتراضية: **.

حدد الملفات المراد تنزيلها كنمط مطابقة مصغرة متعددة الأسطر. المزيد من المعلومات

سيقوم النمط الافتراضي (**) بتنزيل جميع الملفات عبر جميع البيانات الاصطناعية التي تنتجها وظيفة Jenkins. لتنزيل جميع الملفات داخل إسقاط القطع الاصطناعية ، استخدم drop / **.

.

downloadCommitsAndWorkItems - تنزيل التثبيتات و WorkItems
Person. القيمة الافتراضية: false.

تمكين تنزيل التثبيتات وتفاصيل عنصر العمل المقترنة بمهمة Jenkins.

startJenkinsBuildNumber - تنزيل التثبيتات وعناصر العمل من
Person. اختياري. استخدم عند downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber.

رقم إنشاء بدء اختياري لتنزيل الالتزامات وعناصر العمل. إذا تم توفيرها، تنزيل جميع الالتزامات وعناصر العمل بين رقم إنشاء البدء ورقم البنية المعطى كمدخلات لتنزيل البيانات الاصطناعية.

artifactDetailsFileNameSuffix - Commit and WorkItem FileName
Person. اختياري. استخدم عند downloadCommitsAndWorkItems == invalid.

لاحقة اسم الملف الاختيارية للالتزامات ومرفقات عناصر العمل. سيتم إنشاء المرفقات باستخدام commits_{suffix}.json و workitem_{suffix}.json. إذا لم يتم توفير هذا الإدخال، إنشاء مرفقات بالاسم commits.json و workitems.json.

يتم نشر propagatedArtifacts - Artifacts إلى Azure
Person. القيمة الافتراضية: false.

تحقق من ذلك إذا تم نشر عناصر Jenkins إلى Azure. لتحميل عناصر Jenkins إلى azure، ارجع إلى هذا المكون الإضافي Jenkins.

موفر البيانات الاصطناعية artifactProvider -
Person. مطلوب عند propagatedArtifacts == notValid. القيم المسموح بها: azureStorage (Azure Storage). القيمة الافتراضية: azureStorage.

اختر موفر التخزين الخارجي المستخدم في وظيفة Jenkins لتحميل البيانات الاصطناعية.

ConnectedServiceNameARM - اشتراك Azure
Person. مطلوب عند propagatedArtifacts == true.

اختر اشتراك Azure Resource Manager للعناصر الاصطناعية.

إشعار

يستخدم هذا الإصدار من المهمة Azure RBAC للاتصال بتخزين Azure. لمزيد من المعلومات، راجع تكوين Azure RBAC للوصول إلى تخزين Azure.

اسم حساب تخزين storageAccountName -
Person. مطلوب عند propagatedArtifacts == true.

يتم سرد حسابات Azure Classic وResource Manager. حدد اسم حساب التخزين الذي يتم نشر البيانات الاصطناعية فيه.

اسم حاوية containerName -
Person. مطلوب عند propagatedArtifacts == true.

اسم الحاوية في حساب التخزين الذي يتم تحميل البيانات الاصطناعية إليه.

commonVirtualPath - المسار الظاهري الشائع
Person. اختياري. استخدم عند propagatedArtifacts == true.

المسار إلى البيانات الاصطناعية داخل حاوية تخزين Azure.

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

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

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

لا شيء.

ملاحظات

تكوين Azure RBAC للوصول إلى تخزين Azure

يستخدم هذا الإصدار من المهمة اتصال خدمة Azure Resource Manager الذي تم تكوينه باستخدام اتحاد هوية حمل العمل وAzure RBAC للاتصال بتخزين Azure بدلا من مفاتيح حساب التخزين أو توقيعات الوصول المشتركة (SAS). للاتصال بتخزين Azure من هذه المهمة، يجب عليك تعيين دور Storage Blob Data Contributor على حساب التخزين إلى هوية اتصال الخدمة الذي تم تكوينه ل ConnectedServiceNameARM. لمزيد من المعلومات، راجع تعيين دور Azure للوصول إلى بيانات الكائن الثنائي كبير الحجم وخطوات تعيين دور.

المتطلبات

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