PublishPipelineArtifact@1 - نشر مهمة Pipeline Artifacts v1

استخدم هذه المهمة لنشر (تحميل) ملف أو دليل كقطعة اصطناعية مسماة للتشغيل الحالي.

بناء الجملة

# Publish Pipeline Artifacts v1
# Publish (upload) a file or directory as a named artifact for the current run.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path. Required. File or directory path. Default: $(Pipeline.Workspace).
    #artifact: # string. Alias: artifactName. Artifact name. 
    publishLocation: 'pipeline' # 'pipeline' | 'filepath'. Alias: artifactType. Required. Artifact publish location. Default: pipeline.
    #fileSharePath: # string. Required when artifactType = filepath. File share path. 
    #parallel: false # boolean. Optional. Use when artifactType = filepath. Parallel copy. Default: false.
    #parallelCount: '8' # string. Optional. Use when artifactType = filepath && parallel = true. Parallel count. Default: 8.
    #properties: # string. Custom properties.

الإدخالات

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

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

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

يحدد اسم الأداة المراد نشرها. يمكن أن يكون أي اسم تختاره، على سبيل المثال drop. إذا لم يتم تعيينه، فإن الافتراضي هو معرف فريد تم تحديد نطاقه للمهمة.

هام

لا يمكن أن يحتوي اسم البيانات الاصطناعية على \أو /أو "أو :أو <أو >|*.?

publishLocation - موقع نشر البيانات الاصطناعية
الاسم المستعار للإدخل: artifactType. string. مطلوب القيم المسموح بها: pipeline (Azure Pipelines)، filepath (مشاركة ملف). القيمة الافتراضية: pipeline.

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

fileSharePath - مسار مشاركة الملف
string. مطلوب عند artifactType = filepath.

تحديد مشاركة الملف حيث يتم نسخ ملفات البيانات الاصطناعية. يمكن أن يتضمن ذلك متغيرات، على سبيل المثال \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber). نشر البيانات الاصطناعية من عامل Linux أو macOS إلى مشاركة ملف غير مدعوم، على سبيل المثال \\server\folderName.

parallel - نسخة متوازية
boolean. ‏‏اختياري. استخدم عندما artifactType = filepath. القيمة الافتراضية: false.

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

parallelCount - العدد المتوازي
string. ‏‏اختياري. استخدم عندما artifactType = filepath && parallel = true. القيمة الافتراضية: 8.

يحدد درجة التوازي، أو عدد مؤشرات الترابط المستخدمة، لتنفيذ النسخة. يجب أن تكون القيمة بين 1 و128.

properties - خصائص مخصصة
string.

يحدد الخصائص المخصصة لإقرانها بالبيانات الاصطناعية. استخدم سلسلة JSON صالحة مع البادئة user- على جميع المفاتيح.

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

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

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

لا شيء

الملاحظات

النشر غير مدعوم في مسارات الإصدار الكلاسيكية.

ملاحظة

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

publish الكلمات الأساسية و download هي اختصارات للمهام PublishPipelineArtifact@1 DownloadPipelineArtifact@2. راجع steps.publish and steps.download لمزيد من التفاصيل.

تلميح

يمكنك استخدام ملف .artifactignore للتحكم في الملفات التي سيتم نشرها.

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

لتمكين السجلات التفصيلية للبنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك:

1. تحرير البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك وتحديد المتغيرات
2. إضافة متغير جديد بالاسم System.Debug والقيمة true
3. حفظ

ما المتغيرات المتوفرة لي؟

ج: $(Build.SourcesDirectory) وهي $(Agent.BuildDirectory) مجرد عدد قليل من المتغيرات التي يمكنك استخدامها في البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك. تتوفر المتغيرات كتعبيرات أو برامج نصية.

راجع تعريف المتغيراتوالمتغيرات المحددة مسبقاومتغيرات الإصدار والبيانات الاصطناعية الكلاسيكية للتعرف على الأنواع المختلفة من المتغيرات.

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

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

المتطلبات

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

راجع أيضًا

• هل تتطلع إلى البدء في إنشاء البيانات الاصطناعية؟ راجع البيانات الاصطناعية في Azure Pipelines.