Bagikan melalui


Update-ServiceFabricClusterUpgrade

Memodifikasi deskripsi peningkatan peningkatan Kluster aktif.

Sintaks

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

Deskripsi

Cmdlet Update-ServiceFabricClusterUpgrade memodifikasi parameter deskripsi peningkatan kluster saat peningkatan masih aktif. Service Fabric mendeteksi dan menerapkan perubahan sesuai dengan nilai FabricUpgradeStatusPollInterval , seperti yang ditentukan dalam manifes kluster. Kecuali untuk kebijakan evaluasi kesehatan, cmdlet ini hanya memperbarui parameter yang Anda tentukan. Parameter yang tidak ditentukan tetap tidak terpengaruh. Anda harus memperbarui kebijakan evaluasi kesehatan berikut bersama-sama, bukan satu per satu:

  • ConsiderWarningAsError
  • MaxPercentUnhealthyApplications
  • MaxPercentUnhealthyNodes

Untuk mengelola kluster Service Fabric, mulai Windows PowerShell dengan menggunakan opsi Jalankan sebagai administrator. Sebelum Anda melakukan operasi apa pun pada kluster Service Fabric, buat koneksi ke kluster dengan menggunakan cmdlet Connect-ServiceFabricCluster .

Contoh

Contoh 1: Memperbarui nilai untuk peningkatan kluster

PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0

Perintah ini mengatur periode waktu habis pemeriksaan set replika ke 0 untuk peningkatan kluster yang tertunda. Pembaruan meninggalkan semua nilai peningkatan lainnya saja.

Contoh 2: Memperbarui kebijakan kesehatan untuk peningkatan kluster

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

Perintah ini mengubah kebijakan kesehatan kluster peningkatan kluster. Ini menentukan peta kebijakan kesehatan jenis aplikasi yang berisi jenis aplikasi CriticalAppType, yang tidak mentolerir kegagalan apa pun. Sisa aplikasi dievaluasi menggunakan 20% persen maksimum tidak sehat.

Perintah ini juga memperbarui kebijakan kesehatan aplikasi yang digunakan untuk mengevaluasi aplikasi fabric:/System sebagai bagian dari evaluasi kesehatan peningkatan kluster. Kebijakan baru mentolerir semua kesalahan partisi.

Parameter

-ApplicationHealthPolicyMap

Menentukan System.Fabric.Health.ApplicationHealthPolicyMap yang mencakup kebijakan kesehatan kustom untuk beberapa atau semua aplikasi. Jika Anda tidak menentukan parameter ini, atau jika Anda tidak menyertakan entri dalam peta untuk aplikasi, aplikasi tersebut dievaluasi dengan kebijakan kesehatan aplikasi yang ditentukan dalam manifes aplikasi jika ada, atau kebijakan default sebaliknya.

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

-ApplicationTypeHealthPolicyMap

Menentukan peta yang menentukan persentase maksimum aplikasi yang tidak sehat yang diizinkan per jenis aplikasi. Jenis aplikasi dalam peta ini dievaluasi menggunakan persentase tertentu daripada persentase MaxPercentUnhealthyApplications global.

Misalnya, jika beberapa aplikasi jenis sangat penting, administrator kluster dapat menambahkan entri ke peta untuk jenis aplikasi tersebut dan menetapkan nilai 0% (artinya, tidak mentolerir kegagalan apa pun). Semua aplikasi lain dapat dievaluasi dengan MaxPercentUnhealthyApplications yang diatur ke 20% untuk mentolerir beberapa kegagalan dari ribuan instans aplikasi.

Peta kebijakan kesehatan jenis aplikasi hanya digunakan jika manifes kluster memungkinkan evaluasi kesehatan jenis aplikasi menggunakan entri konfigurasi untuk HealthManager/EnableApplicationTypeHealthEvaluation.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-ConsiderWarningAsError

Menunjukkan apakah akan memperlakukan laporan kesehatan peringatan sebagai kesalahan selama evaluasi kesehatan.

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

-EnableDeltaHealthEvaluation

Menunjukkan apakah akan mengaktifkan pemeriksaan kesehatan delta selama evaluasi kesehatan dalam peningkatan yang dipantau. Jika Anda menentukan nilai $True, Service Fabric mengambil rekam jepret kesehatan di awal peningkatan. Setelah setiap domain peningkatan menyelesaikan peningkatan, pemeriksaan kesehatan membandingkan status kluster saat ini dengan rekam jepret. Jika ada degradasi kesehatan yang tidak menghormati persentase maksimum yang diizinkan dari kebijakan kesehatan peningkatan kluster saat ini, pemeriksaan kesehatan gagal.

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

-FailureAction

