GitHubRelease@0 - مهمة إصدار GitHub v0

استخدم هذه المهمة لإنشاء إصدار GitHub أو تحريره أو حذفه.

بناء الجملة

# GitHub Release v0
# Create, edit, or delete a GitHub release.
- task: GitHubRelease@0
  inputs:
    gitHubConnection: # string. Required. GitHub connection (OAuth or PAT). 
    repositoryName: '$(Build.Repository.Name)' # string. Required. Repository. Default: $(Build.Repository.Name).
    action: 'create' # 'create' | 'edit' | 'delete'. Required. Action. Default: create.
    #target: '$(Build.SourceVersion)' # string. Required when action = create || action = edit. Target. Default: $(Build.SourceVersion).
    tagSource: 'auto' # 'auto' | 'manual'. Required when action = create. Tag source. Default: auto.
    #tagPattern: # string. Optional. Use when tagSource = auto. Tag Pattern. 
    #tag: # string. Required when action = edit || action = delete || tagSource = manual. Tag. 
    #title: # string. Optional. Use when action = create || action = edit. Release title. 
    #releaseNotesSource: 'file' # 'file' | 'input'. Optional. Use when action = create || action = edit. Release notes source. Default: file.
    #releaseNotesFile: # string. Optional. Use when releaseNotesSource = file. Release notes file path. 
    #releaseNotes: # string. Optional. Use when releaseNotesSource = input. Release notes. 
    #assets: '$(Build.ArtifactStagingDirectory)/*' # string. Optional. Use when action = create || action = edit. Assets. Default: $(Build.ArtifactStagingDirectory)/*.
    #assetUploadMode: 'delete' # 'delete' | 'replace'. Optional. Use when action = edit. Asset upload mode. Default: delete.
    #isDraft: false # boolean. Optional. Use when action = create || action = edit. Draft release. Default: false.
    #isPreRelease: false # boolean. Optional. Use when action = create || action = edit. Pre-release. Default: false.
    #addChangeLog: true # boolean. Optional. Use when action = create || action = edit. Add changelog. Default: true.
  # Changelog configuration
    changeLogCompareToRelease: 'lastFullRelease' # 'lastFullRelease' | 'lastNonDraftRelease' | 'lastNonDraftReleaseByTag'. Required when addChangeLog = true. Compare to. Default: lastFullRelease.
    #changeLogCompareToReleaseTag: # string. Required when changeLogCompareToRelease = lastNonDraftReleaseByTag && addChangeLog = true. Release Tag. 
    changeLogType: 'commitBased' # 'commitBased' | 'issueBased'. Required when addChangeLog = true. Changelog type. Default: commitBased.
    #changeLogLabels: '[{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }]' # string. Optional. Use when changeLogType = issueBased && addChangeLog = true. Categories. Default: [{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }].

الإدخالات

gitHubConnection - اتصال GitHub (OAuth أو PAT)
string. مطلوب

يحدد اسم اتصال خدمة GitHub لاستخدامه للاتصال بمستودع GitHub. يجب أن يستند الاتصال إلى OAuth لمستخدم GitHub أو رمز وصول شخصي GitHub. لمزيد من المعلومات حول اتصالات الخدمة، راجع إدارة اتصالات الخدمة.

repositoryName - مستودع
string. مطلوب القيمة الافتراضية: $(Build.Repository.Name).

يحدد اسم مستودع GitHub حيث ستقوم بإنشاء إصدار GitHub أو تحريره أو حذفه.

action - العمل
string. مطلوب القيم المسموح بها: create، ، editdelete. القيمة الافتراضية: create.

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

target - الهدف
string. مطلوب عند action = create || action = edit. القيمة الافتراضية: $(Build.SourceVersion).

يحدد SHA التثبيت الذي تريد استخدامه لإنشاء إصدار GitHub، على سبيل المثال 48b11d8d6e92a22e3e9563a3f643699c16fd6e27. يمكنك أيضا استخدام متغير، مثل $(myCommitSHA)، في هذا الحقل.

