Start-ServiceFabricClusterUpgrade

Uppgraderar ett Service Fabric-kluster.

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

Cmdleten Start-ServiceFabricClusterUpgrade uppgraderar ett Service Fabric-kluster. Du kan uppgradera Service Fabric-kod, konfiguration eller både kod och konfiguration.

Om du vill hantera Service Fabric-kluster startar du Windows PowerShell med alternativet Kör som administratör. Innan du utför en åtgärd på ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster .

Exempel

Exempel 1: Starta obevakad manuell uppgradering

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

Det här kommandot startar den obevakade manuella uppgraderingen för det angivna kodpaketet och konfigurationen.

Exempel 2: Starta uppgraderingen endast för kod

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

Det här kommandot startar den oövervakade automatiska uppgraderingen för det angivna kodpaketet. Det finns ingen konfigurationsuppgradering.

Exempel 3: Starta endast uppgradering av konfiguration

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

Det här kommandot startar endast uppgraderingen av den övervakade konfigurationen för den angivna versionen av klustermanifestet. Uppgraderingen använder standardhälsoprinciper och felåtgärden anges som Återställning.

Exempel 4: Starta uppgraderingen med en anpassad hälsoprincip

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

Det här kommandot startar den övervakade uppgraderingen för det angivna kodpaketet och konfigurationen och skickar anpassade hälsoprinciper. Den anger en anpassad hälsoprincip för kluster, definierar en annan MaxPercentUnhealthyApplications för en kritisk programtyp och en anpassad programhälsoprincip för klustrets systemprogram.

Parametrar

-ApplicationHealthPolicyMap

Anger ett System.Fabric.Health.ApplicationHealthPolicyMap-objekt som innehåller anpassade hälsoprinciper för vissa eller alla program. Om du inte anger den här parametern, eller om du inte inkluderar en post i kartan för ett program, utvärderas programmet med den programhälsoprincip som definierats i programmanifestet om den finns eller standardhälsoprincipen på annat sätt.

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

-ApplicationTypeHealthPolicyMap

Anger kartan som definierar den maximala procentandelen program med feltillstånd som tillåts per programtyp. Programtyper i den här kartan utvärderas med hjälp av specifika procentandelar i stället för den globala procentandel som anges i parametern MaxPercentUnhealthyApplications .

Om vissa program av en typ till exempel är kritiska kan klusteradministratören lägga till en post på kartan för den programtypen och tilldela den värdet 0 % (det vill säga tolerera inte fel). Alla andra program kan utvärderas med parametern MaxPercentUnhealthyApplications inställd på 20 % för att tolerera vissa fel av de tusentals programinstanserna.

Programtypens hälsoprincipkarta används endast om klustermanifestet aktiverar hälsoutvärdering av programtyp med hjälp av konfigurationsposten för HealthManager/EnableApplicationTypeHealthEvaluation.

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

-ClusterManifestVersion

Anger den version som lagras i ett Service Fabric-klustermanifest.

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

-Code

Anger att paketet endast innehåller en Service Fabric-.msi fil.

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

-CodePackageVersion

Anger versionen av Service Fabric .msi-filen.

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

-Config

Anger att paketet är ett Service Fabric-klustermanifest.

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

-Confirm

Uppmanar till bekräftelse innan du kör cmdleten.

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

-ConsiderWarningAsError

Anger om en varningshälsohändelse ska behandlas som en felhändelse under hälsoutvärderingen av klusterentiteten och nodentiteterna. Program utvärderas med hjälp av principinställningar för programhälsa.

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

-EnableDeltaHealthEvaluation

Anger att deltahälsoutvärdering används för att avgöra om Service Fabric-klustret är felfritt.

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

-FailureAction

Anger vilken åtgärd som ska vidtas om den övervakade uppgraderingen misslyckas. De acceptabla värdena för den här parametern är:

  • Återställning
  • Manuell
Type:UpgradeFailureAction
Accepted values:Invalid, Rollback, Manual
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Anger att denna cmdlet hoppar över varningsmeddelandet och tvingar uppgraderingen.

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

-ForceRestart

Anger att tjänstvärden startas om även om uppgraderingen är en konfigurationsändring.

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

-HealthCheckRetryTimeoutSec

Anger varaktigheten, i sekunder, varefter Service Fabric försöker utföra hälsokontrollen igen om den tidigare hälsokontrollen misslyckas.

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

-HealthCheckStableDurationSec

Anger varaktigheten i sekunder som Service Fabric väntar för att verifiera att klustret är stabilt innan du flyttar till nästa uppgraderingsdomän eller slutför uppgraderingen. Den här väntetiden förhindrar oupptäckta hälsoändringar direkt efter att hälsokontrollen har utförts.

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

-HealthCheckWaitDurationSec

Anger varaktigheten i sekunder som Service Fabric väntar innan den utför den första hälsokontrollen när uppgraderingen har slutförts på uppgraderingsdomänen.

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

-InstanceCloseDelayDurationSec

Anger varaktigheten i sekunder, att vänta innan en tillståndslös instans som påverkas av klusteruppgraderingen stängs, så att de aktiva begärandena kan tömmas korrekt. Den här väntetiden gäller endast för instanser av tillståndslösa tjänster som har ett värde som inte är noll konfigurerat för InstanceCloseDelayDuration och åsidosätter det förkonfigurerade värdet. Mer information finns i InstanceCloseDelayDuration .

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

