Update-ServiceFabricClusterUpgrade

Reference

Modul:: ServiceFabric

Upraví popis upgradu aktivního upgradu clusteru.

Syntax

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

Rutina Update-ServiceFabricClusterUpgrade upraví parametry popisu upgradu clusteru, zatímco upgrade je stále aktivní. Service Fabric zjistí a použije změny podle hodnoty FabricUpgradeStatusPollInterval , jak je uvedeno v manifestu clusteru. Kromě zásad vyhodnocení stavu tato rutina aktualizuje jenom zadané parametry. Nezadané parametry zůstanou nedotčené. Musíte aktualizovat následující zásady hodnocení stavu společně, nikoli jednotlivě:

ConsiderWarningAsError
MaxPercentUnhealthyApplications
MaxPercentUnhealthyNode

Pokud chcete spravovat clustery Service Fabric, spusťte Windows PowerShell pomocí možnosti Spustit jako správce. Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster .

Příklady

Příklad 1: Aktualizace hodnoty pro upgrade clusteru

PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0

Tento příkaz nastaví časový limit sady replik na hodnotu 0 pro čekající upgrade clusteru. Aktualizace ponechá všechny ostatní hodnoty upgradu samostatně.

Příklad 2: Aktualizace zásad stavu pro upgrade clusteru

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

Tento příkaz změní zásady stavu clusteru upgradu clusteru. Určuje mapu zásad stavu typu aplikace, která obsahuje typ aplikace CriticalAppType, která netoleruje žádné chyby. Zbývající aplikace se vyhodnocují pomocí maximálního počtu 20 % v pořádku.

Příkaz také aktualizuje zásady stavu aplikace používané k vyhodnocení stavu infrastruktury:/Systémová aplikace v rámci vyhodnocení stavu upgradu clusteru. Nové zásady tolerují všechny chyby oddílů.

Parametry

-ApplicationHealthPolicyMap

Určuje System.Fabric.Health.ApplicationHealthPolicyMap , který obsahuje vlastní zásady stavu pro některé nebo všechny aplikace. Pokud tento parametr nezadáte nebo nezadáte položku do mapy pro aplikaci, vyhodnotí se tato aplikace pomocí zásad stavu aplikace definované v manifestu aplikace, pokud existuje, nebo výchozí zásady jinak.

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

-ApplicationTypeHealthPolicyMap

Určuje mapu, která definuje maximální procento aplikací, které nejsou v pořádku, které jsou povolené pro jednotlivé typy aplikací. Typy aplikací v této mapě se vyhodnocují pomocí konkrétních procent místo globálního procenta MaxPercentUnhealthyApplications .

Pokud jsou například některé aplikace typu kritické, může správce clusteru přidat položku do mapy pro tento typ aplikace a přiřadit ji hodnotu 0 % (to znamená, že tolerovat žádné chyby). Všechny ostatní aplikace je možné vyhodnotit pomocí MaxPercentUnhealthyApplications nastavené na 20 % pro tolerování některých selhání z tisíců instancí aplikace.

Mapa zásad stavu typu aplikace se používá pouze v případě, že manifest clusteru povolí vyhodnocení stavu typu aplikace pomocí položky konfigurace pro HealthManager/EnableApplicationTypeHealthEvaluation.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-ConsiderWarningAsError

Označuje, jestli se má zpráva o stavu upozornění považovat za chybu během vyhodnocení stavu.

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

-EnableDeltaHealthEvaluation

Určuje, jestli chcete povolit rozdílové kontroly stavu během vyhodnocení stavu v monitorovaných upgradech. Pokud zadáte hodnotu $True, Service Fabric pořídí snímek stavu na začátku upgradu. Po dokončení upgradu se kontrolou stavu porovná aktuální stav clusteru se snímkem. Pokud dojde ke snížení stavu, které nerespektuje maximální povolené procento z aktuálních zásad stavu upgradu clusteru, kontroly stavu selžou.

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

-FailureAction