tagSource - مصدر العلامة
string. مطلوب عند action = create. القيم المسموح بها: auto (علامة Git)، manual (العلامة المحددة من قبل المستخدم). القيمة الافتراضية: auto.

يحدد العلامة التي تريد استخدامها لإنشاء الإصدار. auto يستخدم خيار (علامة Git) تلقائيا العلامة المقترنة بتثبيت Git. manual استخدم الخيار (العلامة المحددة من قبل المستخدم) لتوفير علامة يدويا.

tagPattern - نمط العلامة
string. ‏‏اختياري. استخدم عندما tagSource = auto.

يحدد نمط علامة Git باستخدام regex، على سبيل المثال release-v1.*. سيتم إنشاء إصدار GitHub فقط للتثبيتات التي تحتوي على علامة Git مطابقة.

tag - العلامه
string. مطلوب عند action = edit || action = delete || tagSource = manual.

تحديد العلامة التي تريد استخدامها عند إنشاء إصدار أو تحريره أو حذفه. يمكنك أيضا استخدام متغير، مثل $(myTagName)، في هذا الحقل.

title - عنوان الإصدار
string. ‏‏اختياري. استخدم عندما action = create || action = edit.

يحدد عنوان إصدار GitHub. إذا تركت فارغة، فسيتم استخدام العلامة كعنوان الإصدار.

releaseNotesSource - مصدر ملاحظات الإصدار
string. ‏‏اختياري. استخدم عندما action = create || action = edit. القيم المسموح بها: file (ملف ملاحظات الإصدار)، input (ملاحظات الإصدار المضمنة). القيمة الافتراضية: file.

يحدد وصف إصدار GitHub. file استخدم الخيار (ملف ملاحظات الإصدار) لاستخدام محتويات الملف كملاحظات حول الإصدار. input استخدم الخيار (ملاحظات الإصدار المضمنة) لإدخال ملاحظات الإصدار يدويا.

releaseNotesFile - مسار ملف ملاحظات الإصدار
string. ‏‏اختياري. استخدم عندما releaseNotesSource = file.

يحدد الملف الذي يحتوي على ملاحظات الإصدار.

releaseNotes - ملاحظات الإصدار
string. ‏‏اختياري. استخدم عندما releaseNotesSource = input.

يحدد ملاحظات الإصدار. Markdown مدعوم.

