Update-ServiceFabricClusterUpgrade

  • Referência
Módulo:
ServiceFabric

Modifica a descrição de atualização de uma atualização de Cluster ativa.

Sintaxe

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 de 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. Com exceção das políticas de avaliação de integridade, esse cmdlet atualiza apenas os parâmetros especificados. 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, inicie o 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 0

Esse 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 $appHealthPolicyMap

Esse 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 20% percentual máximo 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.

Tipo:ApplicationHealthPolicyMap
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 percentuais específicos em vez do global MaxPercentUnhealthyApplications percentual.

Por exemplo, se alguns aplicativos de um tipo forem críticos, o administrador do cluster poderá adicionar uma entrada ao mapa para esse tipo de aplicativo e atribuir a ele 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 de 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.

Tipo:ApplicationTypeHealthPolicyMap
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConsiderWarningAsError

Indica se um relatório de integridade de aviso deve ser tratado como erro durante a avaliação da integridade.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 da 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.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FailureAction

Especifica a ação a ser executada se a atualização monitorada falhar. Os valores aceitáveis para este parâmetro são:

  • Reversão
  • Manual.
Tipo:UpgradeFailureAction
Valores aceitos:Invalid, Rollback, Manual
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Indica que esse cmdlet ignora a mensagem de aviso e força a atualização.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceRestart

Indica se o nó do Service Fabric deve ser reiniciado, mesmo que apenas as configurações dinâmicas tenham sido alteradas.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 na integridade logo após a verificação de integridade ser executada.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 a porcentagem relativa ao estado no início da atualização, o cluster não estará íntegro.

Tipo:Byte
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Byte
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Byte
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Especifica o percentual máximo tolerado de nós não íntegros 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 relativa ao estado no início da atualização, o cluster não estará íntegro.

Tipo:Byte
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 do tipo de nó pode ser usado durante a avaliação da integridade do cluster para descrever tipos de nó especiais. 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 dos tipos de nó especificados no mapa também são contados no pool global de nós; são verificações independentes.

Tipo:NodeTypeHealthPolicyMap
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeoutSec

Especifica o período de tempo limite, em segundos, para a operação.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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á.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpgradeMode

Especifica o novo UpgradeMode para a atualização.

Tipo:RollingUpgradeMode
Valores aceitos:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpgradeReplicaSetCheckTimeoutSec

Especifica o tempo máximo, em segundos, que o Service Fabric aguarda um conjunto de réplicas ser reconfigurado em um estado seguro, se ainda não estiver em um estado seguro, antes que o Service Fabric prossiga com a atualização.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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á.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object