Partilhar via

Update-ServiceFabricApplication

  • Referência
Módulo:
ServiceFabric

Atualiza 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áximos/mínimos 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")

Este comando atualiza a malha do aplicativo:/MyApp para usar um máximo de 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 para MinimumNodes permanece inalterado.

Exemplo 2: Atualizar MaximumNodes e redefinir métricas

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

Este 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 capacidades previamente definidas, elas são limpas após este comando. O valor para MinimumNodes não é alterado.

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")

Este comando atualiza a malha do aplicativo:/MyApp para usar um máximo de seis nós. Cada nó tem uma carga reservada de duas unidades e uma carga máxima de 12 unidades para a CPU 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

Este 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 algum parâmetro de capacidade definido anteriormente, esta operação os limpa.

Parâmetros

-ApplicationName

Especifica o nome do aplicativo a ser atualizado.

Tipo:Uri
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaximumNodes

Especifica o número máximo de nós nos quais colocar um aplicativo. O valor deste parâmetro deve ser um número 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Metrics

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

  • MetricName. Especifica o nome da métrica.
  • NodeReservationCapacity. Especifica a quantidade de carga métrica reservada em nós que têm instâncias deste 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 deste aplicativo em um único nó. Mesmo que a capacidade do nó seja maior que esse valor, o Service Fabric limita a carga total das réplicas filhas 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 filhas 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 passarem:

  • NodeReservationCapacity não deve ser mais do que MaximumNodeCapacity.
  • Se o parâmetro MinimumNodes e a métrica NodeReservationCapacity forem especificados, o produto de MinimumNodes e NodeReservationCapacity não deverá ser superior a TotalApplicationCapacity.
Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MinimumNodes

Especifica o número de nós em um cluster no qual a capacidade é 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 deste parâmetro deve ser um número inteiro não negativo. O valor padrão para isso é zero, o que significa que nenhuma capacidade está reservada para o aplicativo.

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

Tipo:Int64
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TimeoutSec

Especifica o período de tempo limite, 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

Entradas

None

Saídas

System.Object