DownloadPipelineArtifact@2 - تنزيل مهمة Pipeline Artifacts v2

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

ملاحظة

لمزيد من المعلومات، بما في ذلك أوامر Azure CLI، راجع تنزيل البيانات الاصطناعية.

بناء الجملة

# Download Pipeline Artifacts v2
# Download build and pipeline artifacts.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'current' # 'current' | 'specific'. Alias: source. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when source == specific. Project. 
    #definition: # string. Alias: pipeline. Required when source == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Alias: preferTriggeringPipeline. Optional. Use when source == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Alias: runVersion. Required when source == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Alias: runBranch. Required when source == specific && runVersion == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: runId | buildId. Required when source == specific && runVersion == specific. Build. 
    #tags: # string. Optional. Use when source == specific && runVersion != specific. Build Tags. 
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from partially succeeded builds. Default: false.
    #allowFailedBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from failed builds. Default: false.
    #artifactName: # string. Alias: artifact. Artifact name. 
    #itemPattern: '**' # string. Alias: patterns. Matching patterns. Default: **.
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path | downloadPath. Required. Destination directory. Default: $(Pipeline.Workspace).

الإدخالات

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

تنزيل البيانات الاصطناعية التي ينتجها تشغيل المسار الحالي أو من تشغيل مسار معين.

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

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

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

معرف تعريف البنية الأساسية لبرنامج ربط العمليات التجارية. في البنية الأساسية لبرنامج definitionId ربط العمليات التجارية قيد التشغيل، يمكن العثور عليه في متغير System.DefinitionId . definitionId يمكن أيضا استرداد من عنوان URL في صفحة نظرة عامة على البنية الأساسية لبرنامج ربط العمليات التجارية في مدخل Azure DevOps. في مثال عنوان URL التالي، يكون definitionId هو 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. لتنزيل البيانات الاصطناعية من تعريف مسار معين، قم بالتقاط definitionId من هذا المسار، وحدده كمعلمة pipeline .

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

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

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

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

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

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

pipelineId - بناء
الاسم المستعار للإدخل: runId | buildId. string. مطلوب عند source == specific && runVersion == specific.

يتم تشغيل معرف البنية الأساسية لبرنامج ربط العمليات التجارية لتنزيل البيانات الاصطناعية منه. في البنية الأساسية لبرنامج buildId ربط العمليات التجارية قيد التشغيل، يمكن العثور عليه في متغير Build.BuildId . buildId يمكن أيضا استرداد من عنوان URL في صفحة ملخص تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية في مدخل Azure DevOps. في مثال URL التالي، buildId يكون هو 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. لتنزيل البيانات الاصطناعية من تشغيل مسار معين، قم بالتقاط buildId من هذا التشغيل، وحدده كمعلمة buildId .

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

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

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

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

allowFailedBuilds - قم بتنزيل البيانات الاصطناعية من الإصدارات الفاشلة.
boolean. ‏‏اختياري. استخدم عندما source == specific && runVersion != specific. القيمة الافتراضية: false.

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

artifactName - اسم البيانات الاصطناعية
الاسم المستعار للإدخل: artifact. string.

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

itemPattern - أنماط مطابقة
الاسم المستعار للإدخل: patterns. string. القيمة الافتراضية: **.

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

targetPath - دليل الوجهة
الاسم المستعار للإدخل: path | downloadPath. string. مطلوب القيمة الافتراضية: $(Pipeline.Workspace).

يحدد إما مسارا نسبيا أو مطلقا على جهاز العامل حيث سيتم تنزيل البيانات الاصطناعية. إذا تم تطبيق خيار التنزيل المتعدد (عن طريق ترك اسم بيانات اصطناعية فارغ)، فسيتم إنشاء دليل فرعي لكل تنزيل. تعرف على المزيد حول Artifacts في Azure Pipelines.

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

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

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

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

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

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

تعرف على المزيد حول متغيرات الإنشاء.

الملاحظات

هام

هذه المهمة مدعومة على خدمات Azure DevOps فقط. إذا كنت تستخدمه على Azure DevOps Server، فستتلقى رسالة خطأ مشابهة لاستخدام Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead.تنزيل البيانات الاصطناعية للبناء إذا كنت تستخدم Azure DevOps Server أو TFS 2018.

استخدم هذه المهمة لتنزيل البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية من المراحل السابقة في هذا المسار، أو من مسار آخر. بشكل افتراضي، يتم تنزيل البيانات الاصطناعية إلى $(Pipeline.Workspace). إذا لم تحدد اسم بيانات اصطناعية، فسيتم إنشاء دليل فرعي لكل أداة تم تنزيلها. يمكنك استخدام أنماط مطابقة الملفات للحد من الملفات التي تريد تنزيلها.

الكلمات الأساسية للنشروالتنزيل هي اختصارات المهام لنشروتنزيل البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية.

كيف يمكنني العثور على معرف المسار الذي أريد تنزيل بيانات اصطناعية منه؟

للعثور على definitionId لتعريف مسار معين

في البنية الأساسية لبرنامج ربط العمليات التجارية قيد التشغيل، يمكن العثور على definitionId في متغير System.DefinitionId . definitionId يمكن أيضا استرداد من عنوان URL في صفحة نظرة عامة على البنية الأساسية لبرنامج ربط العمليات التجارية في مدخل Azure DevOps. في مثال عنوان URL التالي، يكون definitionId هو 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. لتنزيل البيانات الاصطناعية من تعريف مسار معين، قم بالتقاط definitionId من هذا المسار، وحدده كمعلمة pipeline .

للعثور على buildId لتشغيل مسار معين

يتم تشغيل معرف البنية الأساسية لبرنامج ربط العمليات التجارية لتنزيل البيانات الاصطناعية منه. في البنية الأساسية لبرنامج buildId ربط العمليات التجارية قيد التشغيل، يمكن العثور عليه في متغير Build.BuildId . buildId يمكن أيضا استرداد من عنوان URL في صفحة ملخص تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية في مدخل Azure DevOps. في مثال URL التالي، buildId يكون هو 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. لتنزيل البيانات الاصطناعية من تشغيل مسار معين، قم بالتقاط buildId من هذا التشغيل، وحدده كمعلمة buildId .

أمثلة

تنزيل أداة معينة

# Download an artifact named 'WebApp' to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin

تنزيل البيانات الاصطناعية من مشروع/مسار معين

# Download artifacts from a specific pipeline.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latest'

تنزيل البيانات الاصطناعية من فرع معين

# Download artifacts from a specific branch with a tag
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latestFromBranch'
    branchName: 'refs/heads/master'
    tags: 'testTag'

تنزيل بيانات اصطناعية من تشغيل بناء معين

# Download an artifact named 'WebApp' from a specific build run to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'specific'
    pipelineId: 40

المتطلبات

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