-MaxPercentDeltaUnhealthyNodes

Anger den maximala procentandelen deltanoder med feltillstånd som kan ha aggregerade feltillstånd. Om de aktuella inte felfria noderna inte respekterar procentandelen i förhållande till tillståndet i början av uppgraderingen anses klustret vara felfritt.

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

-MaxPercentUnhealthyApplications

Anger den maximala procentandelen program som kan ha aggregerade hälsotillstånd för fel. Om de program som för närvarande inte är felfria inte respekterar den här mängden anses klustret vara felfritt.

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

-MaxPercentUnhealthyNodes

Anger den maximala procentandelen noder som kan ha aggregerade feltillstånd. Om de aktuella program som inte är felfria inte respekterar den här procentandelen anses klustret vara inte felfri.

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

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Anger den maximala procentandelen av uppgraderingsdomänens deltanoder som inte är felfria och som kan ha aggregerade feltillstånd. Om det finns en uppgraderingsdomän där de aktuella inte felfria noderna inte respekterar procentandelen i förhållande till tillståndet i början av uppgraderingen anses klustret vara felfritt.

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

-Monitored

Anger att uppgraderingsläget övervakas. Det innebär att hälsokontroller utförs när uppgraderingen har slutförts för en uppgraderingsdomän. Om uppgraderingsdomänens och klustrets hälsotillstånd uppfyller de angivna hälsoprinciperna startar Service Fabric uppgraderingen av nästa uppgraderingsdomän. Om uppgraderingsdomänen eller klustret inte uppfyller hälsoprinciperna misslyckas uppgraderingen och Service Fabric återställer uppgraderingen eller växlar till oövervakat manuellt läge, beroende på angiven FailureAction.

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

-NodeTypeHealthPolicyMap

Definierar en karta med maximala procentandelar ej felfria noder för specifika nodtyper.

Mappningen av nodtypens hälsoprincip kan användas under utvärderingen av klusterhälsa för att beskriva särskilda nodtyper. Nodtyperna som ingår i kartan utvärderas mot procentandelen som ingår i kartan och även med den globala (se System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Noderna för nodtyper som anges i kartan räknas också mot den globala poolen med noder. de är oberoende kontroller.

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

-ReplicaQuorumTimeoutSec

Anger tidsgränsen i sekunder för att kontrollera om replikuppsättningen har kvorum. Efter tidsgränsen fortsätter uppgraderingen.

Den här parametern är inaktuell. Ange parametern UpgradeReplicaSetCheckTimeoutSec i stället.

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

-RestartProcess

Anger att tjänstvärden startas om som en del av uppgraderingen.

Den här parametern är inaktuell. Ange parametern ForceRestart i stället.

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

-SortOrder

Definierar i vilken ordning en uppgradering fortsätter genom klustret.

Möjliga värden:

  • Invalid – Anger att sorteringsordningen inte är giltig. Alla Service Fabric-uppräkningar har den ogiltiga typen.
  • Default – Anger att standardsorteringsordningen (som anges i klustermanifestet) kommer att användas.
  • Numeric – Anger att framåt numerisk sorteringsordning (UD-namn sorterade som tal) kommer att användas.
  • Lexicographical – Anger att vidarebefordran av lexikografisk sorteringsordning (UD-namn sorterade som strängar) kommer att användas.
  • ReverseNumeric – Anger att omvänd numerisk sorteringsordning (UD-namn sorterade som tal) kommer att användas.
  • ReverseLexicographical– Anger att omvänd lexikografisk sorteringsordning (UD-namn sorterade som strängar) kommer att användas.
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

Anger tidsgränsen i sekunder för åtgärden.

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

-UnmonitoredAuto

Anger att uppgraderingsläget är oövervakat automatiskt. Inga hälsokontroller utförs och när Service Fabric har uppgraderat en uppgraderingsdomän startar Service Fabric uppgraderingen av nästa uppgraderingsdomän oavsett klustrets hälsotillstånd. Det här läget rekommenderas inte för produktionsanvändning.

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

-UnmonitoredManual

Anger att uppgraderingsläget är oövervakat manuellt. När Service Fabric har uppgraderat en uppgraderingsdomän väntar den på att cmdleten Resume-ServiceFabricClusterUpgrade uttryckligen startar uppgraderingen av nästa uppgraderingsdomän.

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

-UpgradeDomainTimeoutSec

Anger den maximala tid i sekunder som Service Fabric kan ta för att uppgradera en enda uppgraderingsdomän. Efter den här perioden misslyckas uppgraderingen.

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

-UpgradeReplicaSetCheckTimeoutSec

Anger den längsta tid som Service Fabric väntar på att en partition ska vara i ett säkert tillstånd, om den inte redan är i ett säkert tillstånd. När säkerhetskontrollerna har godkänts för alla partitioner på en nod fortsätter Service Fabric med uppgraderingen på den noden.

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

-UpgradeTimeoutSec

Anger den maximala tid i sekunder som Service Fabric tar för hela uppgraderingen. Efter den här perioden misslyckas uppgraderingen.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

None

Utdata

System.Object