DownloadBuildArtifacts@1 - تنزيل مهمة إنشاء البيانات الاصطناعية v1

استخدم هذه المهمة لتنزيل الملفات التي تم حفظها كقطع أثرية لبنية مكتملة.

إذا كنت تستخدم خدمات Azure DevOps، نوصي باستخدام تنزيل البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية ونشر البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية للحصول على أداء أسرع.

بناء الجملة

# Download build artifacts v1
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@1
  inputs:
    buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when buildType == specific. Project. 
    #pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
    artifactName: # string. Required when downloadType == single. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
    #cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
    #checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
    #retryDownloadCount: '4' # string. Retry count. Default: 4.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

الإدخالات

buildType - تنزيل البيانات الاصطناعية التي تنتجها
string. مطلوب القيم المسموح بها: current (البنية الحالية)، specific (بنية محددة). القيمة الافتراضية: current.

ما إذا كنت تريد تنزيل البيانات الاصطناعية التي تنتجها البنية الحالية أو من بنية معينة.

project - المشروع
string. مطلوب عند buildType == specific.

المشروع الذي سيتم تنزيل البيانات الاصطناعية للبناء منه.

pipeline - بناء البنية الأساسية لبرنامج ربط العمليات التجارية
الاسم المستعار للإدخل: definition. string. مطلوب عند buildType == specific.

يحدد اسم البنية الأساسية لبرنامج ربط العمليات التجارية للبناء.

specificBuildWithTriggering - عند الاقتضاء، قم بتنزيل البيانات الاصطناعية من إنشاء المشغل.
boolean. ‏‏اختياري. استخدم عندما buildType == specific. القيمة الافتراضية: false.

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

buildVersionToDownload - إنشاء إصدار للتنزيل
string. مطلوب عند buildType == specific. القيم المسموح بها: latest، latestFromBranch (الأحدث من فرع معين وعلامات البناء المحددة)، specific (إصدار محدد). القيمة الافتراضية: latest.

يحدد إصدار البنية المراد تنزيله.

• اختر latest تنزيل أحدث إصدار من الإصدارات المتوفرة.
• اختر latestFromBranch تنزيل أحدث إصدار من الإصدار المتوفر من الفرع المحدد بواسطة branchName والعلامات المحددة بواسطة tags.
• اختر specific تنزيل إصدار البناء المحدد بواسطة buildId.

allowPartiallySucceededBuilds - قم بتنزيل البيانات الاصطناعية حتى من الإصدارات الناجحة جزئيا.
boolean. ‏‏اختياري. استخدم عندما buildType == specific && buildVersionToDownload != specific. القيمة الافتراضية: false.

إذا true، تحاول مهمة الإنشاء هذه تنزيل البيانات الاصطناعية سواء نجحت البنية أو نجحت جزئيا.

branchName - اسم الفرع
string. مطلوب عند buildType == specific && buildVersionToDownload == latestFromBranch. القيمة الافتراضية: refs/heads/master.

يحدد ما إذا كنت تريد التصفية على اسم الفرع/ref، على سبيل المثال: refs/heads/develop.

buildId - بناء
string. مطلوب عند buildType == specific && buildVersionToDownload == specific.

البنية التي تريد تنزيل البيانات الاصطناعية منها.

tags - إنشاء العلامات
string. ‏‏اختياري. استخدم عندما buildType == specific && buildVersionToDownload != specific.

قائمة علامات محددة بفواصل. يتم إرجاع البنيات التي تحتوي على هذه العلامات فقط.

downloadType - نوع التنزيل
string. مطلوب القيم المسموح بها: single (بيانات اصطناعية محددة)، specific (ملفات محددة). القيمة الافتراضية: single.

تنزيل بيانات اصطناعية معينة أو ملفات معينة من البنية.

• اختر single (أداة محددة) عندما تريد تحديد أداة محددة واحدة فقط بواسطة artifactName
• اختر specific (ملفات محددة) عندما تريد جميع البيانات الاصطناعية للبنية المحددة

artifactName - اسم البيانات الاصطناعية
string. مطلوب عند downloadType == single.

اسم الأداة المراد تنزيلها.

itemPattern - نمط مطابق
string. القيمة الافتراضية: **.

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

يقوم النمط \*\* الافتراضي بتنزيل جميع الملفات عبر جميع البيانات الاصطناعية في البنية إذا اخترت خيار الملفات المحددة . لتنزيل جميع الملفات داخل إسقاط البيانات الاصطناعية، استخدم drop/**.

downloadPath - دليل الوجهة
string. مطلوب القيمة الافتراضية: $(System.ArtifactsDirectory).

المسار على جهاز العامل حيث يتم تنزيل البيانات الاصطناعية.

cleanDestinationFolder - تنظيف مجلد الوجهة
boolean. القيمة الافتراضية: false.

احذف جميع الملفات الموجودة في المجلد الوجهة قبل تنزيل البيانات الاصطناعية.

parallelizationLimit - حد التوازي
string. القيمة الافتراضية: 8.

عدد الملفات المراد تنزيلها في وقت واحد.

checkDownloadedFiles - التحقق من الملفات التي تم تنزيلها
boolean. القيمة الافتراضية: false.

إذا true، تتحقق مهمة الإنشاء هذه من تنزيل جميع الملفات بالكامل.

retryDownloadCount - عدد مرات إعادة المحاولة
string. القيمة الافتراضية: 4.

عدد مرات إعادة محاولة تنزيل أداة بناء إذا فشل التنزيل.

extractTars - استخراج جميع الملفات المخزنة داخل أرشيفات tar
boolean.

اضبط على true لاستخراج جميع الملفات التي تم تنزيلها التي تحتوي على ملحق .tar . هذا مفيد لأنك تحتاج إلى حزم ملفات البيانات الاصطناعية الخاصة بك في tar إذا كنت تريد الاحتفاظ بأذونات ملف Unix. StoreAsTar سيؤدي تمكين الخيار في مهمة Publish build artifacts إلى تخزين البيانات الاصطناعية كملفات .tar تلقائيا.

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

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

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

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

BuildNumber
يخزن رقم بناء مصدر البيانات الاصطناعية للبنية.

يرجى ملاحظة أن هذا الإدخال يرجع BuildId بسبب التوافق مع الإصدارات السابقة. لمزيد من المعلومات، راجع المتغيرات.

الملاحظات

ملاحظة

يوصي فريق Azure Pipelines بالترقية من البيانات الاصطناعية للإنشاء إلى البنية الأساسية لبرنامج ربط العمليات التجارية للحصول على أداء أسرع.

المتطلبات

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