Compartir a través de

Update-ServiceFabricApplication

  • Referencia
Módulo:
ServiceFabric

Novedades o quita la capacidad de la aplicación.

Syntax

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

Description

El cmdlet Update-ServiceFabricApplication actualiza o quita la capacidad de la aplicación para una aplicación que ya se ha creado.

La capacidad de la aplicación define los nodos máximos y mínimos de una aplicación, así como la capacidad por nodo para sus métricas.

Ejemplos

Ejemplo 1: Actualización de MaximumNodes y métricas

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

Este comando actualiza application fabric:/MyApp para usar un máximo de seis nodos. Cada nodo tiene una carga reservada de dos unidades y una carga máxima de 12 unidades para la métrica de CPU en cada nodo. La capacidad total de la aplicación es de 16 unidades para la métrica de CPU. El valor de MinimumNodes permanece sin cambios.

Ejemplo 2: Actualización de MaximumNodes y restablecimiento de métricas

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

Este comando actualiza application fabric:/MyApp para usar un máximo de seis nodos y quita las capacidades de todas las métricas. Si hay alguna capacidad definida previamente, se borran después de este comando. El valor de MinimumNodes no cambia.

Ejemplo 3: Actualización de todos los parámetros de capacidad de la aplicación

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

Este comando actualiza application fabric:/MyApp para usar un máximo de seis nodos. Cada nodo tiene una carga reservada de dos unidades y una carga máxima de 12 unidades para la CPU de métrica en cada nodo. La capacidad total de la aplicación es de 16 unidades para la métrica de CPU. El valor de los nodos mínimos se actualiza a 2, por lo que Service Fabric reserva una capacidad total de cuatro unidades para la métrica de CPU del clúster.

Ejemplo 4: Eliminación de todos los parámetros de capacidad de la aplicación

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

Este comando actualiza application fabric:/MyApp para que no tenga ningún parámetro de capacidad de aplicación definido. Si MyApp tenía algún parámetro de capacidad establecido anteriormente, esta operación los borra.

Parámetros

-ApplicationName

Especifica el nombre de la aplicación que se va a actualizar.

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

-MaximumNodes

Especifica el número máximo de nodos en los que se va a colocar una aplicación. El valor de este parámetro debe ser un entero no negativo. El valor predeterminado es 0, lo que indica que la aplicación se puede colocar en cualquier número de nodos del clúster.

Si no especifica este parámetro, la aplicación usa el número máximo de nodos existente establecido para la aplicación.

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

-Metrics

Especifica una matriz de métricas. El clúster de Service Fabric usa estas métricas Resource Manager para administrar los recursos del clúster. Para más información sobre las métricas y la administración de recursos en Service Fabric, consulte Introducción al clúster de Service Fabric Resource Manager. Cada métrica puede seguir el patrón MetricName,NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity o puede especificar MetricName y usar nombres de parámetro NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity seguidos de un valor de parámetro separado por dos puntos. Cada par nombre:valor de parámetro puede aparecer como máximo una vez.

  • MetricName. Especifica el nombre de la métrica.
  • NodeReservationCapacity. Especifica la cantidad de carga de métricas reservada en los nodos que tienen instancias de esta aplicación. Si se especifica MinimumNodes , el producto de estos valores es la capacidad reservada en el clúster para la aplicación.
  • MaximumNodeCapacity. Especifica la carga máxima para una instancia de esta aplicación en un único nodo. Incluso si la capacidad del nodo es mayor que este valor, Service Fabric limita la carga total de las réplicas secundarias de la aplicación a este valor.
  • TotalApplicationCapacity. Especifica la capacidad total de la aplicación en el clúster. Service Fabric intenta limitar la suma de cargas de las réplicas secundarias de la aplicación a este valor.

Al actualizar la capacidad, Service Fabric realiza las siguientes validaciones y producirá un error en el comando si no pasan:

  • NodeReservationCapacity no debe ser mayor que MaximumNodeCapacity.
  • Si se especifican tanto el parámetro MinimumNodes como la métrica NodeReservationCapacity, el producto de MinimumNodes y NodeReservationCapacity no debe ser superior a TotalApplicationCapacity.
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumNodes

Especifica el número de nodos de un clúster en el que se reserva la capacidad para esta aplicación, esto no significa que se garantice que la aplicación tenga réplicas en todos esos nodos. El valor de este parámetro debe ser un entero no negativo. El valor predeterminado para esto es cero, lo que significa que no hay capacidad reservada para la aplicación.

Si MinimumNodes está establecido en 0, no se reserva ninguna capacidad.

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

-RemoveApplicationCapacity

Indica que esta operación borra todos los parámetros relacionados con la capacidad de la aplicación para la aplicación. Si especifica este parámetro, no puede especificar el parámetro Metrics para actualizar la capacidad de la aplicación.

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

-TimeoutSec

Especifica el período de tiempo de espera, en segundos, para la operación.

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

Entradas

None

Salidas

System.Object