Update-ServiceFabricApplicationUpgrade

  • Referência
Módulo:
ServiceFabric

Modifica a descrição da atualização de uma atualização ativa da Aplicação.

Syntax

Update-ServiceFabricApplicationUpgrade
      [-ApplicationName] <Uri>
      [-ForceRestart <Boolean>]
      [-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
      [-UpgradeMode <RollingUpgradeMode>]
      [-FailureAction <UpgradeFailureAction>]
      [-HealthCheckRetryTimeoutSec <UInt32>]
      [-HealthCheckWaitDurationSec <UInt32>]
      [-HealthCheckStableDurationSec <UInt32>]
      [-UpgradeDomainTimeoutSec <UInt32>]
      [-UpgradeTimeoutSec <UInt32>]
      [-ConsiderWarningAsError <Boolean>]
      [-DefaultServiceTypeHealthPolicy <String>]
      [-MaxPercentUnhealthyDeployedApplications <Byte>]
      [-ServiceTypeHealthPolicyMap <Hashtable>]
      [-Force]
      [-InstanceCloseDelayDurationSec <UInt32>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Update-ServiceFabricApplicationUpgrade modifica os parâmetros de uma descrição da atualização da aplicação enquanto a atualização ainda está ativa. O Tecido de Serviço deteta e aplica alterações de acordo com o valor UpgradeStatusPollInterval , conforme especificado no manifesto do cluster. Com exceção das políticas de avaliação da saúde, este cmdlet atualiza apenas os parâmetros que especifica. Os parâmetros não especificados permanecem inalterados. Deve atualizar em conjunto as seguintes políticas de avaliação da saúde, não individualmente:

  • ConsidereWarningAsError
  • DefaultServiceTypeHealthPolicy
  • MaxPercentUnhealthyDeployedApplicações
  • ServiceTypeHealthPolicyMap

Antes de efetuar qualquer operação num cluster de tecido de serviço, estabeleça uma ligação ao cluster utilizando o cmdlet Connect-ServiceFabricCluster .

Exemplos

Exemplo 1: Atualizar um valor para uma atualização de aplicação

PS C:\> Update-ServiceFabricApplicationUpgrade -ApplicationName fabric:/MyApplication -UpgradeReplicaSetCheckTimeoutSec 0

Este comando define o valor de tempo de verificação definido da réplica para 0 para uma atualização pendente no tecido:/MyApplication. A atualização deixa todos os outros valores de upgrade em paz.

Parâmetros

-ApplicationName

Especifica o Identificador de Recursos Uniforme (URI) de uma aplicação de Tecido de Serviço. O cmdlet atualiza as definições para a atualização da aplicação que tem o URI que este parâmetro especifica.

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

-Confirm

Solicita a 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 deve tratar um relatório de saúde de aviso como erro durante a avaliação de saúde.

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

-DefaultServiceTypeHealthPolicy

Especifica a política de saúde padrão para os tipos de serviço. A política de saúde é utilizada para a atualização monitorizada. A política segue o formato MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices. Por exemplo, 5,10,15 indica os seguintes valores:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailureAction

Especifica a ação a tomar se a atualização monitorizada falhar. Os valores aceitáveis para este 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 este 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 anfitrião de serviço reinicia mesmo que a atualização seja uma alteração apenas de configuração.

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 o qual o Service Fabric retira o exame de saúde se o exame de saúde 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 a aplicação é estável antes de continuar para o domínio de atualização seguinte ou completar a atualização. Esta duração de espera evita alterações de saúde não detetadas logo após a verificação de saúde.

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 efetuar a verificação de saúde inicial depois de terminar a atualização no domínio da 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, para aguardar que uma instância apátrida que seja impactada pela atualização da aplicação seja encerrada, para permitir que os pedidos ativos drene graciosamente. Esta duração de espera só é eficaz para os casos dos serviços apátridas que têm um valor não nulo configurado para a InstanceCloseDelayDuration, e que sobreporão ao valor pré-configurado. Consulte InstanceCloseDelayDuration para mais detalhes.

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

-MaxPercentUnhealthyDeployedApplications

Especifica a percentagem máxima de aplicações implementadas toleradas que podem ter um estado de erro na saúde. Se a percentagem de instâncias de aplicação pouco saudáveis implementadas nos nós do cluster exceder o valor que este parâmetro especifica, o estado de saúde da aplicação é erro.

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

-ServiceTypeHealthPolicyMap

Especifica o mapa da política de saúde a utilizar para diferentes tipos de serviço. Especificar o mapa como uma tabela hash no seguinte formato: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyService"}. Por exemplo:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

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

-TimeoutSec

Especifica o período de tempo de ício, 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 este período, a atualização falha.

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 espera que um serviço se reconfigure em estado seguro, se não já em estado seguro, antes de o Service Fabric prosseguir 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 este período, a atualização falha.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. 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