Update-ServiceFabricClusterUpgrade

  • Başvuru
Modül:
ServiceFabric

Etkin küme yükseltmesinin yükseltme açıklamasını değiştirir.

Sözdizimi

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>]

Description

Update-ServiceFabricClusterUpgrade cmdlet'i, yükseltme hala etkinken küme yükseltme açıklamasının parametrelerini değiştirir. Service Fabric, değişiklikleri küme bildiriminde belirtildiği gibi FabricUpgradeStatusPollInterval değerine göre algılar ve uygular. Sistem durumu değerlendirme ilkeleri dışında, bu cmdlet yalnızca belirttiğiniz parametreleri güncelleştirir. Belirtilmemiş parametreler etkilenmez. Aşağıdaki sistem durumu değerlendirme ilkelerini ayrı ayrı değil birlikte güncelleştirmeniz gerekir:

  • ConsiderWarningAsError
  • MaxPercentUnhealthyApplications
  • MaxPercentUnhealthyNodes

Service Fabric kümelerini yönetmek için Yönetici olarak çalıştır seçeneğini kullanarak Windows PowerShell'i başlatın. Service Fabric kümesinde herhangi bir işlem yapmadan önce, Connect-ServiceFabricCluster cmdlet'ini kullanarak kümeyle bağlantı kurun.

Örnekler

Örnek 1: Küme yükseltmesi için bir değeri güncelleştirme

PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0

Bu komut, bekleyen bir küme yükseltmesi için çoğaltma kümesi denetim zaman aşımı süresini 0 olarak ayarlar. Güncelleştirme, diğer tüm yükseltme değerlerini tek başına bırakır.

Örnek 2: Küme yükseltmesi için sistem durumu ilkesini güncelleştirme

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

Bu komut, küme yükseltme kümesi sistem durumu ilkesini değiştirir. Hiçbir hataya tolerans göstermeyen CriticalAppType uygulama türünü içeren uygulama türü sistem durumu ilkesi eşlemesini belirtir. Uygulamaların geri kalanı, en fazla iyi durumda olmayan yüzde 20% kullanılarak değerlendirilir.

Komut, küme yükseltme sistem durumu değerlendirmesinin bir parçası olarak fabric:/System uygulamasını değerlendirmek için kullanılan uygulama sistem durumu ilkesini de güncelleştirir. Yeni ilkeler tüm bölüm hatalarını tolere eder.

Parametreler

-ApplicationHealthPolicyMap

Uygulamaların bazıları veya tümü için özel sistem durumu ilkeleri içeren bir System.Fabric.Health.ApplicationHealthPolicyMap belirtir. Bu parametreyi belirtmezseniz veya bir uygulamanın eşlemesine bir giriş eklemezseniz, söz konusu uygulama varsa uygulama bildiriminde tanımlanan uygulama sistem durumu ilkesiyle veya varsa varsayılan ilkeyle değerlendirilir.

Tür:ApplicationHealthPolicyMap
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ApplicationTypeHealthPolicyMap

Uygulama türü başına izin verilen en yüksek iyi durumda olmayan uygulama yüzdesini tanımlayan eşlemeyi belirtir. Bu eşlemedeki uygulama türleri genel MaxPercentUnhealthyApplications yüzdesi yerine belirli yüzdeler kullanılarak değerlendirilir.

Örneğin, bir türdeki bazı uygulamalar kritikse, küme yöneticisi söz konusu uygulama türü için eşlemeye bir giriş ekleyebilir ve 0% değeri atayabilir (başka bir ifadeyle herhangi bir hataya izin verme). Diğer tüm uygulamalar MaxPercentUnhealthyApplications ile değerlendirilebilir binlerce uygulama örneğinden bazı hataları tolere etmek için 20% olarak ayarlanabilir.

Uygulama türü sistem durumu ilkesi eşlemesi yalnızca küme bildirimi HealthManager/EnableApplicationTypeHealthEvaluationiçin yapılandırma girdisini kullanarak uygulama türü sistem durumu değerlendirmesini etkinleştirirse kullanılır.

Tür:ApplicationTypeHealthPolicyMap
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ConsiderWarningAsError

Sistem durumu değerlendirmesi sırasında bir uyarı sistem durumu raporunun hata olarak ele alıp almayacağını gösterir.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-EnableDeltaHealthEvaluation

İzlenen yükseltmelerde sistem durumu değerlendirmesi sırasında delta sistem durumu denetimlerinin etkinleştirilip etkinleştirilmeymeyeceğini gösterir. $True değerini belirtirseniz, Service Fabric yükseltmenin başında sistem durumunun anlık görüntüsünü alır. Her yükseltme etki alanı yükseltmeyi tamamladıktan sonra sistem durumu denetimleri kümenin geçerli durumunu anlık görüntüyle karşılaştırır. Geçerli küme yükseltme sistem durumu ilkesinden izin verilen en yüksek yüzde değerlerine saygı duymayan sistem durumu düşüşü varsa, sistem durumu denetimleri başarısız olur.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-FailureAction