assets - الاصول
string. ‏‏اختياري. استخدم عندما action = create || action = edit. القيمة الافتراضية: $(Build.ArtifactStagingDirectory)/*.

يحدد الملفات التي تريد تحميلها كأصول للإصدار. يمكنك استخدام أحرف البدل لتحديد ملفات متعددة. على سبيل المثال، استخدم $(Build.ArtifactStagingDirectory)/*.zip للبنية الأساسية لبرنامج ربط العمليات التجارية للبناء أو الاستخدام $(System.DefaultWorkingDirectory)/*.zip للبنية الأساسية لبرنامج ربط العمليات التجارية للإصدار.

يمكنك أيضا تحديد أنماط متعددة، واحد لكل سطر. بشكل افتراضي، سيتم تحميل جميع الملفات في $(Build.ArtifactStagingDirectory) الدليل. لمزيد من المعلومات حول قائمة المتغيرات المحددة مسبقا المتوفرة، راجع متغيرات الإنشاءومتغيرات الإصدار.

assetUploadMode - وضع تحميل الأصول
string. ‏‏اختياري. استخدم عندما action = edit. القيم المسموح بها: delete (حذف الأصول الم exisiting)، replace (استبدال الأصول الموجودة). القيمة الافتراضية: delete.

يحدد وضع تحميل الأصول الذي تريد استخدامه. delete استخدم الخيار (حذف الأصول الموجودة) لحذف أي أصول موجودة في الإصدار أولا ثم تحميل جميع الأصول. replace استخدم الخيار (استبدال الأصول الموجودة) لاستبدال أي أصول لها نفس الاسم.

isDraft - إصدار المسودة
boolean. ‏‏اختياري. استخدم عندما action = create || action = edit. القيمة الافتراضية: false.

يشير إلى ما إذا كنت تريد حفظ الإصدار كمسودة (غير منشورة). إذا false، سيتم نشر الإصدار.

isPreRelease - ما قبل الإصدار
boolean. ‏‏اختياري. استخدم عندما action = create || action = edit. القيمة الافتراضية: false.

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

addChangeLog - إضافة سجل التغيير
boolean. ‏‏اختياري. استخدم عندما action = create || action = edit. القيمة الافتراضية: true.

يحدد ما إذا كنت تريد تضمين سجل تغيير. إذا تم تعيينها إلى true، فسيتم إنشاء قائمة بالتغييرات (التثبيتات والمشكلات) بين الإصدار الحالي والإصدار الأخير المنشور وإلحاقها بملاحظات الإصدار.

changeLogCompareToRelease - مقارنة ب
string. مطلوب عند addChangeLog = true. القيم المسموح بها: lastFullRelease (الإصدار الكامل الأخير)، lastNonDraftRelease (آخر إصدار غير مسودة)، lastNonDraftReleaseByTag (آخر إصدار غير مسودة حسب العلامة). القيمة الافتراضية: lastFullRelease.

يشير إلى الإصدار الذي يجب مقارنته مع لإنشاء سجل التغيير:

• lastFullRelease (الإصدار الكامل الأخير): يقارن الإصدار الحالي بأحدث إصدار غير مسودة لم يتم وضع علامة عليه على أنه إصدار مسبق.
• lastNonDraftRelease (الإصدار الأخير غير المسودة): يقارن الإصدار الحالي بأحدث إصدار غير مسودة.
• lastNonDraftReleaseByTag (الإصدار الأخير غير المسودة حسب العلامة): يقارن الإصدار الحالي بآخر إصدار غير مسودة يطابق العلامة المحددة. يمكنك أيضا تحديد regex بدلا من علامة دقيقة.

changeLogCompareToReleaseTag - علامة الإصدار
string. مطلوب عند changeLogCompareToRelease = lastNonDraftReleaseByTag && addChangeLog = true.

يحدد regex لعلامة الإصدار. سيتم استخدام إصدار يطابق هذه العلامة كأساس لحساب سجل التغيير.

changeLogType - نوع سجل التغيير
string. مطلوب عند addChangeLog = true. القيم المسموح بها: commitBased (مستندة إلى التثبيت)، issueBased (مستندة إلى المشكلة). القيمة الافتراضية: commitBased.

يحدد نوع سجل التغيير. يمكن أن يكون سجل التغيير مستندا إلى الالتزام أو يستند إلى المشكلة. يسرد سجل التغيير المستند إلى التثبيت جميع التثبيتات المضمنة في الإصدار. يسرد سجل التغيير المستند إلى المشكلة جميع المشكلات أو طلبات السحب (PRs) المضمنة في الإصدار.

changeLogLabels - فئات
string. ‏‏اختياري. استخدم عندما changeLogType = issueBased && addChangeLog = true. القيمة الافتراضية: [{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }].

تصنيف التغييرات استنادا إلى التسمية المقترنة بالقضية أو PR. بالنسبة للتسمية، يمكنك ذكر اسم العرض للفئة وحالة المشكلة. تتضمن أمثلة التسميات ما يلي: "[{ "label" : "bug", "displayName" : "Bugs", "state" : "closed" }]". في الحالات التي يحتوي فيها التغيير على تسميات متعددة، تأخذ التسمية المحددة الأولى الأولوية. اترك هذا الحقل فارغا لرؤية قائمة مسطحة بالمشكلات أو PRs.

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

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

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

لا شيء

الملاحظات

يتوفر إصدار أحدث من هذه المهمة في GitHubRelease@1.

المتطلبات

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