Update-ServiceFabricClusterUpgrade
Modifica la descripción de actualización de una actualización de clúster activa.
Syntax
Update-ServiceFabricClusterUpgrade
[-ForceRestart <Boolean>]
[-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
[-UpgradeMode <RollingUpgradeMode>]
[-FailureAction <UpgradeFailureAction>]
[-HealthCheckRetryTimeoutSec <UInt32>]
[-HealthCheckWaitDurationSec <UInt32>]
[-HealthCheckStableDurationSec <UInt32>]
[-UpgradeDomainTimeoutSec <UInt32>]
[-UpgradeTimeoutSec <UInt32>]
[-ConsiderWarningAsError <Boolean>]
[-MaxPercentUnhealthyApplications <Byte>]
[-MaxPercentUnhealthyNodes <Byte>]
[-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
[-EnableDeltaHealthEvaluation <Boolean>]
[-MaxPercentDeltaUnhealthyNodes <Byte>]
[-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
[-Force]
[-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
[-InstanceCloseDelayDurationSec <UInt32>]
[-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
El cmdlet Update-ServiceFabricClusterUpgrade modifica los parámetros de una descripción de actualización del clúster mientras la actualización sigue activa. Service Fabric detecta y aplica los cambios según el valor FabricUpgradeStatusPollInterval , tal y como se especifica en el manifiesto del clúster. Excepto para las directivas de evaluación de estado, este cmdlet actualiza solo los parámetros que especifique. Los parámetros no especificados no se ven afectados. Debe actualizar las siguientes directivas de evaluación de estado juntas, no individualmente:
- ConsiderWarningAsError
- MaxPercentUnhealthyApplications
- MaxPercentUnhealthyNodes
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: Actualización de un valor para una actualización del clúster
PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0Este comando establece el período de tiempo de espera de comprobación del conjunto de réplicas en 0 para una actualización del clúster pendiente. La actualización deja solo todos los demás valores de actualización.
Ejemplo 2: Actualización de la directiva de mantenimiento para una actualización del clúster
PS C:\> $svcType = New-Object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
PS C:\> $svcType.MaxPercentUnhealthyPartitionsPerService = 100
PS C:\> $systemAppPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
PS C:\> $systemAppPolicy.DefaultServiceTypeHealthPolicy = $svcType
PS C:\> $appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
PS C:\> $appHealthPolicyMap.Add("fabric:/System", $systemAppPolicy)
PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)
PS C:\> Update-ServiceFabricClusterUpgrade -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -Force -MaxPercentUnhealthyApplications 20 -ApplicationHealthPolicyMap $appHealthPolicyMapEste comando cambia la directiva de mantenimiento del clúster de actualización del clúster. Especifica la asignación de directivas de mantenimiento de tipo de aplicación que contiene el tipo de aplicación CriticalAppType, que no tolera ningún error. El resto de las aplicaciones se evalúan con un 20 % de porcentaje máximo incorrecto.
El comando también actualiza la directiva de mantenimiento de la aplicación que se usa para evaluar la aplicación fabric:/System como parte de la evaluación del estado de actualización del clúster. Las nuevas directivas toleran todos los errores de partición.
Parámetros
-ApplicationHealthPolicyMap
Especifica un 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 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 con porcentajes específicos en lugar del porcentaje global 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 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 del 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 |
-Confirm
Le solicita su 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 informe de mantenimiento de advertencia como error durante la evaluación de estado.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableDeltaHealthEvaluation
Indica si se habilitan las comprobaciones de estado diferenciales durante la evaluación de estado en las actualizaciones supervisadas. Si especifica un valor de $True, Service Fabric toma una instantánea del estado al principio de la actualización. Una vez que cada dominio de actualización finalice la actualización, las comprobaciones de estado comparan el estado actual del clúster con la instantánea. Si hay una degradación del estado que no respeta los porcentajes máximos permitidos de la directiva de mantenimiento de actualización del clúster actual, se producirá un error en las comprobaciones de estado.
| Type: | Boolean |
| 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: | False |
| 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 si se debe reiniciar el nodo de Service Fabric incluso si solo han cambiado las configuraciones dinámicas.
| Type: | Boolean |
| Position: | Named |
| 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 reintenta 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 continuar con el siguiente dominio de actualización o completa la actualización. Esta duración de espera evita cambios de mantenimiento no detectados 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 tolerado de nodos incorrectos diferenciales que pueden tener estados de mantenimiento agregados de error. Si los nodos actuales incorrectos no respetan el porcentaje relativo al estado al principio de la actualización, el clúster es incorrecto.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUnhealthyApplications
Especifica el porcentaje máximo tolerado de las aplicaciones que pueden tener el estado de mantenimiento agregado del error. Si la actualización supera este porcentaje, el clúster es incorrecto.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUnhealthyNodes
Especifica el porcentaje máximo tolerado de nodos que pueden tener estados de mantenimiento agregados de error. Si una actualización supera este porcentaje, el clúster es incorrecto.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUpgradeDomainDeltaUnhealthyNodes
Especifica el porcentaje máximo tolerado de los nodos incorrectos de delta del dominio de actualización que pueden tener un estado de mantenimiento agregado de error. Si hay algún dominio de actualización en el que los nodos en mal estado actuales no respetan el porcentaje relativo al estado al principio de la actualización, el clúster es incorrecto.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NodeTypeHealthPolicyMap
Define un mapa con porcentajes máximos de nodos incorrectos para tipos de nodo 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 |
-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 |
-UpgradeDomainTimeoutSec
Especifica el tiempo máximo, en segundos, que Service Fabric tarda 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 |
-UpgradeMode
Especifica el nuevo UpgradeMode para la actualización.
| Type: | RollingUpgradeMode |
| Accepted values: | Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeReplicaSetCheckTimeoutSec
Especifica el tiempo máximo, en segundos, que Service Fabric espera a que una réplica establecida se vuelva a configurar en un estado seguro, si aún no está en un estado seguro, antes de que Service Fabric continúe con la actualización.
| Type: | UInt32 |
| Position: | Named |
| 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