Start-ServiceFabricClusterUpgrade

Actualiza un clúster de 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

El cmdlet Start-ServiceFabricClusterUpgrade actualiza un clúster de Service Fabric. Puede actualizar el código, la configuración o el código y la configuración de Service Fabric.

Para administrar clústeres de Service Fabric, inicie Windows PowerShell mediante la opción Ejecutar como administrador. Antes de realizar cualquier operación en un clúster de Service Fabric, establezca una conexión con el clúster mediante el cmdlet Connect-ServiceFabricCluster .

Ejemplos

Ejemplo 1: Iniciar una actualización manual no supervisada

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

Este comando inicia la actualización manual no supervisada para el paquete de código y la configuración especificados.

Ejemplo 2: Iniciar actualización solo para código

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

Este comando inicia la actualización automática no supervisada para el paquete de código especificado. No hay ninguna actualización de configuración.

Ejemplo 3: Iniciar la actualización solo de configuración

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

Este comando inicia la actualización de la configuración supervisada solo para la versión del manifiesto de clúster especificada. La actualización usa directivas de mantenimiento predeterminadas y la acción de error se especifica como Rollback.

Ejemplo 4: Inicio de la actualización con una directiva de mantenimiento personalizada

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

Este comando inicia la actualización supervisada para el paquete de código y la configuración especificados y pasa directivas de mantenimiento personalizadas. Especifica una directiva de mantenimiento de clúster personalizada, define un maxPercentUnhealthyApplications diferente para un tipo de aplicación crítico y una directiva de estado de la aplicación personalizada para la aplicación del sistema de clúster.

Parámetros

-ApplicationHealthPolicyMap

Especifica un objeto System.Fabric.Health.ApplicationHealthPolicyMap que incluye directivas de mantenimiento personalizadas para algunas o todas las aplicaciones. Si no especifica este parámetro o si no incluye una entrada en el mapa de una aplicación, esa aplicación se evalúa con la directiva de mantenimiento de la aplicación definida en el manifiesto de aplicación si existe o la directiva de mantenimiento predeterminada de lo contrario.

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

-ApplicationTypeHealthPolicyMap

Especifica el mapa que define el porcentaje máximo de aplicaciones incorrectas permitidas por tipo de aplicación. Los tipos de aplicación de este mapa se evalúan usando porcentajes específicos en lugar del porcentaje global especificado en el parámetro MaxPercentUnhealthyApplications .

Por ejemplo, si algunas aplicaciones de un tipo son vitales, el administrador de clústeres puede agregar una entrada a la asignación para ese tipo de aplicación y asignarle un valor del 0 % (es decir, no tolerar errores). Todas las demás aplicaciones se pueden evaluar con el parámetro MaxPercentUnhealthyApplications establecido en 20 % para tolerar algunos errores de las miles de instancias de aplicación.

La asignación de directivas de mantenimiento del tipo de aplicación solo se usa si el manifiesto del clúster habilita la evaluación de estado del tipo de aplicación mediante la entrada de configuración de HealthManager/EnableApplicationTypeHealthEvaluation.

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

-ClusterManifestVersion

Especifica la versión almacenada en un manifiesto de clúster de Service Fabric.

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

-Code

Indica que el paquete solo incluye un archivo de .msi de Service Fabric.

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

-CodePackageVersion

Especifica la versión del archivo .msi de Service Fabric.

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

-Config

Indica que el paquete es un manifiesto de clúster de Service Fabric.

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

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

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

-ConsiderWarningAsError

Indica si se trata un evento de mantenimiento de advertencia como un evento de error durante la evaluación de estado de la entidad de clúster y de las entidades Nodos. Las aplicaciones se evalúan mediante la configuración de directiva de mantenimiento de la aplicación.

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

-EnableDeltaHealthEvaluation

Indica que la evaluación de estado diferencial se usa para determinar si el clúster de Service Fabric está en buen estado.

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

-FailureAction

Especifica la acción que se debe realizar si se produce un error en la actualización supervisada. Los valores permitidos para este parámetro son los siguientes:

  • Reversión
  • Manual
Type:UpgradeFailureAction
Accepted values:Invalid, Rollback, Manual
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Indica que este cmdlet omite el mensaje de advertencia y fuerza la actualización.

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

-ForceRestart

Indica que el host de servicio se reinicia incluso si la actualización es un cambio de solo configuración.

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

-HealthCheckRetryTimeoutSec

Especifica la duración, en segundos, después de la cual Service Fabric vuelve a intentar la comprobación de estado si se produce un error en la comprobación de estado anterior.

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

-HealthCheckStableDurationSec

Especifica la duración, en segundos, que Service Fabric espera para comprobar que el clúster es estable antes de pasar al siguiente dominio de actualización o completar la actualización. Esta duración de espera evita cambios no detectados de mantenimiento justo después de realizar la comprobación de estado.

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

-HealthCheckWaitDurationSec

Especifica la duración, en segundos, que Service Fabric espera antes de realizar la comprobación de estado inicial después de finalizar la actualización en el dominio de actualización.

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

-InstanceCloseDelayDurationSec

