Sdílet prostřednictvím

Update-ServiceFabricClusterUpgrade

  • Reference
Modul:
ServiceFabric

Upraví popis upgradu aktivního upgradu clusteru.

Syntaxe

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 aktualizuje tato rutina jenom zadané parametry. Nezadané parametry zůstávají nedotčené. Je nutné aktualizovat následující zásady hodnocení stavu společně, nikoli jednotlivě:

  • ConsiderWarningAsError
  • MaxPercentUnhealthyApplications
  • MaxPercentUnhealthyNodes

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 kontroly 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ásadu stavu clusteru upgradu clusteru. Určuje mapu zásad stavu typu aplikace obsahující typ aplikace CriticalAppType, která netoleruje žádné chyby. Zbývající aplikace se vyhodnocují pomocí 20% maximálního procenta, které není v pořádku.

Příkaz také aktualizuje zásady stavu aplikace použité k vyhodnocení prostředků 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 jinak výchozí zásady.

Typ:ApplicationHealthPolicyMap
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationTypeHealthPolicyMap

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

Pokud jsou například některé aplikace typu kritické, může správce clusteru přidat položku do mapy pro daný typ aplikace a přiřadit ji hodnotě 0% (to znamená, že netoleruje žádné chyby). Všechny ostatní aplikace je možné vyhodnotit pomocí MaxPercentUnhealthyApplications nastavená na 20%, aby bylo možné tolerovat některá 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.

Typ:ApplicationTypeHealthPolicyMap
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ConsiderWarningAsError

Označuje, jestli se má zpráva o stavu upozornění považovat za chybu při vyhodnocování stavu.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnableDeltaHealthEvaluation

Určuje, jestli se mají povolit rozdílové kontroly stavu během vyhodnocování 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 kontrola 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.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FailureAction

Určuje akci, která se má provést, pokud se monitorovaný upgrade nezdaří. Přijatelné hodnoty pro tento parametr jsou:

  • Redukce
  • Manuál.
Typ:UpgradeFailureAction
Přípustné hodnoty:Invalid, Rollback, Manual
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ForceRestart

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

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HealthCheckRetryTimeoutSec

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

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HealthCheckStableDurationSec

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

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HealthCheckWaitDurationSec

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

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InstanceCloseDelayDurationSec

Určuje dobu trvání v sekundách, která se má čekat, než se zavře bezstavová instance, která má vliv na upgrade clusteru, aby aktivní žádosti mohly řádně vyprázdnit. 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.

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxPercentDeltaUnhealthyNodes

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

Typ:Byte
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxPercentUnhealthyApplications

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

Typ:Byte
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Byte
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

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

Typ:Byte
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NodeTypeHealthPolicyMap

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

Mapu zásad stavu typu uzlu je možné použít při vyhodnocování stavu clusteru k popisu speciálních typů uzlů. Typy uzlů zahrnuté v mapě se vyhodnocují s procentem zahrnutým v mapě a také s globálními hodnotami (viz System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Uzly typů uzlů zadaných v mapě se také počítají do globálního fondu uzlů; jsou nezávislé kontroly.

Typ:NodeTypeHealthPolicyMap
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TimeoutSec

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

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UpgradeDomainTimeoutSec

Určuje maximální dobu v sekundách, kterou Service Fabric trvá upgrade jedné upgradové domény. Po uplynutí této doby upgrade selže.

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UpgradeMode

Určuje nový UpgradeMode pro upgrade.

Typ:RollingUpgradeMode
Přípustné hodnoty:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UpgradeReplicaSetCheckTimeoutSec

Určuje maximální dobu v sekundách, po kterou Service Fabric počká, až se replika nastaví tak, aby se překonfiguruje do bezpečného stavu, pokud ještě není v bezpečném stavu, a teprve potom Service Fabric provede upgrade.

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UpgradeTimeoutSec

Určuje maximální dobu v sekundách, kterou Service Fabric trvá pro celý upgrade. Po uplynutí této doby upgrade selže.

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

System.Object