PublishBuildArtifacts@1 - نشر البيانات الاصطناعية للبنية v1 المهمة

مقالة
07/02/2024

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

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

بناء الجملة

# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
    ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
    publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
    #MaxArtifactSize: '0' # string. Max Artifact Size. Default: 0.
    #TargetPath: # 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.
  # Advanced
    #StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.

# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
    ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
    publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
    #TargetPath: # 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.
  # Advanced
    #FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options. 
    #StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.

# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
    ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
    publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
    #TargetPath: # 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.
  # Advanced
    #FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options.

# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
    ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
    publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
    #TargetPath: # 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.

# Publish Build Artifacts v1
# Publish build artifacts to Azure Pipelines/TFS or a file share.
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
    ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
    publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
    #TargetPath: # 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.

الإدخالات

PathtoPublish - مسار النشر
string. مطلوب القيمة الافتراضية: $(Build.ArtifactStagingDirectory).

يحدد المجلد أو مسار الملف المراد نشره. يمكن أن يكون هذا مسارا مؤهلا بالكامل أو مسارا بالنسبة لجذر المستودع. لا تُدعم الأحرف البديلة. المتغيرات مدعومة. مثال:$(Build.ArtifactStagingDirectory). لمزيد من المعلومات، راجع البيانات الاصطناعية في البنية الأساسية لبرنامج ربط العمليات التجارية - نظرة عامة.

ArtifactName - اسم البيانات الاصطناعية
string. مطلوب القيمة الافتراضية: drop.

يحدد اسم البيانات الاصطناعية المراد إنشاؤها في موقع النشر. الأحرف الخاصة التالية غير مسموح بها: +، ، %، {}

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

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

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

MaxArtifactSize - الحد الأقصى لحجم البيانات الاصطناعية
string. القيمة الافتراضية: 0.

الحد الأقصى لحجم البيانات الاصطناعية التي سيتم نشرها بالبايت. ضع 0 إذا كنت لا تريد تعيين أي حد.

TargetPath - مسار مشاركة الملف
string. مطلوب عند ArtifactType = FilePath.

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

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

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

ParallelCount - العدد المتوازي
string. ‏‏اختياري. استخدم عندما ArtifactType = FilePath && Parallel = true. القيمة الافتراضية: 8.

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

StoreAsTar - قم بتصنين البيانات الاصطناعية قبل التحميل
boolean. القيمة الافتراضية: false.

إضافة كافة الملفات من مسار النشر إلى أرشيف tar قبل التحميل. يسمح لك هذا بالاحتفاظ بأذونات ملف UNIX. استخدم extractTars خيار مهمةDownloadBuildArtifacts لاستخراج العناصر التي تم تنزيلها تلقائيا. يتم تجاهل هذا الإعداد على وكلاء Windows.

FileCopyOptions - خيارات نسخ الملف
string. ‏‏اختياري. استخدم عندما ArtifactType = FilePath.

يمرر خيارات إضافية إلى أمر Robocopy. على سبيل المثال، نمط **/*المطابقة المصغرة المتكررة .

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

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

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

لا شيء

الملاحظات

ملاحظة

لا يمكنك استخدام أسماء المجلداتApp_Data والمجلدات الأخرى المحجوزة بواسطة IIS كاسم بيانات اصطناعية لأن هذا المحتوى لا يتم تقديمه استجابة لطلبات ويب. يرجى مراجعة ASP.NET Web Project Folder Structure لمزيد من التفاصيل.

أمثلة

steps:
- task: CopyFiles@2
  inputs:
    contents: '_buildOutput/**'
    targetFolder: $(Build.ArtifactStagingDirectory)
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: $(Build.ArtifactStagingDirectory)
    artifactName: MyBuildOutputs

المتطلبات

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

راجع أيضًا

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

مشاركة عبر

PublishBuildArtifacts@1 - نشر البيانات الاصطناعية للبنية v1 المهمة

بناء الجملة

الإدخالات

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

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

الملاحظات

أمثلة

المتطلبات

راجع أيضًا

الملاحظات

الموارد الإضافية