مشاركة عبر

Update-ServiceFabricClusterUpgrade

  • ‏‏المرجع
الوحدة النمطية:
ServiceFabric

تعديل وصف الترقية لترقية نظام المجموعة النشطة.

بناء الجملة

Update-ServiceFabricClusterUpgrade
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-MaxPercentUnhealthyApplications <Byte>]
      [-MaxPercentUnhealthyNodes <Byte>]
      [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
      [-EnableDeltaHealthEvaluation <Boolean>]
      [-MaxPercentDeltaUnhealthyNodes <Byte>]
      [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
      [-Force]
      [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

الوصف

يقوم Update-ServiceFabricClusterUpgrade cmdlet بتعديل معلمات وصف ترقية نظام المجموعة بينما لا تزال الترقية نشطة. يكتشف Service Fabric التغييرات ويطبقها وفقا لقيمة FabricUpgradeStatusPollInterval ، كما هو محدد في بيان نظام المجموعة. باستثناء نهج تقييم السلامة، يقوم cmdlet هذا بتحديث المعلمات التي تحددها فقط. لا تزال المعلمات غير المحددة غير متأثرة. يجب تحديث نهج تقييم السلامة التالية معا، وليس بشكل فردي:

  • ConsiderWarningAsError
  • MaxPercentUnhealthyApplications
  • MaxPercentUnhealthyNodes

لإدارة مجموعات Service Fabric، ابدأ Windows PowerShell باستخدام الخيار تشغيل كمسؤول. قبل إجراء أي عملية على مجموعة Service Fabric، قم بإنشاء اتصال بالمجموعة باستخدام Connect-ServiceFabricCluster cmdlet.

أمثلة

مثال 1: تحديث قيمة لترقية نظام المجموعة

PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0

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

مثال 2: تحديث نهج الحماية لترقية نظام المجموعة

PS C:\> $svcType = New-Object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
PS C:\> $svcType.MaxPercentUnhealthyPartitionsPerService = 100
PS C:\> $systemAppPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
PS C:\> $systemAppPolicy.DefaultServiceTypeHealthPolicy = $svcType
PS C:\> $appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
PS C:\> $appHealthPolicyMap.Add("fabric:/System", $systemAppPolicy)

PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)

PS C:\> Update-ServiceFabricClusterUpgrade -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -Force -MaxPercentUnhealthyApplications 20 -ApplicationHealthPolicyMap $appHealthPolicyMap

يغير هذا الأمر نهج حماية نظام مجموعة ترقية نظام المجموعة. يحدد مخطط نهج حماية نوع التطبيق الذي يحتوي على نوع التطبيق CriticalAppType، والذي لا يتسامح مع أي حالات فشل. يتم تقييم بقية التطبيقات باستخدام 20٪ كحد أقصى غير صحي.

يحدث الأمر أيضا نهج صحة التطبيق المستخدم لتقييم تطبيق fabric:/System كجزء من تقييم صحة ترقية نظام المجموعة. تتسامح النهج الجديدة مع جميع أخطاء القسم.

المعلمات

-ApplicationHealthPolicyMap

يحدد System.Fabric.Health.ApplicationHealthPolicyMap الذي يتضمن نهج صحية مخصصة لبعض التطبيقات أو كلها. إذا لم تحدد هذه المعلمة، أو إذا لم تقم بتضمين إدخال في الخريطة لأحد التطبيقات، فسيتم تقييم هذا التطبيق باستخدام نهج حماية التطبيق المحدد في بيان التطبيق إذا كان موجودا، أو النهج الافتراضي بخلاف ذلك.

Type:ApplicationHealthPolicyMap
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeHealthPolicyMap

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

على سبيل المثال، إذا كانت بعض التطبيقات من نوع ما مهمة، يمكن لمسؤول نظام المجموعة إضافة إدخال إلى الخريطة لنوع التطبيق هذا وتعيين قيمة 0٪ (أي، لا تتسامح مع أي حالات فشل). يمكن تقييم جميع التطبيقات الأخرى مع تعيين MaxPercentUnhealthyApplications إلى 20٪ لتحمل بعض حالات الفشل من آلاف مثيلات التطبيق.

يتم استخدام مخطط نهج صحة نوع التطبيق فقط إذا كان بيان نظام المجموعة يتيح تقييم صحة نوع التطبيق باستخدام إدخال التكوين ل HealthManager/EnableApplicationTypeHealthEvaluation.

Type:ApplicationTypeHealthPolicyMap
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

يطالبك بالتأكيد قبل تشغيل cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConsiderWarningAsError

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableDeltaHealthEvaluation

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailureAction

تحديد الإجراء الذي يجب اتخاذه إذا فشلت الترقية المراقبة. القيم المقبولة لهذه المعلمة هي:

  • العودة إلى الحالة السابقة
  • يدوي.
Type:UpgradeFailureAction
Accepted values:Invalid, Rollback, Manual
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

يشير إلى أن cmdlet هذا يتخطى رسالة التحذير ويجبر التحديث.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceRestart

يشير إلى ما إذا كان يجب إعادة تشغيل عقدة Service Fabric حتى إذا تغيرت التكوينات الديناميكية فقط.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HealthCheckRetryTimeoutSec

تحديد المدة، بالثوان، التي بعد ذلك يعيد Service Fabric محاولة التحقق من الصحة إذا فشل فحص الصحة السابق.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HealthCheckStableDurationSec

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HealthCheckWaitDurationSec

يحدد المدة، بالثوان، التي ينتظرها Service Fabric قبل إجراء فحص السلامة الأولي بعد الانتهاء من الترقية على مجال الترقية.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceCloseDelayDurationSec

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentDeltaUnhealthyNodes

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

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyApplications

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

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyNodes

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

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

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

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NodeTypeHealthPolicyMap

تعريف خريطة ذات النسب المئوية القصوى للعقد غير السليمة لنوع معين من العقد.

يمكن استخدام مخطط نهج السلامة لنوع العقدة أثناء تقييم سلامة نظام المجموعة لوصف أنواع العقد الخاصة. يتم تقييم أنواع العقد المضمنة في الخريطة مقابل النسبة المئوية المضمنة في الخريطة، وأيضا مع العمومي (راجع System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). يتم أيضا حساب عقد أنواع العقد المحددة في الخريطة مقابل التجمع العمومي للعقد؛ إنها فحوصات مستقلة.

Type:NodeTypeHealthPolicyMap
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

تحديد فترة المهلة، بالثوان، للعملية.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeDomainTimeoutSec

يحدد الحد الأقصى للوقت، بالثوان، الذي يستغرقه Service Fabric لترقية مجال ترقية واحد. بعد هذه الفترة، تفشل الترقية.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeMode

تحديد UpgradeMode الجديد للترقية.

Type:RollingUpgradeMode
Accepted values:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeReplicaSetCheckTimeoutSec

يحدد الحد الأقصى للوقت، بالثوان، الذي ينتظره Service Fabric لمجموعة نسخ متماثلة لإعادة تكوينها في حالة آمنة، إذا لم تكن في حالة آمنة بالفعل، قبل أن يستمر Service Fabric في الترقية.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeTimeoutSec

يحدد الحد الأقصى للوقت، بالثوان، الذي يستغرقه Service Fabric للترقية بأكملها. بعد هذه الفترة، تفشل الترقية.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

تعرض ما سيحدث عند تشغيل الأمر cmdlet. لم يتم تشغيل cmdlet.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

الإدخالات

None

المخرجات

System.Object