Partilhar via

Update-ServiceFabricClusterUpgrade

  • Referência
Módulo:
ServiceFabric

Modifica a descrição da 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 deteta 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 inalterados. Você deve atualizar as seguintes políticas de avaliação de saúde 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

Este 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

Este comando altera a diretiva de integridade do cluster de atualização. Ele especifica o mapa de diretiva de integridade do tipo de aplicativo que contém o tipo de aplicativo CriticalAppType, que não tolera falhas. O resto das aplicações são avaliadas usando 20% porcentagem máxima insalubre.

O comando também atualiza a política de integridade do aplicativo usada para avaliar o aplicativo fabric:/System como parte da avaliação da 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 diretiva de integridade do aplicativo definida no manifesto do aplicativo, se existir, ou com a política padrão de outra forma.

Tipo:ApplicationHealthPolicyMap
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationTypeHealthPolicyMap

Especifica o mapa que define a porcentagem máxima de aplicativos não íntegros permitidos por tipo de aplicativo. Os tipos de aplicativos neste mapa são avaliados usando porcentagens específicas em vez da global MaxPercentUnhealthyApplications porcentagem.

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

O mapa da diretiva de integridade do tipo de aplicativo será usado somente se o manifesto do cluster habilitar a avaliação da integridade do tipo de aplicativo usando a entrada de configuração para HealthManager/EnableApplicationTypeHealthEvaluation.

Tipo:ApplicationTypeHealthPolicyMap
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ConsiderWarningAsError

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

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EnableDeltaHealthEvaluation

Indica se as verificações de integridade delta devem ser habilitadas durante a avaliação de integridade em atualizações monitoradas. Se você especificar um valor de $True, o Service Fabric tirará um instantâneo da integridade no início da atualização. Depois que cada domínio de atualização conclui 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 as porcentagens máximas permitidas da diretiva de integridade de atualização do cluster atual, as verificações de integridade falharão.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 aceites:Invalid, Rollback, Manual
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 evita alterações de integridade não detetadas logo após a verificação de integridade ser executada.

Tipo:UInt32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InstanceCloseDelayDurationSec

Especifica a duração, em segundos, para aguardar até que uma instância sem estado afetada pela atualização de cluster seja fechada, para permitir que as solicitações ativas sejam drenadas normalmente. Essa duração de espera é efetiva somente para as instâncias dos serviços sem monitoração de estado que têm um valor diferente de zero configurado para InstanceCloseDelayDuration e substituirão o valor pré-configurado. Consulte InstanceCloseDelayDuration para obter detalhes.

Tipo:UInt32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaxPercentDeltaUnhealthyNodes

Especifica a porcentagem máxima tolerada de nós não íntegros delta que podem ter estados de erro de integridade agregados. 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaxPercentUnhealthyApplications

Especifica a porcentagem máxima tolerada de aplicativos que podem ter estado de erro de integridade agregado. Se a atualização exceder essa porcentagem, o cluster não estará íntegro.

Tipo:Byte
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaxPercentUnhealthyNodes

Especifica a porcentagem máxima tolerada de nós que podem ter estados de erro de integridade agregados. Se uma atualização exceder essa porcentagem, o cluster não estará íntegro.

Tipo:Byte
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Especifica a porcentagem máxima tolerada de nós não íntegros delta do domínio de atualização que podem ter estado de erro de integridade agregado. 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NodeTypeHealthPolicyMap

Define um mapa com porcentagens máximas 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 à porcentagem incluída no mapa e também com o global (consulte System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Os nós dos tipos de nós especificados no mapa também são contados em relação ao pool global de nós; trata-se de controlos independentes.

Tipo:NodeTypeHealthPolicyMap
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TimeoutSec

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UpgradeMode

Especifica o novo UpgradeMode para a atualização.

Tipo:RollingUpgradeMode
Valores aceites:Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UpgradeReplicaSetCheckTimeoutSec

Especifica o tempo máximo, em segundos, que o Service Fabric aguarda que um conjunto de réplicas seja 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

System.Object