Menentukan tindakan yang akan diambil jika peningkatan yang dipantau gagal. Nilai yang dapat diterima untuk parameter ini adalah:

  • Putar kembali
  • Manual.
Type:UpgradeFailureAction
Accepted values:Invalid, Rollback, Manual
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Menunjukkan bahwa cmdlet ini melewati pesan peringatan dan memaksa pembaruan.

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

-ForceRestart

Menunjukkan apakah akan menghidupkan ulang node Service Fabric meskipun hanya konfigurasi dinamis yang telah berubah.

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

-HealthCheckRetryTimeoutSec

Menentukan durasi, dalam detik, setelah itu Service Fabric mencoba kembali pemeriksaan kesehatan jika pemeriksaan kesehatan sebelumnya gagal.

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

-HealthCheckStableDurationSec

Menentukan durasi, dalam detik, bahwa Service Fabric menunggu untuk memverifikasi bahwa kluster stabil sebelum berlanjut ke domain peningkatan berikutnya atau menyelesaikan peningkatan. Durasi tunggu ini mencegah perubahan kesehatan yang tidak terdeteksi tepat setelah pemeriksaan kesehatan dilakukan.

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

-HealthCheckWaitDurationSec

Menentukan durasi, dalam hitungan detik, bahwa Service Fabric menunggu sebelum melakukan pemeriksaan kesehatan awal setelah menyelesaikan peningkatan pada domain peningkatan.

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

-InstanceCloseDelayDurationSec

Menentukan durasi dalam hitungan detik, untuk menunggu sebelum instans stateless yang terpengaruh oleh peningkatan kluster ditutup, untuk memungkinkan permintaan aktif menguras dengan baik. Durasi tunggu ini hanya efektif untuk instans layanan stateless yang memiliki nilai bukan nol yang dikonfigurasi untuk InstanceCloseDelayDuration, dan akan mengambil alih nilai yang telah dikonfigurasi sebelumnya. Lihat InstanceCloseDelayDuration untuk detailnya.

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

-MaxPercentDeltaUnhealthyNodes

Menentukan persentase maksimum yang ditoleransi dari simpul tidak sehat delta yang dapat memiliki status kesalahan kesehatan agregat. Jika simpul yang tidak sehat saat ini tidak menghormati persentase relatif terhadap status di awal peningkatan, kluster tidak sehat.

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

-MaxPercentUnhealthyApplications

Menentukan persentase maksimum aplikasi yang ditoleransi yang dapat memiliki status kesalahan kesehatan agregat. Jika peningkatan melebihi persentase ini, kluster tidak sehat.

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

-MaxPercentUnhealthyNodes

Menentukan persentase maksimum node yang ditoleransi yang dapat memiliki status kesalahan kesehatan agregat. Jika peningkatan melebihi persentase ini, kluster tidak sehat.

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

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Menentukan persentase maksimum yang ditoleransi dari simpul tidak sehat delta domain peningkatan yang dapat memiliki status kesalahan kesehatan agregat. Jika ada domain peningkatan di mana simpul yang tidak sehat saat ini tidak menghormati persentase relatif terhadap status di awal peningkatan, kluster tidak sehat.

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

-NodeTypeHealthPolicyMap

Mendefinisikan peta dengan persentase maksimum simpul yang tidak sehat untuk jenis node tertentu.

Peta kebijakan kesehatan jenis node dapat digunakan selama evaluasi kesehatan kluster untuk menggambarkan jenis node khusus. Jenis node yang disertakan dalam peta dievaluasi terhadap persentase yang disertakan dalam peta, dan juga dengan global (lihat System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Simpul jenis node yang ditentukan dalam peta juga dihitung terhadap kumpulan simpul global; mereka adalah pemeriksaan independen.

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

-TimeoutSec

Menentukan periode waktu habis, dalam detik, untuk operasi.

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

-UpgradeDomainTimeoutSec

Menentukan waktu maksimum, dalam detik, yang dibutuhkan Service Fabric untuk meningkatkan satu domain peningkatan. Setelah periode ini, peningkatan gagal.

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

-UpgradeMode

Menentukan UpgradeMode baru untuk peningkatan.

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

-UpgradeReplicaSetCheckTimeoutSec

Menentukan waktu maksimum, dalam detik, bahwa Service Fabric menunggu replika yang diatur untuk dikonfigurasi ulang ke dalam keadaan aman, jika belum dalam keadaan aman, sebelum Service Fabric melanjutkan peningkatan.

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

-UpgradeTimeoutSec

Menentukan waktu maksimum, dalam detik, yang dibutuhkan Service Fabric untuk seluruh peningkatan. Setelah periode ini, peningkatan gagal.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

None

Output

System.Object