UniversalPackages@0 - مهمة الحزم العالمية v0

استخدم هذه المهمة لتنزيل الحزم العالمية أو حزمها ونشرها.

بناء الجملة

# Universal packages v0
# Download or publish Universal Packages.
- task: UniversalPackages@0
  inputs:
    command: 'download' # 'download' | 'publish'. Required. Command. Default: download.
    downloadDirectory: '$(System.DefaultWorkingDirectory)' # string. Required when command = download. Destination directory. Default: $(System.DefaultWorkingDirectory).
    #publishDirectory: '$(Build.ArtifactStagingDirectory)' # string. Required when command = publish. Path to file(s) to publish. Default: $(Build.ArtifactStagingDirectory).
  # Feed & package details
    feedsToUse: 'internal' # 'internal' | 'external'. Alias: internalOrExternalDownload. Required when command = download. Feed location. Default: internal.
    #externalFeedCredentials: # string. Alias: externalEndpoint. Optional. Use when internalOrExternalDownload = external && command = download. organization/collection connection. 
    #vstsFeed: # string. Alias: feedListDownload. Required when internalOrExternalDownload = internal && command = download. Feed. 
    #vstsFeedPackage: # string. Alias: packageListDownload. Required when internalOrExternalDownload = internal && command = download. Package name. 
    #vstsPackageVersion: # string. Alias: versionListDownload. Required when internalOrExternalDownload = internal && command = download. Version. 
    #feedDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Feed (or Project/Feed if the feed was created in a project). 
    #packageDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Package name. 
    #versionDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Version. 
  # Feed & package details
    #feedsToUsePublish: 'internal' # 'internal' | 'external'. Alias: internalOrExternalPublish. Required when command = publish. Feed location. Default: internal.
    #publishFeedCredentials: # string. Alias: externalEndpoints. Required when internalOrExternalPublish = external && command = publish. organization/collection connection. 
    #vstsFeedPublish: # string. Alias: feedListPublish. Required when internalOrExternalPublish = internal && command = publish. Destination Feed. 
    #vstsFeedPackagePublish: # string. Alias: packageListPublish. Required when internalOrExternalPublish = internal && command = publish. Package name. 
    #feedPublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Feed (or Project/Feed if the feed was created in a project). 
    #packagePublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Package name. 
    #versionOption: 'patch' # 'major' | 'minor' | 'patch' | 'custom'. Alias: versionPublishSelector. Required when command = publish. Version. Default: patch.
    #versionPublish: # string. Required when versionPublishSelector = custom && command = publish. Custom version. 
    #packagePublishDescription: # string. Optional. Use when command = publish. Description. 
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && internalOrExternalPublish = internal. Publish pipeline metadata. Default: true.
    #verbosity: 'None' # 'None' | 'Trace' | 'Debug' | 'Information' | 'Warning' | 'Error' | 'Critical'. Verbosity. Default: None.
  # Output
    #publishedPackageVar: # string. Optional. Use when command = publish. Package Output Variable.

الإدخالات

command - الامر
string. مطلوب القيم المسموح بها: download، . publish القيمة الافتراضية: download.

يحدد الأمر NuGet لتشغيله.

downloadDirectory - دليل الوجهة
string. مطلوب عند command = download. القيمة الافتراضية: $(System.DefaultWorkingDirectory).

يحدد مسار المجلد حيث تقوم المهمة بتنزيل محتويات الحزمة.

feedsToUse - موقع الموجز
الاسم المستعار للإدخل: internalOrExternalDownload. string. مطلوب عند command = download. القيم المسموح بها: internal (هذه المؤسسة/المجموعة)، external (مؤسسة/مجموعة أخرى). القيمة الافتراضية: internal.

يحدد موجزا من هذه المجموعة أو مجموعة أخرى في Azure Artifacts.

externalFeedCredentials - اتصال المؤسسة/المجموعة
الاسم المستعار للإدخل: externalEndpoint. string. ‏‏اختياري. استخدم عندما internalOrExternalDownload = external && command = download.

