Start-ServiceFabricClusterUpgrade

Upgraduje cluster Service Fabric.

Syntax

Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-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>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-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>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-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>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Rutina Start-ServiceFabricClusterUpgrade upgraduje cluster Service Fabric. Můžete upgradovat kód, konfiguraci nebo kód a konfiguraci Service Fabric.

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: Spuštění nesledovaného ručního upgradu

PS C:\> Start-ServiceFabricClusterUpgrade -CodePackageVersion "2.0.59.0" -ClusterManifestVersion "v2" -UnmonitoredManual

Tento příkaz spustí nemonitorovaný ruční upgrade určeného balíčku a konfigurace kódu.

Příklad 2: Spuštění upgradu pouze pro kód

PS C:\> Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion "2.0.59.0" -UnmonitoredAuto

Tento příkaz spustí nemonitorovaný automatický upgrade zadaného balíčku kódu. Neexistuje žádný upgrade konfigurace.

Příklad 3: Spuštění upgradu pouze konfigurace

Start-ServiceFabricClusterUpgrade -ClusterManifestVersion "v2" -Config -FailureAction Rollback -Monitored

Tento příkaz spustí monitorovanou konfiguraci pouze pro zadanou verzi manifestu clusteru. Upgrade používá výchozí zásady stavu a akce selhání je určena jako vrácení zpět.

Příklad 4: Zahájení upgradu pomocí vlastních zásad stavu

PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)

PS C:\> $svcType = New-Object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
PS C:\> $svcType.MaxPercentUnhealthyPartitionsPerService = 20
PS C:\> $svcType.MaxPercentUnhealthyReplicasPerPartition = 20
PS C:\> $warningAsErrorPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
PS C:\> $warningAsErrorPolicy.ConsiderWarningAsError = $true
PS C:\> $warningAsErrorPolicy.DefaultServiceTypeHealthPolicy = $svcType

PS C:\> $appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
PS C:\> $appHealthPolicyMap.Add("fabric:/System", $warningAsErrorPolicy)

PS C:\> Start-ServiceFabricClusterUpgrade -CodePackageVersion "4.2.83.9493" -ClusterManifestVersion "ScaleMin-1.0" -Monitored -FailureAction Rollback -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -Force -MaxPercentUnhealthyNodes 20 -MaxPercentUnhealthyApplications 20 -ApplicationHealthPolicyMap $appHealthPolicyMap

Tento příkaz spustí monitorovaný upgrade pro zadaný balíček kódu a konfiguraci a předá vlastní zásady stavu. Určuje vlastní zásadu stavu clusteru, definuje jinou hodnotu MaxPercentUnhealthyApplications pro kritický typ aplikace a vlastní zásady stavu aplikace pro aplikaci systému clusteru.

Parametry

-ApplicationHealthPolicyMap

Určuje objekt 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 aplikace, vyhodnotí se tato aplikace pomocí zásad stavu aplikace definované v manifestu aplikace, pokud existuje, nebo výchozí zásady stavu.

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 zadaného v parametru 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 lze vyhodnotit pomocí parametru MaxPercentUnhealthyApplications nastaveným na 20 % a 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.

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

-ClusterManifestVersion

Určuje verzi uloženou v manifestu clusteru Service Fabric.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Code

Označuje, že balíček obsahuje pouze soubor .msi Service Fabric.

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

-CodePackageVersion

Určuje verzi souboru .msi Service Fabric.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Config

Označuje, že balíček je manifest clusteru Service Fabric.

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

-Confirm

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

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

-ConsiderWarningAsError

Určuje, jestli má být událost stavu upozornění považována za událost chyby během vyhodnocení stavu entity clusteru a entit Uzlů. Aplikace se vyhodnocují pomocí nastavení zásad stavu aplikace.

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

-EnableDeltaHealthEvaluation

Označuje, že vyhodnocení rozdílového stavu se používá k určení, jestli je cluster Service Fabric v pořádku.

Type:SwitchParameter
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:2
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, po kterou Service Fabric čeká, aby bylo možné ověřit, že cluster je 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 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í 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 se považuje za nezdravý.

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

-MaxPercentUnhealthyApplications

Určuje maximální procento aplikací, které můžou mít agregované stavy chyb. Pokud aktuálně v pořádku aplikace nerespektují tuto částku, cluster se považuje za nezdravý.

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

-MaxPercentUnhealthyNodes

Určuje maximální procento uzlů, které můžou mít agregované stavy chyb. Pokud aktuální aplikace, které nejsou v pořádku, toto procento nerespektují, cluster se považuje za nezdravý.

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

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Určuje maximální procento uzlů rozdílu domény upgradu, které můžou mít agregované stavy chyb. 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 se považuje za nezdravý.

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. To znamená, že kontroly stavu se provádějí po dokončení upgradu pro doménu upgradu. Pokud stav domény upgradu a cluster splňuje zadané zásady stavu, spustí Service Fabric upgrade další domény upgradu. Pokud doména nebo cluster upgradu nesplňuje zásady stavu, upgrade selže a Service Fabric vrátí upgrade zpět nebo přepne do nemonitorovaného ručního režimu v závislosti na zadané chybě FailureAction.

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

-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

-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:4
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. Neprovádí se žádné kontroly stavu a po upgradu domény upgradu service Fabric service Fabric spustí upgrade další domény upgradu bez ohledu na stav clusteru. Tento režim se nedoporučuje pro produkční použití.

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 explicitní spuštění upgradu domény dalšího upgradu rutina Resume-ServiceFabricClusterUpgrade .

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 může trvat upgrade jedné domény upgradu service Fabric. 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á na to, aby oddíl byl v bezpečném stavu, pokud ještě není v bezpečném stavu. Jakmile bezpečnostní kontrola projde všechny oddíly na uzlu, Service Fabric pokračuje upgradem na daném uzlu.

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