Sdílet prostřednictvím

Update-ServiceFabricApplicationUpgrade

  • Reference
Modul:
ServiceFabric

Upraví popis upgradu aktivního upgradu aplikace.

Syntaxe

Update-ServiceFabricApplicationUpgrade
      [-ApplicationName] <Uri>
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-DefaultServiceTypeHealthPolicy <String>]
      [-MaxPercentUnhealthyDeployedApplications <Byte>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-Force]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Rutina Update-ServiceFabricApplicationUpgrade upraví parametry popisu upgradu aplikace, zatímco upgrade je stále aktivní. Service Fabric zjistí a použije změny podle hodnoty UpgradeStatusPollInterval , 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
  • DefaultServiceTypeHealthPolicy
  • MaxPercentUnhealthyDeployedApplications
  • ServiceTypeHealthPolicyMap

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 aplikace

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

Tento příkaz nastaví hodnotu časového limitu časového limitu repliky na hodnotu 0 pro čekající upgrade v prostředcích infrastruktury:/MyApplication. Aktualizace ponechá všechny ostatní hodnoty upgradu samostatně.

Parametry

-ApplicationName

Určuje identifikátor URI (Uniform Resource Identifier) aplikace Service Fabric. Rutina aktualizuje nastavení upgradu pro aplikaci, která má identifikátor URI, který tento parametr určuje.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu 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 během vyhodnocení stavu.

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

-DefaultServiceTypeHealthPolicy

Určuje výchozí zásady stavu pro typy služeb. Zásady stavu se používají pro monitorovaný upgrade. Zásada se řídí formátem MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices. Například 5 10 15 označuje následující hodnoty:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Typ:String
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 monitorovaný upgrade selže. Tento parametr přijímá tyto hodnoty:

  • Vrácení zpět
  • Ruční
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čí zprávu 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

Označuje, jestli se hostitel služby restartuje i v případě, že upgrade je změna pouze 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, která Service Fabric čeká, aby ověřila, že je aplikace 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.

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, 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á bude čekat před bezstavovou instancí, která je ovlivněna upgradem aplikace, aby aktivní požadavky 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

-MaxPercentUnhealthyDeployedApplications

Určuje maximální procento tolerovaných nasazených aplikací, které můžou mít stav chyby. Pokud procento instancí aplikace, které nejsou v pořádku nasazené na uzlech v clusteru, překročí hodnotu, kterou tento parametr určuje, je stav aplikace chybový.

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

-ServiceTypeHealthPolicyMap

Určuje mapu zásad stavu, která se má použít pro různé typy služeb. Zadejte mapu jako tabulku hash v následujícím formátu: @ {"ServiceTypeName": "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Například:

@{ "ServiceTypeName01" = "5,10;5"; "ServiceTypeName02" = "5,5;5" }

Typ:Hashtable
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 služba Service Fabric trvá k upgradu jedné upgradové domény. Po tomto období 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 čeká, až se služba 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 služba Service Fabric trvá pro celý upgrade. Po tomto období 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

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

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