Start-ServiceFabricApplicationUpgrade

Modul:

ServiceFabric

Upgraduje aplikaci Service Fabric na zadanou verzi ApplicationTypeVersion.

Syntax

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.

Type:	Uri
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationParameter

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

Type:	Hashtable
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationTypeVersion

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

Type:	String
Position:	1
Default value:	None
Required:	True
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, zda má být událost stavu upozornění považována za událost chyby během vyhodnocení stavu.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	String
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

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

-ForceRestart

Označuje, že hostitel služby se restartuje i v případě, že upgrade je změna pouze konfigurace.

Type:	SwitchParameter
Position:	3
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 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.

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 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 ).

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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í.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 .

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

-RestartProcess

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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" }

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	UpgradeSortOrder
Accepted values:	Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:	5
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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
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

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

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

Související odkazy

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricApplicationUpgrade
• Resume-ServiceFabricApplicationUpgrade
• Copy-ServiceFabricApplicationPackage
• Register-ServiceFabricApplicationType