Share via


Start-ServiceFabricClusterUpgrade

Melhora um cluster de tecido de serviço.

Syntax

Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

O cmdlet Start-ServiceFabricClusterUpgrade atualiza um cluster de Tecido de Serviço. Pode atualizar o código, configuração ou configuração do Tecido de Serviço.

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: Iniciar a atualização manual não monitorizada

PS C:\> Start-ServiceFabricClusterUpgrade -CodePackageVersion "2.0.59.0" -ClusterManifestVersion "v2" -UnmonitoredManual

Este comando inicia a atualização manual não monitorizada para o pacote de código especificado e configuração.

Exemplo 2: Iniciar a atualização apenas para código

PS C:\> Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion "2.0.59.0" -UnmonitoredAuto

Este comando inicia a atualização automática não monitorizada para o pacote de código especificado. Não há nenhuma atualização de configuração.

Exemplo 3: Iniciar config apenas atualizar

Start-ServiceFabricClusterUpgrade -ClusterManifestVersion "v2" -Config -FailureAction Rollback -Monitored

Este comando inicia a atualização do config monitorizado apenas para a versão manifesto do cluster especificado. A atualização utiliza políticas de saúde predefinidas e a ação de falha é especificada como Rollback.

Exemplo 4: Iniciar a atualização com uma política de saúde personalizada

PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)

PS C:\> $svcType = New-Object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
PS C:\> $svcType.MaxPercentUnhealthyPartitionsPerService = 20
PS C:\> $svcType.MaxPercentUnhealthyReplicasPerPartition = 20
PS C:\> $warningAsErrorPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
PS C:\> $warningAsErrorPolicy.ConsiderWarningAsError = $true
PS C:\> $warningAsErrorPolicy.DefaultServiceTypeHealthPolicy = $svcType

PS C:\> $appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
PS C:\> $appHealthPolicyMap.Add("fabric:/System", $warningAsErrorPolicy)

PS C:\> Start-ServiceFabricClusterUpgrade -CodePackageVersion "4.2.83.9493" -ClusterManifestVersion "ScaleMin-1.0" -Monitored -FailureAction Rollback -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -Force -MaxPercentUnhealthyNodes 20 -MaxPercentUnhealthyApplications 20 -ApplicationHealthPolicyMap $appHealthPolicyMap

Este comando inicia a atualização monitorizada para o pacote de código especificado e configuração e passa por políticas de saúde personalizadas. Especifica uma política de saúde personalizada do cluster, define um MaxPercentUnhealthyApplicações diferentes para um tipo crítico de aplicação e uma política de saúde de aplicação personalizada para a aplicação do Cluster System.

Parâmetros

-ApplicationHealthPolicyMap

Especifica um objeto 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 da aplicação se existir, ou a política de saúde padrão de outra forma.

Type:ApplicationHealthPolicyMap
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 especificada no parâmetro 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 o parâmetro MaxPercentUnhealthyApplications definido 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.

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

-ClusterManifestVersion

Especifica a versão armazenada num manifesto de cluster de Tecido de Serviço.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Code

Indica que o pacote inclui apenas um ficheiro de .msi de tecido de serviço.

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

-CodePackageVersion

Especifica a versão do ficheiro .msi de Tecido de Serviço.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Config

Indica que o pacote é um manifesto de cluster de tecido de serviço.

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

-Confirm

Solicita a 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 evento de saúde de alerta como um evento de erro durante a avaliação de saúde da entidade do cluster e das entidades nódes. As aplicações são avaliadas utilizando as definições de política de saúde por aplicação.

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

-EnableDeltaHealthEvaluation

Indica que a avaliação da saúde delta é usada para determinar se o cluster de Tecido de Serviço é saudável.

Type:SwitchParameter
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:True
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 que o anfitrião de serviço reinicia mesmo que a atualização seja uma alteração apenas de configuração.

Type:SwitchParameter
Position:2
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 o cluster está estável antes de passar 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 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.

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

