Compartilhar via

Update-ServiceFabricApplication

  • Referência
Módulo:
ServiceFabric

Atualizações ou remove a capacidade do aplicativo.

Syntax

Update-ServiceFabricApplication
      [-ApplicationName] <Uri>
      [-RemoveApplicationCapacity]
      [-MaximumNodes <Int64>]
      [-MinimumNodes <Int64>]
      [-Metrics <String[]>]
      [-TimeoutSec <Int32>]
      [<CommonParameters>]

Description

O cmdlet Update-ServiceFabricApplication atualiza ou remove a capacidade do aplicativo para um aplicativo que já foi criado.

A capacidade do aplicativo define os nós máximo/mínimo para um aplicativo, bem como a capacidade por nó para suas métricas.

Exemplos

Exemplo 1: Atualizar MaximumNodes e Métricas

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @("CPU,2,12,16")

Esse comando atualiza a malha do aplicativo:/MyApp para usar no máximo seis nós. Cada nó tem uma carga reservada de duas unidades e uma carga máxima de 12 unidades para a métrica da CPU em cada nó. A capacidade total do aplicativo é de 16 unidades para a métrica da CPU. O valor de MinimumNodes permanece inalterado.

Exemplo 2: Atualizar MaximumNodes e redefinir métricas

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @()

Esse comando atualiza a malha do aplicativo:/MyApp para usar um máximo de seis nós e remove capacidades para todas as métricas. Se houver alguma capacidade definida anteriormente, elas serão desmarcadas após esse comando. O valor de MinimumNodes permanece inalterado.

Exemplo 3: Atualizar todos os parâmetros de capacidade do aplicativo

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MinumumNodes 2 -MaximumNodes 6 -Metrics @("CPU,2,12,16")

Esse comando atualiza a malha do aplicativo:/MyApp para usar no máximo seis nós. Cada nó tem uma carga reservada de duas unidades e uma carga máxima de 12 unidades para a CPU de métrica em cada nó. A capacidade total do aplicativo é de 16 unidades para a métrica da CPU. O valor para nós mínimos é atualizado para 2, para que o Service Fabric reserve uma capacidade total de quatro unidades para a métrica da CPU no cluster.

Exemplo 4: Remover todos os parâmetros de capacidade do aplicativo

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -RemoveApplicationCapacity

Esse comando atualiza a malha do aplicativo:/MyApp para que ele não tenha nenhum parâmetro de capacidade do aplicativo definido. Se o MyApp tiver parâmetros de capacidade definidos anteriormente, essa operação os limpará.

Parâmetros

-ApplicationName

Especifica o nome do aplicativo a ser atualizado.

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

-MaximumNodes

Especifica o número máximo de nós nos quais um aplicativo será colocado. O valor desse parâmetro deve ser um inteiro não negativo. O valor padrão é 0, o que indica que o aplicativo pode ser colocado em qualquer número de nós no cluster.

Se você não especificar esse parâmetro, o aplicativo usará o número máximo existente de nós definidos para o aplicativo.

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

-Metrics

Especifica uma matriz de métricas. Essas métricas são usadas pelo Cluster do Service Fabric Resource Manager para gerenciar recursos no cluster. Para obter mais informações sobre métricas e gerenciamento de recursos no Service Fabric, consulte o Cluster do Service Fabric Resource Manager Introdução. Cada métrica pode seguir o padrão MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity ou pode especificar MetricName e usar nomes de parâmetro NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity seguido por um valor de parâmetro separado com dois-pontos. Cada par nome do parâmetro:valor pode aparecer no máximo uma vez.

  • MetricName. Especifica o nome da métrica.
  • NodeReservationCapacity. Especifica a quantidade de carga de métrica reservada em nós que têm instâncias desse aplicativo. Se MinimumNodes for especificado, o produto desses valores será a capacidade reservada no cluster para o aplicativo.
  • MaximumNodeCapacity. Especifica a carga máxima para uma instância desse aplicativo em um único nó. Mesmo que a capacidade do nó seja maior que esse valor, o Service Fabric limitará a carga total das réplicas filho do aplicativo a esse valor.
  • TotalApplicationCapacity. Especifica a capacidade total do aplicativo no cluster. O Service Fabric tenta limitar a soma das cargas das réplicas filho do aplicativo a esse valor.

Ao atualizar a capacidade, o Service Fabric executa as seguintes validações e falhará no comando se elas não forem aprovadas:

  • NodeReservationCapacity não deve ser maior que MaximumNodeCapacity.
  • Se o parâmetro MinimumNodes e a métrica NodeReservationCapacity forem especificados, o produto de MinimumNodes e NodeReservationCapacity não deverá ser maior que TotalApplicationCapacity.
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumNodes

Especifica o número de nós em um cluster no qual a capacidade está reservada para este aplicativo, isso não significa que o aplicativo tem a garantia de ter réplicas em todos esses nós. O valor desse parâmetro deve ser um inteiro não negativo. O valor padrão para isso é zero, o que significa que nenhuma capacidade é reservada para o aplicativo.

Se MinimumNodes estiver definido como 0, nenhuma capacidade será reservada.

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

-RemoveApplicationCapacity

Indica que essa operação limpa todos os parâmetros relacionados à capacidade do aplicativo para o aplicativo. Se você especificar esse parâmetro, não poderá especificar o parâmetro Metrics para atualizar a capacidade do aplicativo.

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

-TimeoutSec

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

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

Entradas

None

Saídas

System.Object