İzlenen yükseltme başarısız olursa gerçekleştirecek eylemi belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

  • Geri alma
  • El ile.
Tür:UpgradeFailureAction
Kabul edilen değerler:Invalid, Rollback, Manual
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

Bu cmdlet'in uyarı iletisini atlayıp güncelleştirmeyi zorladığını gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ForceRestart

Yalnızca dinamik yapılandırmalar değişmiş olsa bile Service Fabric düğümünü yeniden başlatıp başlatmayacağını gösterir.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HealthCheckRetryTimeoutSec

Service Fabric'in önceki sistem durumu denetiminin başarısız olup olmadığını yeniden deneme süresini saniye cinsinden belirtir.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HealthCheckStableDurationSec

Service Fabric'in kümenin sonraki yükseltme etki alanına devam etmeden veya yükseltmeyi tamamlamadan önce kararlı olduğunu doğrulamak için bekleyeceği süreyi saniye cinsinden belirtir. Bu bekleme süresi, sistem durumu denetimi gerçekleştirildikten hemen sonra algılanmayan sistem durumu değişikliklerini engeller.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HealthCheckWaitDurationSec

Service Fabric'in yükseltme etki alanındaki yükseltmeyi tamamladıktan sonra ilk sistem durumu denetimini gerçekleştirmeden önce bekleyeceği süreyi saniye cinsinden belirtir.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-InstanceCloseDelayDurationSec

Etkin isteklerin düzgün bir şekilde boşaltılabilmesi için küme yükseltmeden etkilenen durum bilgisi olmayan bir örneğin kapatılması için beklenmesi gereken süreyi saniye cinsinden belirtir. Bu bekleme süresi yalnızca InstanceCloseDelayDuration için sıfır olmayan bir değer yapılandırılmış olan durum bilgisi olmayan hizmetlerin örnekleri için geçerlidir ve önceden yapılandırılmış değeri geçersiz kılar. Ayrıntılar için bkz. InstanceCloseDelayDuration.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaxPercentDeltaUnhealthyNodes

Hatanın toplam sistem durumu durumlarına sahip olabilecek delta iyi durumda olmayan düğümlerin en yüksek tolere edilen yüzdesini belirtir. Geçerli iyi durumda olmayan düğümler yükseltmenin başındaki duruma göre yüzdeye saygı göstermiyorsa küme iyi durumda değildir.

Tür:Byte
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaxPercentUnhealthyApplications

Hatanın toplam sistem durumu olabilecek uygulamaların en yüksek tolere edilen yüzdesini belirtir. Yükseltme bu yüzdeyi aşarsa küme iyi durumda değildir.

Tür:Byte
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaxPercentUnhealthyNodes

Toplu hata durumlarına sahip olabilecek düğümlerin tolere edilen en yüksek yüzdesini belirtir. Yükseltme bu yüzdeyi aşarsa küme iyi durumda değildir.

Tür:Byte
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Toplu sistem durumu hataya sahip olabilecek yükseltme etki alanı deltası iyi durumda olmayan düğümlerin en yüksek tolere edilen yüzdesini belirtir. Geçerli iyi durumda olmayan düğümlerin yükseltmenin başındaki duruma göre yüzdeyi dikkate almadığı bir yükseltme etki alanı varsa, küme iyi durumda değildir.

Tür:Byte
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-NodeTypeHealthPolicyMap

Belirli düğüm türleri için en fazla iyi durumda olmayan düğüm yüzdesine sahip bir harita tanımlar.

Düğüm türü sistem durumu ilkesi eşlemesi, özel düğüm türlerini açıklamak için küme durumu değerlendirmesi sırasında kullanılabilir. Haritaya dahil edilen düğüm türleri, haritaya dahil edilen yüzdeye göre ve ayrıca genel değerle değerlendirilir (bkz. System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Eşlemede belirtilen düğüm türlerinin düğümleri de genel düğüm havuzuna göre sayılır; bağımsız denetimlerdir.

Tür:NodeTypeHealthPolicyMap
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TimeoutSec

İşlem için zaman aşımı süresini saniye cinsinden belirtir.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UpgradeDomainTimeoutSec

Service Fabric'in tek bir yükseltme etki alanını yükseltmesi için gereken en uzun süreyi saniye cinsinden belirtir. Bu süre sonunda yükseltme başarısız olur.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UpgradeMode

Yükseltme için yeni UpgradeMode belirtir.

Tür:RollingUpgradeMode
Kabul edilen değerler:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UpgradeReplicaSetCheckTimeoutSec

Service Fabric'in yükseltme işlemine devam etmeden önce bir çoğaltma kümesinin güvenli bir duruma yeniden yapılandırılmasını bekleyeceği en uzun süreyi saniye cinsinden belirtir.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UpgradeTimeoutSec

Service Fabric'in tüm yükseltme için gereken en uzun süreyi saniye cinsinden belirtir. Bu süre sonunda yükseltme başarısız olur.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Çıkışlar

System.Object