مشاركة عبر

ServiceFabricUpdateManifests@2 - تحديث مهمة بيانات Service Fabric v2

  • مقالة

استخدم هذه المهمة في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء لتحديث إصدارات تطبيق Service Fabric المجمع تلقائيا. تلحق هذه المهمة لاحقة إصدار بجميع إصدارات الخدمة والتطبيق، المحددة في ملفات البيان، في حزمة تطبيق Azure Service Fabric.

بناء الجملة

# Update Service Fabric manifests v2
# Automatically update portions of application and service manifests in a packaged Azure Service Fabric application.
- task: ServiceFabricUpdateManifests@2
  inputs:
    updateType: 'Manifest versions' # 'Manifest versions' | 'Docker image settings'. Required. Update Type. Default: Manifest versions.
    applicationPackagePath: # string. Required. Application Package. 
    #versionSuffix: '.$(Build.BuildNumber)' # string. Required when updateType = Manifest versions. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Optional. Use when updateType = Manifest versions. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Optional. Use when updateType = Manifest versions. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when updateType = Manifest versions && compareType = Specific. Build Number. 
    #overwriteExistingPkgArtifact: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Overwrite Existing Package Artifact. Default: true.
    #imageNamesPath: # string. Optional. Use when updateType = Docker image settings. Image Names Path. 
    #imageDigestsPath: # string. Required when updateType = Docker image settings. Image Digests Path.

# Update Service Fabric Manifests v2
# Automatically updates portions of the application and service manifests within a packaged Service Fabric application.
- task: ServiceFabricUpdateManifests@2
  inputs:
    updateType: 'Manifest versions' # 'Manifest versions' | 'Docker image settings'. Required. Update Type. Default: Manifest versions.
    applicationPackagePath: # string. Required. Application Package. 
    #versionSuffix: '.$(Build.BuildNumber)' # string. Required when updateType = Manifest versions. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Optional. Use when updateType = Manifest versions. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Optional. Use when updateType = Manifest versions. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when updateType = Manifest versions && compareType = Specific. Build Number. 
    #overwriteExistingPkgArtifact: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Overwrite Existing Package Artifact. Default: true.
    #imageNamesPath: # string. Optional. Use when updateType = Docker image settings. Image Names Path. 
    #imageDigestsPath: # string. Required when updateType = Docker image settings. Image Digests Path.

الإدخالات

updateType - نوع التحديث
string. مطلوب القيم المسموح بها: Manifest versions، . Docker image settings القيمة الافتراضية: Manifest versions.

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


applicationPackagePath - حزمة التطبيق
string. مطلوب

يحدد المسار إلى حزمة التطبيق. يمكن استخدام المتغيرات وأحرف البدل في المسار. applicationPackagePath يجب ألا يكون لديك شرطة مائلة لاحقة، إما \ أو /.


versionSuffix - قيمة الإصدار
string. مطلوب عند updateType = Manifest versions. القيمة الافتراضية: .$(Build.BuildNumber).

يحدد الإصدار في ملفات البيان.

تلميح

يمكنك تعديل تنسيق رقم البناء مباشرة أو استخدام أمر تسجيل لتعيين متغير ديناميكيا بتنسيق. على سبيل المثال، يمكنك استخدام $(VersionSuffix) المعرفة في مهمة PowerShell:

$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"
Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"

versionBehavior - سلوك الإصدار
string. ‏‏اختياري. استخدم عندما updateType = Manifest versions. القيم المسموح بها: Append، . Replace القيمة الافتراضية: Append.

يحدد ما إذا كنت تريد إلحاق قيمة الإصدار بالقيم الموجودة في ملفات البيان أو استبدالها.


updateOnlyChanged - التحديث فقط إذا تم تغييره
boolean. ‏‏اختياري. استخدم عندما updateType = Manifest versions. القيمة الافتراضية: false.

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

ملاحظة

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


pkgArtifactName - اسم البيانات الاصطناعية للحزمة
string. ‏‏اختياري. استخدم عندما updateType = Manifest versions && updateOnlyChanged = true.

