DownloadPipelineArtifact@1 - تنزيل مهمة البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية v1
استخدم هذه المهمة لتنزيل البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية من المراحل السابقة في هذا المسار، أو من مسار آخر.
هناك إصدار أحدث من هذه المهمة. لمزيد من المعلومات، راجع DownloadPipelineArtifact@2.
ملاحظة
لمزيد من المعلومات، بما في ذلك أوامر Azure CLI، راجع تنزيل البيانات الاصطناعية.
استخدم هذه المهمة لتنزيل البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية من المراحل السابقة في هذا المسار، أو من مسار آخر.
هام
هذه المهمة مدعومة على خدمات 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.
بناء الجملة
# 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).
# Download Pipeline Artifacts v1
# Download Pipeline Artifact.
- 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 أو أحدث |
فئة المهمة | الأداة المساعدة |
المتطلبات | الوصف |
---|---|
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية | YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي |
يعمل على | Agent, DeploymentGroup |
المطالب | بلا |
القدرات | لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة. |
قيود الأوامر | أي |
متغيرات Settable | أي |
إصدار الوكيل | 2.150.3 أو أحدث |
فئة المهمة | الأداة المساعدة |
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