Update-ServiceFabricClusterUpgrade
Modifica a descrição de atualização de uma atualização ativa do Cluster.
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 da atualização do cluster enquanto a atualização ainda está ativa. O Tecido de Serviço deteta e aplica as alterações de acordo com o valor FabricUpgradeStatusPollInterval , conforme especificado no manifesto de 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
- MaxPercentUnhealthyApplicações
- MaxPercentUnhealthyNodes
Para gerir os clusters de Tecido de Serviço, comece Windows PowerShell utilizando a opção Executar como administrador. 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 cluster
PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0
Este comando define o período de tempo de verificação da réplica para 0 para uma atualização pendente do cluster. A atualização deixa todos os outros valores de upgrade em paz.
Exemplo 2: Atualizar a política de saúde 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 política de saúde do cluster upgrade do cluster. Especifica o mapa de política de saúde do tipo de aplicação que contém o tipo de aplicação CriticalAppType, que não tolera quaisquer falhas. O resto das aplicações são avaliadas usando 20% de insalubres.
O comando também atualiza a política de saúde da aplicação usada para avaliar a aplicação do tecido:/Aplicação do sistema como parte da avaliação de saúde de upgrade 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 saúde personalizadas para algumas ou todas as aplicações. Se não especificar este parâmetro, ou se não incluir uma entrada no mapa para uma aplicação, essa aplicação é avaliada com a política de saúde da aplicação definida no manifesto de aplicação se existir, ou a política de incumprimento em contrário.
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 percentagem máxima de aplicações não saudáveis que são permitidas por tipo de aplicação. Os tipos de aplicações neste mapa são avaliados usando percentagens específicas em vez da percentagem global de MaxPercentUnhealthyApplications .
Por exemplo, se algumas aplicações de um tipo forem críticas, o administrador de cluster pode adicionar uma entrada no mapa para esse tipo de aplicação e atribuir-lhe um valor de 0% (ou seja, não tolerar quaisquer falhas). Todas as outras aplicações podem ser avaliadas com MaxPercentUnhealthyApplicações definidas para 20% para tolerar algumas falhas em milhares de instâncias de aplicação.
O mapa da política de saúde do tipo de aplicação só é utilizado se o manifesto do cluster permitir uma avaliação de saúde tipo de aplicação utilizando 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 a sua 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 deve tratar um relatório de saúde de aviso como erro durante a avaliação de saúde.
Tipo: | Boolean |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-EnableDeltaHealthEvaluation
Indica se permite controlos de saúde delta durante a avaliação de saúde em atualizações monitorizadas. Se especificar um valor de $True, a Service Fabric tira uma foto da saúde no início da atualização. Após cada domínio de atualização terminar a atualização, os controlos de saúde comparam o estado atual do cluster com o instantâneo. Se houver uma degradação da saúde que não respeite o máximo de percentagens da atual política de saúde de upgrade do cluster, os controlos de saúde falham.
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 tomar se a atualização monitorizada 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 este 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 deve reiniciar o nó de Tecido de Serviço mesmo que apenas as configurações dinâmicas tenham mudado.
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 o qual o Service Fabric retira o exame de saúde se o exame de saúde 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 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.
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 efetuar a verificação de saúde inicial depois de terminar a atualização no domínio da 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 que uma instância apátrida que seja impactada pela atualização do cluster seja fechada, 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.
Tipo: | UInt32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-MaxPercentDeltaUnhealthyNodes
Especifica a percentagem máxima tolerada de nós não saudáveis delta que pode ter estados de erro agregados. Se os atuais nós não saudáveis não respeitarem a percentagem relativa ao Estado no início da atualização, o cluster não é saudável.
Tipo: | Byte |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-MaxPercentUnhealthyApplications
Especifica a percentagem máxima tolerada de aplicações que podem ter um estado de erro de saúde agregado. Se a atualização exceder esta percentagem, o cluster não é saudável.
Tipo: | Byte |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-MaxPercentUnhealthyNodes
Especifica a percentagem máxima tolerada de nós que podem ter estados de erro agregados. Se uma atualização exceder esta percentagem, o cluster não é saudável.
Tipo: | Byte |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-MaxPercentUpgradeDomainDeltaUnhealthyNodes
Especifica a percentagem máxima tolerada de nós delta de upgrade que podem ter um estado de erro de saúde agregado. Se houver algum domínio de upgrade onde os atuais nós não saudáveis não respeitem a percentagem relativa ao estado no início da atualização, o cluster não é saudável.
Tipo: | Byte |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-NodeTypeHealthPolicyMap
Define um mapa com percentagens máximas de nós insalubres para tipos específicos de nós.
O mapa da política de saúde do tipo nó pode ser usado durante a avaliação da saúde do cluster para descrever tipos especiais de nó. Os tipos de nós incluídos no mapa são avaliados em função da percentagem incluída no mapa, e também com o global (ver System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Os nós de nós especificados no mapa também são contados contra o conjunto global de nós; são cheques 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 de ício, 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 este período, a atualização falha.
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 espera que uma réplica definida para reconfigurar em estado seguro, se ainda não estiver em estado seguro, antes de o Service Fabric prosseguir 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 este período, a atualização falha.
Tipo: | UInt32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. 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