Start-ServiceFabricApplicationUpgrade

Reference

Modul:: ServiceFabric

Upgraduje aplikaci Service Fabric na zadanou verzi ApplicationTypeVersion.

Syntaxe

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Rutina Start-ServiceFabricApplicationUpgrade upgraduje aplikaci Service Fabric. Před použitím této rutiny musíte zkopírovat aktualizovaný balíček aplikace do úložiště imagí a zaregistrovat aktualizovaný typ aplikace. Pomocí copy-ServiceFabricApplicationPackage zkopírujte balíček aplikace do úložiště imagí. K registraci aktualizovaného typu aplikace použijte rutinu Register-ServiceFabricApplicationType .

Tato rutina spustí upgrade v clusteru.

ApplicationParameters nejsou zachovány v rámci upgradu aplikace. Aby se zachovaly aktuální parametry aplikace, měl by uživatel nejprve získat parametry a předat je do volání rozhraní API upgradu, jak je znázorněno v příkladu 1 níže.

Další informace o upgradech aplikací Service Fabric najdete v koncepční dokumentaci.

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: Získání parametrů aplikace pro předání do volání upgradu

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}

foreach ($pair in $appParamCollection)
{ $applicationParameterMap.Add($pair.Name, $pair.Value); }

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

Příklad 2: Upgrade aplikace

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\PersistentToDoListServiceV2" -ImageStoreConnectionString "file:C:\ProgramData\ServiceFabric\ImageStore"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListServiceV2"
PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeVersion "2.0" -ForceRestart -UnMonitoredManual

První příkaz používá rutinu Copy-ServiceFabricApplicationPackage ke zkopírování aktualizovaného balíčku aplikace do úložiště imagí.

Druhý příkaz používá rutinu Register-ServiceFabricApplicationType k registraci aktualizovaného typu aplikace.

Třetí příkaz aplikaci upgraduje. Příkaz provede nemonitorovaný ruční upgrade, který zahrnuje restartování serveru, který je hostitelem aplikace.

Parametry

-ApplicationName

Určuje identifikátor URI (Uniform Resource Identifier) aplikace Service Fabric. Rutina upgraduje aplikaci, která má zadaný identifikátor URI.

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

-ApplicationParameter

Určuje přepsání parametrů aplikace jako párů názvů a hodnot.

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

-ApplicationTypeVersion

Určuje verzi typu aplikace Service Fabric. Rutina upgraduje aplikaci na zadaná verze.

Typ:	String
Position:	1
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, zda má být událost stavu upozornění považována za událost chyby 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 zásady stavu pro výchozí typ služby, který se má použít pro monitorovaný upgrade ve formátu 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:	True
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í upgrade.

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, že hostitel služby se restartuje i v případě, že upgrade je změna pouze konfigurace.

Typ:	SwitchParameter
Position:	3
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í před přechodem na další doménu upgradu nebo dokončením upgradu. 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 (v New-ServiceFabricServicečásti ).

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 instancí aplikace nasazených na uzlech v clusteru se stavem chyby před stavem aplikace pro cluster je chyba.

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

-Monitored

Označuje, že je monitorovaný režim upgradu. Jakmile rutina dokončí upgrade domény upgradu, pokud stav domény upgradu a cluster splňují zásady stavu, které definujete, Service Fabric upgraduje další doménu upgradu. Pokud doména nebo cluster upgradu nesplňuje zásady stavu, upgrade selže a Service Fabric vrátí upgrade pro doménu upgradu nebo se vrátí do ručního režimu podle zadané zásady. Toto je doporučený režim pro upgrady aplikací v produkčním prostředí.

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

-ReplicaQuorumTimeoutSec

Určuje časové období v sekundách, ve které zkontrolujete, jestli sada replik má kvorum. Po uplynutí časového limitu bude upgrade pokračovat.

Tento parametr je zastaralý. Místo toho zadejte parametr UpgradeReplicaSetCheckTimeoutSec .

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

-RestartProcess

Označuje, že hostitel služby se restartuje v rámci upgradu.

Tento parametr je zastaralý. Místo toho zadejte parametr ForceRestart .

Typ:	SwitchParameter
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 jako tabulku hash v následujícím formátu: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Pří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

-SortOrder

Definuje pořadí, ve kterém probíhá upgrade prostřednictvím clusteru.

Možné hodnoty:

Invalid – Označuje, že toto pořadí řazení není platné. Všechny výčty Service Fabric mají neplatný typ.
Default – Označuje, že se použije výchozí pořadí řazení (jak je uvedeno v manifestu clusteru).
Numeric – Označuje, že se použije přeposílání číselného pořadí řazení (názvy UD seřazené jako čísla).
Lexicographical – Označuje, že se použije pořadí přeposílání lexikálního řazení (názvy UD seřazené jako řetězce).
ReverseNumeric – Označuje, že se použije reverzní číselné pořadí řazení (názvy UD seřazené jako čísla).
ReverseLexicographical– Označuje, že se použije reverzní lexikální pořadí řazení (názvy UD seřazené jako řetězce).

Typ:	UpgradeSortOrder
Přípustné hodnoty:	Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:	5
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

-UnmonitoredAuto

Označuje, že režim upgradu není monitorovaný automaticky. Po upgradu domény upgradu služba Service Fabric upgraduje další doménu upgradu bez ohledu na stav aplikace. Tento režim se nedoporučuje pro produkční prostředí a je užitečný pouze při vývoji aplikace.

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

-UnmonitoredManual

Označuje, že režim upgradu není monitorovaný ručně. Po upgradu domény upgradu Service Fabric čeká na upgrade další domény upgradu pomocí rutiny Resume-ServiceFabricApplicationUpgrade .

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
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

-UpgradeReplicaSetCheckTimeoutSec

Určuje maximální dobu, 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, než Service Fabric provede upgrade.

Typ:	UInt32
Position:	4
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

Sdílet prostřednictvím

Start-ServiceFabricApplicationUpgrade

Syntaxe

Description

Příklady

Příklad 1: Získání parametrů aplikace pro předání do volání upgradu

Příklad 2: Upgrade aplikace

Parametry

-ApplicationName

-ApplicationParameter

-ApplicationTypeVersion

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-InstanceCloseDelayDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-ReplicaQuorumTimeoutSec

-RestartProcess

-ServiceTypeHealthPolicyMap

-SortOrder

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

Vstupy

Výstupy

Další materiály

Sdílet prostřednictvím

Start-ServiceFabricApplicationUpgrade

Syntaxe

Description

Příklady

Příklad 1: Získání parametrů aplikace pro předání do volání upgradu

Příklad 2: Upgrade aplikace

Parametry

-ApplicationName

-ApplicationParameter

-ApplicationTypeVersion

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-InstanceCloseDelayDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-ReplicaQuorumTimeoutSec

-RestartProcess

-ServiceTypeHealthPolicyMap

-SortOrder

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

Vstupy

Výstupy

Související odkazy

Další materiály