-MaxPercentDeltaUnhealthyNodes

Especifica a percentagem máxima de nós não saudáveis delta que podem ter estados de erro agregados. Se os atuais nós insalubres não respeitarem a percentagem relativa ao Estado no início da atualização, o cluster é considerado insalubre.

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

-MaxPercentUnhealthyApplications

Especifica a percentagem máxima de aplicações que podem ter estados de erro agregados de saúde. Se as aplicações atualmente pouco saudáveis não respeitarem este montante, o cluster é considerado pouco saudável.

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

-MaxPercentUnhealthyNodes

Especifica a percentagem máxima de nós que podem ter estados de erro agregados de saúde. Se as atuais aplicações não saudáveis não respeitarem esta percentagem, o cluster é considerado insalubre.

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

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

Especifica a percentagem máxima de upgrade delta nós não saudáveis que podem ter estados de erro agregados de saúde. 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 é considerado insalubre.

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

-Monitored

Indica que o modo de atualização é monitorizado. Isto significa que os controlos de saúde são realizados após a atualização para um domínio de upgrade. Se a saúde do domínio de upgrade e do cluster cumprir as políticas de saúde especificadas, o Service Fabric inicia a atualização do próximo domínio de atualização. Se o domínio ou cluster de atualização não cumprir as políticas de saúde, a atualização falha e o Tecido de Serviço reverte a atualização ou muda para o modo manual não monitorizado, dependendo da Falha de Falha especificada.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

-ReplicaQuorumTimeoutSec

Especifica o período de tempo de ício, em segundos, para verificar se o conjunto de réplicas tem quórum. Após o período de tempo de ício, a atualização prossegue.

Este parâmetro foi depreciado. Em vez disso, especifique o parâmetro UpgradeReplicaSetCheckTimeoutSec .

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

-RestartProcess

Indica que o anfitrião de serviço reinicia como parte da atualização.

Este parâmetro foi depreciado. Em vez disso, especifique o parâmetro ForceRestart .

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

-SortOrder

Define a ordem pela qual uma atualização procede através do cluster.

Os valores possíveis são:

  • Invalid - Indica que esta ordem não é válida. Todas as enumerações de Tecido de Serviço têm o tipo inválido.
  • Default - Indica que a ordem de classificação predefinida (conforme especificado no manifesto de cluster) será utilizada.
  • Numeric - Indica que será utilizada a ordem de classificação numérica avançada (nomes de UD classificados como números).
  • Lexicographical - Indica que será utilizada a ordem de classificação lexicográfica para a frente (nomes de UD classificados como cordas).
  • ReverseNumeric - Indica que será utilizada a ordem de classificação numérica inversa (nomes de UD classificados como números).
  • ReverseLexicographical- Indica que será utilizada a ordem de classificação lexicográfica inversa (nomes de UD classificados como cordas).
Type:UpgradeSortOrder
Accepted values:Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:4
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

-UnmonitoredAuto

Indica que o modo de atualização não é monitorizado automaticamente. Não são realizados controlos de saúde e após o Service Fabric atualizar um domínio de upgrade, o Service Fabric inicia a atualização do próximo domínio de atualização, independentemente do estado de saúde do cluster. Este modo não é recomendado para utilização de produção.

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

-UnmonitoredManual

Indica que o modo de atualização não é monitorizado manualmente. Depois de o Service Fabric atualizar um domínio de atualização, aguarda que o cmdlet Resume-ServiceFabricClusterUpgrade inicie explicitamente a atualização do próximo domínio de atualização.

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

-UpgradeDomainTimeoutSec

Especifica o tempo máximo, em segundos, que o Service Fabric pode demorar a 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

-UpgradeReplicaSetCheckTimeoutSec

Especifica o tempo máximo que o Service Fabric espera que uma partição esteja num estado seguro, se não já em estado seguro. Uma vez que as verificações de segurança passam para todas as divisórias num nó, o Service Fabric procede com a atualização desse nó.

Type:UInt32
Position:3
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