Určuje akci, která se má provést, pokud monitorovaný upgrade selže. Tento parametr přijímá tyto hodnoty:

Vrácení zpět
Ruční.

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

-Force

Označuje, že tato rutina přeskočí zprávu upozornění a vynutí aktualizaci.

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

-ForceRestart

Určuje, jestli se má uzel Service Fabric restartovat, i když se změnily pouze dynamické konfigurace.

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

-HealthCheckRetryTimeoutSec

Určuje dobu trvání v sekundách, po které Service Fabric opakuje kontrolu stavu, pokud předchozí kontrola stavu selže.

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

-HealthCheckStableDurationSec

Určuje dobu trvání, v sekundách, která Service Fabric čeká, aby ověřila, že cluster je stabilní, než bude pokračovat v další doméně upgradu nebo dokončí upgrade. Tato doba čekání brání neidentiktivním změnám stavu hned po provedení kontroly stavu.

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

-HealthCheckWaitDurationSec

Určuje dobu trvání, v sekundách, která Service Fabric čeká, než provede počáteční kontrolu stavu po dokončení upgradu v doméně upgradu.

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

-InstanceCloseDelayDurationSec

Určuje dobu trvání v sekundách, která bude čekat před bezstavovou instancí, která je ovlivněna upgradem clusteru, a umožní tak aktivním požadavkům, aby se vyprázdnily správně. Tato doba čekání je platná pouze pro instance bezstavových služeb, které mají nenulovou hodnotu nakonfigurovanou pro InstanceCloseDelayDuration a přepíše předem nakonfigurovanou hodnotu. Podrobnosti najdete v tématu InstanceCloseDelayDuration .

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

-MaxPercentDeltaUnhealthyNodes

Určuje maximální tolerované procento rozdílových uzlů, které můžou mít agregované stavy chyb. Pokud aktuální uzly, které nejsou v pořádku, nerespektují procento relativní ke stavu na začátku upgradu, cluster není v pořádku.

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

-MaxPercentUnhealthyApplications

Určuje maximální tolerované procento aplikací, které mohou mít agregovaný stav chyby. Pokud upgrade překročí toto procento, cluster není v pořádku.

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

-MaxPercentUnhealthyNodes

Určuje maximální tolerované procento uzlů, které můžou mít agregované stavy chyb. Pokud upgrade překročí toto procento, cluster není v pořádku.

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

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Určuje maximální tolerované procento rozdílu domény upgradu, které můžou mít agregovaný stav chyby. Pokud existuje nějaká doména upgradu, ve které aktuální uzly v pořádku nerespektují procento relativní ke stavu na začátku upgradu, cluster není v pořádku.

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

-NodeTypeHealthPolicyMap

Definuje mapu s maximálním procentem uzlů, které nejsou v pořádku pro konkrétní typy uzlů.

Mapování zásad stavu uzlu lze použít během vyhodnocení stavu clusteru k popisu speciálních typů uzlů. Typy uzlů zahrnuté v mapě se vyhodnocují v procentech zahrnutých v mapě a také s globálními hodnotami (viz System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNode). Uzly typů uzlů zadaných v mapě se také počítají do globálního fondu uzlů; jsou nezávislé kontroly.

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

-TimeoutSec

Určuje časový limit operace v sekundách.

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

-UpgradeDomainTimeoutSec

Určuje maximální dobu v sekundách, kterou služba Service Fabric trvá k upgradu jedné upgradové domény. Po tomto období upgrade selže.

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

-UpgradeMode

Určuje nový upgradeMode pro upgrade.

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

-UpgradeReplicaSetCheckTimeoutSec

Určuje maximální dobu v sekundách, po kterou Service Fabric čeká na překonfigurování repliky nastavené na bezpečný stav, pokud ještě není v bezpečném stavu, a teprve potom service Fabric pokračuje s upgradem.

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

-UpgradeTimeoutSec

Určuje maximální dobu v sekundách, kterou služba Service Fabric trvá pro celý upgrade. Po tomto období upgrade selže.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

None

Výstupy

System.Object