يحدد بيانات الاعتماد التي يجب استخدامها للسجلات الخارجية الموجودة في المحدد NuGet.config. بالنسبة إلى الموجزات في هذه المؤسسة أو المجموعة، اترك هذا فارغا؛ يتم استخدام بيانات اعتماد البنية تلقائيا.

vstsFeed - موجز ويب
الاسم المستعار للإدخل: feedListDownload. string. مطلوب عند internalOrExternalDownload = internal && command = download.

يتضمن الموجز المحدد. يجب أن يكون لديك Azure Artifacts مثبتة ومرخصة لتحديد موجز هنا. يحدد FeedName لموجز نطاق المؤسسة وprojectName/FeedName أو ProjectID/FeedID لموجز نطاق المشروع.

vstsFeedPackage - اسم الحزمة
الاسم المستعار للإدخل: packageListDownload. string. مطلوب عند internalOrExternalDownload = internal && command = download.

يحدد اسم الحزمة للمهمة المراد تنزيلها.

vstsPackageVersion - الإصدار
الاسم المستعار للإدخل: versionListDownload. string. مطلوب عند internalOrExternalDownload = internal && command = download.

يحدد إصدار الحزمة أو يستخدم متغيرا يحتوي على الإصدار المراد تنزيله. يمكن أن يكون هذا الإدخال أيضا تعبير حرف بدل، مثل *، للحصول على أعلى إصدار. أمثلة: 1.* يحصل على أعلى إصدار مع الإصدار الرئيسي 1، ويحصل 1.2.* على أعلى إصدار تصحيح مع الإصدار الرئيسي 1 والإصدار الثانوي 2.

feedDownloadExternal - موجز (أو Project/Feed إذا تم إنشاء الموجز في مشروع)
string. مطلوب عند internalOrExternalDownload = external && command = download.

يحدد موجزا في مؤسسة/مجموعة أخرى.

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

packageDownloadExternal - اسم الحزمة
string. مطلوب عند internalOrExternalDownload = external && command = download.

يحدد اسم الحزمة المراد تنزيله.

versionDownloadExternal - الإصدار
string. مطلوب عند internalOrExternalDownload = external && command = download.

يحدد إصدار الحزمة أو يستخدم متغيرا يحتوي على الإصدار المراد تنزيله. يمكن أن يكون هذا الإدخال أيضا تعبير حرف بدل، مثل *، للحصول على أعلى إصدار. أمثلة: 1.* يحصل على أعلى إصدار مع الإصدار الرئيسي 1، ويحصل 1.2.* على أعلى إصدار تصحيح مع الإصدار الرئيسي 1 والإصدار الثانوي 2. أنماط أحرف البدل غير مدعومة مع حزم ما قبل الإصدار.

publishDirectory - المسار إلى ملف (ملفات) للنشر
string. مطلوب عند command = publish. القيمة الافتراضية: $(Build.ArtifactStagingDirectory).

يحدد المسار إلى قائمة الملفات التي سيتم نشرها.

feedsToUsePublish - موقع الموجز
الاسم المستعار للإدخل: internalOrExternalPublish. string. مطلوب عند command = publish. القيم المسموح بها: internal (هذه المؤسسة/المجموعة)، external (مؤسسة/مجموعة أخرى). القيمة الافتراضية: internal.

يحدد موجزا من هذه المجموعة أو مجموعة أخرى في Azure Artifacts.

publishFeedCredentials - اتصال المؤسسة/المجموعة
الاسم المستعار للإدخل: externalEndpoints. string. مطلوب عند internalOrExternalPublish = external && command = publish.

يحدد بيانات الاعتماد لاستخدامها في الموجزات الخارجية.

vstsFeedPublish - موجز الوجهة
الاسم المستعار للإدخل: feedListPublish. string. مطلوب عند internalOrExternalPublish = internal && command = publish.