يحدد اسم الأداة التي تحتوي على حزمة التطبيق للمقارنة.


logAllChanges - تسجيل جميع التغييرات
boolean. ‏‏اختياري. استخدم عندما updateType = Manifest versions && updateOnlyChanged = true. القيمة الافتراضية: true.

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


compareType - مقارنة مقابل
string. ‏‏اختياري. استخدم عندما updateType = Manifest versions && updateOnlyChanged = true. القيم المسموح بها: LastSuccessful (الإصدار الناجح الأخير)، Specific (إنشاء محدد). القيمة الافتراضية: LastSuccessful.

يحدد ما إذا كنت تريد المقارنة مع آخر بناء مكتمل وناجح أو مقابل بناء معين.


buildNumber - رقم الإنشاء
string. ‏‏اختياري. استخدم عندما updateType = Manifest versions && compareType = Specific.

يحدد رقم البناء للمقارنة.


overwriteExistingPkgArtifact - الكتابة فوق البيانات الاصطناعية للحزمة الموجودة
boolean. ‏‏اختياري. استخدم عندما updateType = Manifest versions && updateOnlyChanged = true. القيمة الافتراضية: true.

تنزيل نسخة جديدة من البيانات الاصطناعية. وإلا، يستخدم هذا المنطقي نسخة موجودة إذا كانت موجودة.


imageNamesPath - مسار أسماء الصور
string. ‏‏اختياري. استخدم عندما updateType = Docker image settings.

يحدد المسار إلى ملف نصي يحتوي على أسماء صور Docker المقترنة بتطبيق Service Fabric التي يجب تحديثها بملخصات. يجب أن يكون كل اسم صورة على السطر الخاص به ويجب أن يكون بنفس ترتيب الملخصات في ملف Image Digests. إذا تم إنشاء الصور بواسطة مشروع Service Fabric، يتم إنشاء هذا الملف كجزء من هدف الحزمة، ويتم التحكم في موقع الإخراج الخاص به بواسطة الخاصية BuiltDockerImagesFilePath.


imageDigestsPath - مسار ملخصات الصور
string. مطلوب عند updateType = Docker image settings.

يحدد المسار إلى ملف نصي يحتوي على قيم ملخص صور Docker المقترنة بتطبيق Service Fabric. يمكن إخراج هذا الملف بواسطة مهمة Docker عند استخدام إجراء الدفع. يجب أن يحتوي الملف على أسطر من النص بتنسيق registry/image_name@digest_value.


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

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

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

لا شيء

الملاحظات

استخدم هذه المهمة في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء لتحديث إصدارات تطبيق Service Fabric المجمع تلقائيا. تلحق هذه المهمة لاحقة إصدار بجميع إصدارات الخدمة والتطبيق، المحددة في ملفات البيان، في حزمة تطبيق Azure Service Fabric.

ملاحظة

تتطلب هذه المهمة Windows PowerShell.

هذه المهمة غير متوفرة في مسارات الإصدار .

يمكن استخدام هذه المهمة فقط في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء لتحديث إصدارات تطبيق Service Fabric المجمع تلقائيا.

تدعم هذه المهمة نوعين من التحديثات:

  1. إصدار البيان: التحديثات إصدارات الخدمة والتطبيق المحددة في ملفات البيان في حزمة تطبيق Service fabric. إذا تم تحديده، manifest version يقارن الملفات الحالية بنسخة سابقة ويحدث الإصدار فقط لتلك الخدمات التي تم تغييرها.

  2. إعدادات صورة Docker: التحديثات إعدادات صورة حاوية docker المحددة في ملفات البيان في حزمة تطبيق Service fabric. يتم اختيار إعدادات الصورة التي سيتم وضعها من ملفين:

    أ. ملف أسماء الصور: يتم إنشاء هذا الملف بواسطة مهمة الإنشاء.

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

أمثلة

المتطلبات

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