Update-ServiceFabricClusterUpgrade
Modifica a descrição da atualização de uma atualização ativa do Cluster.
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
O cmdlet Update-ServiceFabricClusterUpgrade modifica os parâmetros de uma descrição de atualização do cluster enquanto a atualização ainda está ativa. O Service Fabric detecta e aplica as alterações de acordo com o valor FabricUpgradeStatusPollInterval , conforme especificado no manifesto do cluster. Exceto para políticas de avaliação de integridade, esse cmdlet atualiza apenas os parâmetros especificados. Os parâmetros não especificados permanecem não afetados. Você deve atualizar as seguintes políticas de avaliação de integridade em conjunto, não individualmente:
- ConsiderWarningAsError
- MaxPercentUnhealthyApplications
- MaxPercentUnhealthyNodes
Para gerenciar clusters do Service Fabric, comece Windows PowerShell usando a opção Executar como administrador. Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster .
Exemplos
Exemplo 1: Atualizar um valor para uma atualização de cluster
PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0Esse comando define o período de tempo limite de verificação do conjunto de réplicas como 0 para uma atualização de cluster pendente. A atualização deixa todos os outros valores de atualização sozinhos.
Exemplo 2: atualizar a política de integridade para uma atualização de cluster
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 $appHealthPolicyMapEsse comando altera a política de integridade do cluster de atualização do cluster. Ele especifica o mapa da política de integridade do tipo de aplicativo que contém o tipo de aplicativo CriticalAppType, que não tolera falhas. O restante dos aplicativos é avaliado usando o percentual máximo de 20% não íntegro.
O comando também atualiza a política de integridade do aplicativo usada para avaliar o aplicativo fabric:/System como parte da avaliação de integridade da atualização do cluster. As novas políticas toleram todos os erros de partição.
Parâmetros
-ApplicationHealthPolicyMap
Especifica um System.Fabric.Health.ApplicationHealthPolicyMap que inclui políticas de integridade personalizadas para alguns ou todos os aplicativos. Se você não especificar esse parâmetro ou se não incluir uma entrada no mapa de um aplicativo, esse aplicativo será avaliado com a política de integridade do aplicativo definida no manifesto do aplicativo, caso contrário, ou a política padrão.
| Type: | ApplicationHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeHealthPolicyMap
Especifica o mapa que define o percentual máximo de aplicativos não íntegros permitidos por tipo de aplicativo. Os tipos de aplicativo neste mapa são avaliados usando porcentagens específicas em vez do percentual global de MaxPercentUnhealthyApplications .
Por exemplo, se alguns aplicativos de um tipo são críticos, o administrador do cluster pode adicionar uma entrada no mapa para esse tipo de aplicativo e atribuir a ela um valor de 0% (ou seja, não tolerar falhas). Todos os outros aplicativos podem ser avaliados com MaxPercentUnhealthyApplications definido como 20% para tolerar algumas falhas de milhares de instâncias de aplicativo.
O mapa da política de integridade do tipo de aplicativo será usado somente se o manifesto do cluster habilitar a avaliação de integridade do tipo de aplicativo usando a entrada de configuração para HealthManager/EnableApplicationTypeHealthEvaluation.
| Type: | ApplicationTypeHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConsiderWarningAsError
Indica se um relatório de integridade de aviso deve ser tratado como um erro durante a avaliação de integridade.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableDeltaHealthEvaluation
Indica se é necessário habilitar verificações de integridade delta durante a avaliação de integridade em atualizações monitoradas. Se você especificar um valor de $True, o Service Fabric tira um instantâneo da integridade no início da atualização. Depois que cada domínio de atualização concluir a atualização, as verificações de integridade comparam o estado atual do cluster com o instantâneo. Se houver degradação de integridade que não respeite os percentuais máximos de permissão da política de integridade de atualização do cluster atual, as verificações de integridade falharão.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailureAction
Especifica a ação a ser executada se a atualização monitorada falhar. Os valores aceitáveis para esse parâmetro são:
- Reversão
- 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 esse cmdlet ignora a mensagem de aviso e força a atualização.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceRestart
Indica se o nó do Service Fabric deve ser reiniciado, mesmo que apenas as configurações dinâmicas tenham sido alteradas.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HealthCheckRetryTimeoutSec
Especifica a duração, em segundos, após a qual o Service Fabric tenta novamente a verificação de integridade se a verificação de integridade anterior falhar.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HealthCheckStableDurationSec
Especifica a duração, em segundos, que o Service Fabric aguarda para verificar se o cluster está estável antes de continuar para o próximo domínio de atualização ou concluir a atualização. Essa duração de espera impede alterações não detectadas de integridade logo após a verificação de integridade ser executada.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HealthCheckWaitDurationSec
Especifica a duração, em segundos, que o Service Fabric aguarda antes de executar a verificação de integridade inicial depois de concluir a atualização no domínio de atualização.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceCloseDelayDurationSec
Especifica a duração em segundos, aguardar até que uma instância sem estado afetada pela atualização do cluster seja fechada, para permitir que as solicitações ativas sejam drenadas normalmente. Essa duração de espera é efetiva apenas para as instâncias desses serviços sem estado que têm um valor diferente de zero configurado para o InstanceCloseDelayDuration e substituirão o valor pré-configurado. Consulte InstanceCloseDelayDuration para obter detalhes.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentDeltaUnhealthyNodes
Especifica o percentual máximo tolerado de nós não íntegros delta que podem ter estados de integridade agregados de erro. Se os nós não íntegros atuais não respeitarem o percentual em relação ao estado no início da atualização, o cluster não estará íntegro.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUnhealthyApplications
Especifica o percentual máximo tolerado de aplicativos que podem ter estado de integridade agregado de erro. Se a atualização exceder esse percentual, o cluster não estará íntegro.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUnhealthyNodes
Especifica o percentual máximo tolerado de nós que podem ter estados de integridade agregados de erro. Se uma atualização exceder esse percentual, o cluster não estará íntegro.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPercentUpgradeDomainDeltaUnhealthyNodes
Especifica a porcentagem máxima tolerada de nós não íntegros do delta do domínio de atualização que podem ter estado de integridade agregado de erro. Se houver algum domínio de atualização em que os nós não íntegros atuais não respeitem a porcentagem em relação ao estado no início da atualização, o cluster não estará íntegro.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NodeTypeHealthPolicyMap
Define um mapa com percentuais máximos de nós não íntegros para tipos de nó específicos.
O mapa da política de integridade de tipo de nó pode ser usado durante a avaliação de integridade do cluster para descrever tipos especiais de nós. Os tipos de nó incluídos no mapa são avaliados em relação ao percentual incluído no mapa e também com o global (consulte System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Os nós de tipos de nó especificados no mapa também são contados em relação ao pool global de nós; são verificações independentes.
| Type: | NodeTypeHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutSec
Especifica o período de tempo limite, em segundos, para a operação.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeDomainTimeoutSec
Especifica o tempo máximo, em segundos, que o Service Fabric leva para atualizar um único domínio de atualização. Após esse período, a atualização falhará.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeMode
Especifica o novo UpgradeMode para a atualização.
| 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 o tempo máximo, em segundos, que o Service Fabric aguarda uma réplica definida para reconfigurar em um estado seguro, se ainda não estiver em um estado seguro, antes que o Service Fabric prossiga com a atualização.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpgradeTimeoutSec
Especifica o tempo máximo, em segundos, que o Service Fabric leva para toda a atualização. Após esse período, a atualização falhará.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
None
Saídas
System.Object