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

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

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

ملاحظة

قم بتعطيل مصادقة IIS الأساسية إذا كنت تستخدم Azure DevOps Server للسماح بالمصادقة باستخدام الرمز المميز للوصول الشخصي. راجع مصادقة IIS الأساسية وPATs لمزيد من التفاصيل.

بناء الجملة

# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
  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.
    #retryRedirectDownloadCount: '0' # string. Retry count for redirect download. Default: 0.
    #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.

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.

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

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

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

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

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

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

.

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

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

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

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

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

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

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

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

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

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

retryRedirectDownloadCount - عدد مرات إعادة المحاولة لتنزيل إعادة التوجيه
string. القيمة الافتراضية: 0.

عدد المرات الاختيارية لإعادة محاولة تنزيل أداة بناء إذا فشل التنزيل استنادا إلى إعادة التوجيه. إذا كانت شبكتك لا تسمح باتباع إعادة التوجيه، يمكنك تعيين هذا إلى -1 لتنزيل الاستجابة المتدفقة دائما من Azure DevOps بدلا من ذلك.

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

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

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

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

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

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

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

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

المتطلبات

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