ServiceFabricDeploy@1 - مهمة نشر تطبيق Service Fabric v1

استخدم هذه المهمة لنشر تطبيق Service Fabric إلى نظام مجموعة. تنشر هذه المهمة تطبيق Azure Service Fabric إلى نظام مجموعة وفقا للإعدادات المحددة في ملف تعريف النشر.

ملاحظة

لا تدعم هذه المهمة مصادقة Azure Resource Manager مع اتحاد هوية سير العمل.

بناء الجملة

# Service Fabric application deployment v1
# Deploy an Azure Service Fabric application to a cluster.
- task: ServiceFabricDeploy@1
  inputs:
    applicationPackagePath: # string. Required. Application Package. 
    serviceConnectionName: # string. Required. Cluster Service Connection. 
    #publishProfilePath: # string. Publish Profile. 
    #applicationParameterPath: # string. Application Parameters. 
    #overrideApplicationParameter: false # boolean. Override Application Parameters. Default: false.
  # Advanced Settings
    #compressPackage: false # boolean. Compress Package. Default: false.
    #copyPackageTimeoutSec: # string. CopyPackageTimeoutSec. 
    #registerPackageTimeoutSec: # string. RegisterPackageTimeoutSec. 
    overwriteBehavior: 'SameAppTypeAndVersion' # 'Always' | 'Never' | 'SameAppTypeAndVersion'. Required. Overwrite Behavior. Default: SameAppTypeAndVersion.
    #skipUpgradeSameTypeAndVersion: false # boolean. Skip upgrade for same Type and Version. Default: false.
    #skipPackageValidation: false # boolean. Skip package validation. Default: false.
  # Upgrade Settings
    #useDiffPackage: false # boolean. Use Diff Package. Default: false.
    #overridePublishProfileSettings: false # boolean. Override All Publish Profile Upgrade Settings. Default: false.
    #isUpgrade: true # boolean. Optional. Use when overridePublishProfileSettings = true. Upgrade the Application. Default: true.
    #unregisterUnusedVersions: true # boolean. Unregister Unused Versions. Default: true.
    #upgradeMode: 'Monitored' # 'Monitored' | 'UnmonitoredAuto' | 'UnmonitoredManual'. Required when overridePublishProfileSettings = true && isUpgrade = true. Upgrade Mode. Default: Monitored.
    #FailureAction: 'Rollback' # 'Rollback' | 'Manual'. Required when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. FailureAction. Default: Rollback.
    #UpgradeReplicaSetCheckTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. UpgradeReplicaSetCheckTimeoutSec. 
    #TimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. TimeoutSec. 
    #ForceRestart: false # boolean. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. ForceRestart. Default: false.
    #HealthCheckRetryTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckRetryTimeoutSec. 
    #HealthCheckWaitDurationSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckWaitDurationSec. 
    #HealthCheckStableDurationSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckStableDurationSec. 
    #UpgradeDomainTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. UpgradeDomainTimeoutSec. 
    #ConsiderWarningAsError: false # boolean. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. ConsiderWarningAsError. Default: false.
    #DefaultServiceTypeHealthPolicy: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. DefaultServiceTypeHealthPolicy. 
    #MaxPercentUnhealthyDeployedApplications: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. MaxPercentUnhealthyDeployedApplications. 
    #UpgradeTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. UpgradeTimeoutSec. 
    #ServiceTypeHealthPolicyMap: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. ServiceTypeHealthPolicyMap. 
  # Docker Settings
    #configureDockerSettings: false # boolean. Configure Docker settings. Default: false.
    #registryCredentials: 'AzureResourceManagerEndpoint' # 'AzureResourceManagerEndpoint' | 'ContainerRegistryEndpoint' | 'UsernamePassword'. Required when configureDockerSettings = true. Registry Credentials Source. Default: AzureResourceManagerEndpoint.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Required when configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint. Docker Registry Service Connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint. Azure subscription. 
    #registryUserName: # string. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Registry User Name. 
    #registryPassword: # string. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Registry Password. 
    #passwordEncrypted: true # boolean. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Password Encrypted. Default: true.

الإدخالات

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

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

serviceConnectionName - اتصال خدمة نظام المجموعة
string. مطلوب

يحدد اتصال خدمة Azure Service Fabric لاستخدامه للاتصال بنظام المجموعة. تتجاوز الإعدادات المحددة في اتصال الخدمة المشار إليه هذه الإعدادات المحددة في ملف تعريف النشر. اختر Manage تسجيل اتصال خدمة جديد.

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

publishProfilePath - نشر ملف التعريف
string.

‏‏اختياري. يحدد المسار إلى ملف تعريف النشر الذي يحدد الإعدادات التي يجب استخدامها. يمكن استخدام المتغيرات وأحرف البدل في المسار. تعرف على المزيد حول كيفية إنشاء ملفات تعريف النشر في Visual Studio.

applicationParameterPath - معلمات التطبيق
string.

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

overrideApplicationParameter - تجاوز معلمات التطبيق
boolean. القيمة الافتراضية: false.

‏‏اختياري. يحدد المتغيرات المحددة في البنية الأساسية لبرنامج ربط العمليات التجارية للإنشاء أو الإصدار التي تتم مطابقتها مع Parameter Name الإدخالات في ملف بيان التطبيق. تعرف على المزيد حول كيفية إنشاء ملف معلمات تطبيق في Visual Studio. مثال:

 <Parameters> 
 <Parameter Name="SampleApp_PartitionCount" Value="1" /> 
 <Parameter Name="SampleApp_InstanceCount" DefaultValue="-1" /> 
 </Parameters>

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

ملاحظة

