Compartilhar via

Update-ServiceFabricApplication

  • Referência
Módulo:
ServiceFabric

Atualizações ou remove a capacidade do aplicativo.

Sintaxe

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.

Tipo:Uri
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.
Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeoutSec

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object