يحدد المشروع واسم/GUID الخاص بالموجز للنشر إليه.

publishPackageMetadata - نشر بيانات تعريف البنية الأساسية لبرنامج ربط العمليات التجارية
boolean. ‏‏اختياري. استخدم عندما command = publish && internalOrExternalPublish = internal. القيمة الافتراضية: true.

يربط بيانات تعريف البنية/الإصدار هذه (مثل تشغيل # ومعلومات التعليمات البرمجية المصدر) بالحزمة.

vstsFeedPackagePublish - اسم الحزمة
الاسم المستعار للإدخل: packageListPublish. string. مطلوب عند internalOrExternalPublish = internal && command = publish.

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

feedPublishExternal - موجز (أو Project/Feed إذا تم إنشاء الموجز في مشروع)
string. مطلوب عند internalOrExternalPublish = external && command = publish.

يحدد اسم الموجز الخارجي للنشر إليه.

إذا تم إنشاء الموجز في مشروع، يجب أن تكون Project/Feedالقيمة ، حيث Project هو اسم المشروع أو معرفه، وهو Feed اسم الموجز. إذا لم يتم إنشاء الموجز في مشروع، يجب أن تكون القيمة اسم الموجز فقط.

packagePublishExternal - اسم الحزمة
string. مطلوب عند internalOrExternalPublish = external && command = publish.

يحدد اسم الحزمة عند النشر إلى موجز خارجي.

versionOption - الإصدار
الاسم المستعار للإدخل: versionPublishSelector. string. مطلوب عند command = publish. القيم المسموح بها: major (الرئيسي التالي)، minor (الثانوي التالي)، patch (التصحيح التالي)، custom. القيمة الافتراضية: patch.

يحدد استراتيجية زيادة الإصدار. custom قيمة إدخال إصدار الحزمة يدويا. بالنسبة للحزم الجديدة، سيكون الإصدار الأول 1.0.0 إذا حددت major، أو 0.1.0 إذا حددت minor، أو 0.0.1 إذا قمت بتحديد patch. راجع مواصفات تعيين الإصدار الدلالي لمزيد من المعلومات.

versionPublish - إصدار مخصص
string. مطلوب عند versionPublishSelector = custom && command = publish.

يحدد مخطط إصدار مخصص للحزمة.

packagePublishDescription - وصف
string. ‏‏اختياري. استخدم عندما command = publish.

يحدد وصف محتويات الحزمة و/أو التغييرات التي تم إجراؤها في هذا الإصدار من الحزمة.

verbosity - الاسهاب
string. القيم المسموح بها: None، Trace، Debug، Information، Warning، ، Error. Critical القيمة الافتراضية: None.

يحدد مقدار التفاصيل المعروضة في الإخراج.

publishedPackageVar - متغير إخراج الحزمة
string. ‏‏اختياري. استخدم عندما command = publish.

يحدد اسما للمتغير الذي سيحتوي على اسم الحزمة المنشورة والإصدار.

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

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

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

لا شيء

الملاحظات

استخدم هذه المهمة لتنزيل الحزم العالمية أو حزمها ونشرها.

يحتاج المسار الخاص بي إلى الوصول إلى موجز في مشروع مختلف

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

أمثلة

أبسط طريقة للبدء في مهمة الحزمة العالمية هي استخدام محرر مهام البنية الأساسية لبرنامج ربط العمليات التجارية لإنشاء YAML. يمكنك بعد ذلك نسخ التعليمات البرمجية التي تم إنشاؤها في ملف مشروعك azure-pipelines.yml . في هذا المثال، يوضح النموذج كيفية إنشاء YAML بسرعة باستخدام البنية الأساسية لبرنامج ربط العمليات التجارية التي تنشئ تطبيق ويب تدريجي GatsbyJS (PWA).

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

يوضح مسار المثال هذا كيفية إحضار أداة من موجز داخل مشروعك. تستخدم مهمة Universal Package لتنزيل الأداة وتشغيل بنية، وتستخدم مرة أخرى مهمة Universal Package لنشر GatsbyJS PWA المجمع بالكامل إلى موجز كحزمة عالمية تم إصدارها.

تنزيل حزمة مع مهمة الحزمة العالمية

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

1. أضف مهمة Universal Package بالنقر فوق أيقونة علامة الجمع، وكتابة "universal" في مربع البحث، والنقر فوق الزر Add لإضافة المهمة إلى البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك.

   

2. انقر فوق مهمة Universal Package المضافة حديثا والأمر إلى .Download

3. اختر الدليل الوجهة لاستخدامه لتنزيل الأداة.

4. حدد موجز مصدر يحتوي على الأداة، وقم بتعيين اسم الحزمة، واختر إصدار أداة imagemagick من موجز المصدر.

   

5. بعد إكمال الحقول، انقر فوق عرض YAML لمشاهدة YAML الذي تم إنشاؤه.

   

6. ينشئ منشئ مهام الحزمة العالمية YAML مبسطا يحتوي على قيم غير افتراضية. انسخ YAML الذي تم إنشاؤه في الملف الخاص بك azure-pipelines.yml في جذر مستودع git الخاص بمشروعك.

   # Download Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal download'
     inputs:
       downloadDirectory: Application
       vstsFeed: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000001'
       vstsFeedPackage: imagemagick
       vstsPackageVersion: 1.0.0
   

نشر حزمة مع مهمة الحزمة العالمية

تستخدم الخطوة الأخيرة في نموذج البنية الأساسية لبرنامج ربط العمليات التجارية هذه مهمة الحزمة العالمية لتحميل Gatsby PWA الجاهز للإنتاج الذي تم إنتاجه بواسطة Run gatsby build الخطوة إلى موجز كحزمة عالمية تم إصدارها. بمجرد دخولك إلى الموجز، لديك نسخة دائمة من موقعك الكامل التي يمكن نشرها إلى موفر الاستضافة والبدء باستخدام gatsby serve.

1. أضف مهمة حزمة عالمية أخرى إلى نهاية البنية الأساسية لبرنامج ربط العمليات التجارية بالنقر فوق أيقونة علامة الجمع، وكتابة "universal" في مربع البحث، والنقر فوق الزر Add لإضافة المهمة إلى البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك. تجمع هذه المهمة جميع الأصول الجاهزة للإنتاج التي تنتجها Run gatsby build الخطوة، وتنتج حزمة عالمية تم إصدارها، وتنشر الحزمة إلى موجز.

   

2. قم بتعيين الأمر إلى Publish.

3. قم بتعيين المسار إلى ملف (ملفات) للنشر إلى الدليل الذي يحتوي على مشروع package.jsonGatsbyJS الخاص بك.

4. اختر موجز الوجهة واسم الحزمة وقم بتعيين استراتيجية تعيين الإصدار.

   

5. بعد إكمال الحقول المطلوبة، انقر فوق عرض YAML.

6. انسخ YAML الناتج في ملفك azure-pipelines.yml كما كان من قبل. يتم عرض YAML لهذا المشروع النموذجي أدناه.

   # Publish Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal publish'
     inputs:
       command: publish
       publishDirectory: Application
       vstsFeedPublish: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000002' # You can also use '<projectName>/<feedName>' instead of the GUIDs
       vstsFeedPackagePublish: mygatsbysite
       packagePublishDescription: 'A test package'
   

يوضح هذا المثال كيفية استخدام منشئ مهام البنية الأساسية لبرنامج ربط العمليات التجارية لإنشاء YAML بسرعة لمهمة الحزمة العالمية، والتي يمكن وضعها بعد ذلك في الملف الخاص بك azure-pipelines.yml . يدعم منشئ مهام الحزمة العالمية جميع التكوينات المتقدمة التي يمكن إنشاؤها باستخدام وسيطات مهمة الحزمة العالمية .

ملاحظة

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

المتطلبات

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