إذا تم تعريف نفس المتغيرات في مسار الإصدار وفي البيئة، فستستبدل متغيرات البيئة متغيرات مسار الإصدار.

compressPackage - ضغط الحزمة
boolean. القيمة الافتراضية: false.

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

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

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

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

‏‏اختياري. يحدد المهلة بالثوان لتسجيل حزمة تطبيق أو إلغاء تسجيلها.

overwriteBehavior - الكتابة فوق السلوك
string. مطلوب القيم المسموح بها: Always، ، Never. SameAppTypeAndVersion القيمة الافتراضية: SameAppTypeAndVersion.

الكتابة فوق السلوك إذا كان هناك تطبيق موجود في نظام المجموعة بنفس الاسم ولم يتم تكوين الترقيات.

Never لن يزيل التطبيق الموجود. هذا هو السلوك الافتراضي.

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

SameAppTypeAndVersion سيزيل التطبيق الحالي فقط إذا كان نوع التطبيق وإصداره هو نفس التطبيق الذي يتم إنشاؤه.

skipUpgradeSameTypeAndVersion - تخطي الترقية لنفس النوع والإصدار
boolean. القيمة الافتراضية: false.

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

skipPackageValidation - تخطي التحقق من صحة الحزمة
boolean. القيمة الافتراضية: false.

‏‏اختياري. يحدد ما إذا كان يجب التحقق من صحة الحزمة أم لا قبل التوزيع. تعرف على المزيد حول التحقق من صحة الحزمة.

useDiffPackage - استخدام حزمة Diff
boolean. القيمة الافتراضية: false.

‏‏اختياري. الترقيات باستخدام حزمة diff التي تحتوي فقط على ملفات التطبيق المحدثة وبيان التطبيق المحدث وملفات بيان الخدمة.

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

overridePublishProfileSettings - تجاوز كافة إعدادات ترقية ملف تعريف النشر
boolean. القيمة الافتراضية: false.

‏‏اختياري. يتجاوز جميع إعدادات الترقية بالقيم المحددة أو القيمة الافتراضية (إذا لم يتم تحديدها). تعرف على المزيد حول إعدادات الترقية.

isUpgrade - ترقية التطبيق
boolean. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true. القيمة الافتراضية: true.

الكتابة فوق التطبيق إذا تم تعيين القيمة إلى false.

unregisterUnusedVersions - إلغاء تسجيل الإصدارات غير المستخدمة
boolean. القيمة الافتراضية: true.

‏‏اختياري. يشير إلى ما إذا كانت ستتم إزالة جميع الإصدارات غير المستخدمة من نوع التطبيق بعد الترقية.

upgradeMode - وضع الترقية
string. مطلوب عند overridePublishProfileSettings = true && isUpgrade = true. القيم المسموح بها: Monitored، ، UnmonitoredAuto. UnmonitoredManual القيمة الافتراضية: Monitored.

FailureAction - فشلAction
string. مطلوب عند overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. القيم المسموح بها: Rollback، . Manual القيمة الافتراضية: Rollback.

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec
string. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - TimeoutSec
string. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true. القيمة الافتراضية: false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec
string. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - النظر فيWarningAsError
boolean. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. القيمة الافتراضية: false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy
string. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications
string. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec
string. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. ‏‏اختياري. استخدم عندما overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

configureDockerSettings - تكوين إعدادات Docker
boolean. القيمة الافتراضية: false.

تكوين التطبيق باستخدام إعدادات Docker المحددة.

registryCredentials - مصدر بيانات اعتماد السجل
string. مطلوب عند configureDockerSettings = true. القيم المسموح بها: AzureResourceManagerEndpoint (Azure Resource Manager Service Connection)، ContainerRegistryEndpoint (Container Registry Service Connection)، UsernamePassword (Username and Password). القيمة الافتراضية: AzureResourceManagerEndpoint.

يحدد كيفية توفير بيانات الاعتماد لسجل Docker.

dockerRegistryConnection - اتصال خدمة سجل Docker
الاسم المستعار للإدخل: dockerRegistryEndpoint. string. مطلوب عند configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

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

ملاحظة

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

azureSubscription - اشتراك Azure
الاسم المستعار للإدخل: azureSubscriptionEndpoint. string. مطلوب عند configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint.

يحدد اشتراك Azure.

ملاحظة

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

registryUserName - اسم مستخدم التسجيل
string. ‏‏اختياري. استخدم عندما configureDockerSettings = true && registryCredentials = UsernamePassword.

يحدد اسم المستخدم لسجل Docker.

registryPassword - كلمة مرور السجل
string. ‏‏اختياري. استخدم عندما configureDockerSettings = true && registryCredentials = UsernamePassword.

يحدد كلمة المرور لسجل Docker. إذا لم تكن كلمة المرور مشفرة، فيجب عليك استخدام متغير سر مسار إصدار مخصص لتخزينها.

passwordEncrypted - كلمة المرور المشفرة
boolean. ‏‏اختياري. استخدم عندما configureDockerSettings = true && registryCredentials = UsernamePassword. القيمة الافتراضية: true.

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

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

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

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

لا شيء

الملاحظات

استخدم هذه المهمة لنشر تطبيق Service Fabric إلى نظام مجموعة. تنشر هذه المهمة تطبيق Azure Service Fabric إلى نظام مجموعة وفقا للإعدادات المحددة في ملف تعريف النشر.

Service Fabric

تستخدم هذه المهمة تثبيت Service Fabric للاتصال بنظام مجموعة Service Fabric ونشره. قم بتنزيل Service Fabric وتثبيته على عامل الإنشاء.

المتطلبات

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