Especifica la duración en segundos, para esperar antes de que se cierre una instancia sin estado que se vea afectada por la actualización del clúster, para permitir que las solicitudes activas se agoten correctamente. Esta duración de espera solo es efectiva para las instancias de esos servicios sin estado que tienen un valor distinto de cero configurado para InstanceCloseDelayDuration y reemplazará el valor preconfigurado. Consulte InstanceCloseDelayDuration para obtener más información.

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

-MaxPercentDeltaUnhealthyNodes

Especifica el porcentaje máximo de nodos incorrectos diferenciales que pueden tener estados de mantenimiento agregados de error. Si los nodos incorrectos actuales no respetan el porcentaje relativo al estado al principio de la actualización, el clúster se considera incorrecto.

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

-MaxPercentUnhealthyApplications

Especifica el porcentaje máximo de aplicaciones que pueden tener estados de mantenimiento agregados de error. Si las aplicaciones actualmente incorrectas no respetan esta cantidad, el clúster se considera incorrecto.

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

-MaxPercentUnhealthyNodes

Especifica el porcentaje máximo de nodos que pueden tener estados de mantenimiento agregados de error. Si las aplicaciones en mal estado actuales no respetan este porcentaje, el clúster se considera incorrecto.

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

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Especifica el porcentaje máximo de nodos incorrectos del dominio de actualización que pueden tener estados de mantenimiento agregados de error. Si hay algún dominio de actualización en el que los nodos incorrectos actuales no respetan el porcentaje relativo al estado al principio de la actualización, el clúster se considera incorrecto.

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

-Monitored

Indica que se supervisa el modo de actualización. Esto significa que las comprobaciones de estado se realizan una vez finalizada la actualización de un dominio de actualización. Si el estado del dominio de actualización y el clúster cumplen las directivas de mantenimiento especificadas, Service Fabric inicia la actualización del siguiente dominio de actualización. Si el dominio de actualización o el clúster no cumplen las directivas de mantenimiento, se produce un error en la actualización y Service Fabric revierte la actualización o cambia al modo manual no supervisado, según el errorAction especificado.

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

-NodeTypeHealthPolicyMap

Define un mapa con porcentajes máximos de nodos incorrectos para tipos de nodos específicos.

La asignación de directiva de mantenimiento de tipo de nodo se puede usar durante la evaluación del mantenimiento de clúster para describir tipos de nodo especiales. Los tipos de nodo incluidos en el mapa se evalúan con respecto al porcentaje incluido en el mapa y también con el global (consulte System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Los nodos de los tipos de nodo especificados en el mapa también se cuentan en el grupo global de nodos; son comprobaciones independientes.

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

-ReplicaQuorumTimeoutSec

Especifica el período de tiempo de espera, en segundos, para comprobar si el conjunto de réplicas tiene cuórum. Después del período de tiempo de espera, la actualización continúa.

Este parámetro está en desuso. Especifique el parámetro UpgradeReplicaSetCheckTimeoutSec en su lugar.

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

-RestartProcess

Indica que el host de servicio se reinicia como parte de la actualización.

Este parámetro está en desuso. Especifique el parámetro ForceRestart en su lugar.

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

-SortOrder

Define el orden en el que una actualización continúa a través del clúster.

Los valores posibles son:

  • Invalid : indica que este criterio de ordenación no es válido. Todas las enumeraciones de Service Fabric tienen el tipo no válido.
  • Default : indica que se usará el criterio de ordenación predeterminado (como se especifica en el manifiesto del clúster).
  • Numeric : indica que se usará el criterio de ordenación numérica reenviada (nombres UD ordenados como números).
  • Lexicographical : indica que se usará el criterio de ordenación léxicográfico reenviado (nombres UD ordenados como cadenas).
  • ReverseNumeric : indica que se usará el criterio de ordenación numérico inverso (nombres UD ordenados como números).
  • ReverseLexicographical- Indica que se usará el criterio de ordenación léxicográfico inverso (nombres UD ordenados como cadenas).
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

Especifica el período de tiempo de espera, en segundos, para la operación.

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

-UnmonitoredAuto

Indica que el modo de actualización no se supervisa de forma automática. No se realizan comprobaciones de estado y después de que Service Fabric actualice un dominio de actualización, Service Fabric inicia la actualización del siguiente dominio de actualización independientemente del estado de mantenimiento del clúster. Este modo no se recomienda para su uso en producción.

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

-UnmonitoredManual

Indica que el modo de actualización no se supervisa de forma manual. Una vez que Service Fabric actualiza un dominio de actualización, espera a que el cmdlet Resume-ServiceFabricClusterUpgrade inicie explícitamente la actualización del siguiente dominio de actualización.

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

-UpgradeDomainTimeoutSec

Especifica el tiempo máximo, en segundos, que Service Fabric puede tardar en actualizar un único dominio de actualización. Después de este período, se produce un error en la actualización.

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

-UpgradeReplicaSetCheckTimeoutSec

Especifica el tiempo máximo que Service Fabric espera a que una partición esté en un estado seguro, si aún no está en un estado seguro. Una vez que se superan las comprobaciones de seguridad de todas las particiones de un nodo, Service Fabric continúa con la actualización en ese nodo.

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

-UpgradeTimeoutSec

Especifica el tiempo máximo, en segundos, que Service Fabric tarda para toda la actualización. Después de este período, se produce un error en la actualización.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

None

Salidas

System.Object