DownloadPipelineArtifact@1 - تنزيل مهمة البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية v1

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

هناك إصدار أحدث من هذه المهمة. لمزيد من المعلومات، راجع DownloadPipelineArtifact@2.

ملاحظة

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

بناء الجملة

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@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.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

الإدخالات

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

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

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

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

pipeline - بناء البنية الأساسية لبرنامج ربط العمليات التجارية
الاسم المستعار للإدخل: definition. string. مطلوب عند buildType == 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 - عند الاقتضاء، قم بتنزيل البيانات الاصطناعية من إنشاء المشغل.
boolean. ‏‏اختياري. استخدم عندما buildType == specific. القيمة الافتراضية: false.

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

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

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

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

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

pipelineId - بناء
الاسم المستعار للإدخل: buildId. string. مطلوب عند buildType == specific && buildVersionToDownload == 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. ‏‏اختياري. استخدم عندما buildType == specific && buildVersionToDownload != specific.

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

artifactName - اسم البيانات الاصطناعية
string.

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

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

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

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

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

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

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

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

لا شيء

الملاحظات

هناك إصدار أحدث من هذه المهمة. لمزيد من المعلومات، راجع DownloadPipelineArtifact@2.

هام

هذه المهمة مدعومة على خدمات 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 .

المتطلبات

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