Поделиться через

Update-ServiceFabricApplication

  • Ссылка
Модуль:
ServiceFabric

Обновляет или удаляет емкость приложения.

Синтаксис

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

Описание

Update-ServiceFabricApplication обновления или удаляет емкость приложения для уже созданного приложения.

Емкость приложения определяет максимальные или минимальные узлы для приложения, а также емкость на узел для его метрик.

Примеры

Пример 1. Обновление maximumNodes и метрик

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

Эта команда обновляет структуру приложения:/MyApp, чтобы использовать не более шести узлов. Каждый узел имеет зарезервированную нагрузку двух единиц и максимальную нагрузку 12 единиц для метрики ЦП на каждом узле. Общая емкость приложения составляет 16 единиц для метрики ЦП. Значение MinimumNodes остается неизменным.

Пример 2. Обновление метрик MaximumNodes и сброса метрик

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

Эта команда обновляет структуру приложения:/MyApp, чтобы использовать не более шести узлов и удаляет емкости для всех метрик. Если есть какие-либо ранее определенные емкости, они очищаются после этой команды. Значение MinimumNodes не изменяется.

Пример 3. Обновление всех параметров емкости приложения

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

Эта команда обновляет структуру приложения:/MyApp, чтобы использовать не более шести узлов. Каждый узел имеет зарезервированную нагрузку двух единиц и максимальную нагрузку 12 единиц для ЦП метрик на каждом узле. Общая емкость приложения составляет 16 единиц для метрики ЦП. Значение минимальных узлов обновляется до 2, поэтому Service Fabric резервирует общую емкость четырех единиц для метрики ЦП в кластере.

Пример 4. Удаление всех параметров емкости приложения

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

Эта команда обновляет структуру приложения:/MyApp, чтобы у него не было параметров емкости приложения. Если у MyApp уже заданы параметры емкости, эта операция очищает их.

Параметры

-ApplicationName

Указывает имя приложения для обновления.

Тип:Uri
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MaximumNodes

Указывает максимальное количество узлов, на которых нужно разместить приложение. Значение этого параметра должно быть неотрицательное целое число. Значение по умолчанию равно 0, указывающее, что приложение можно поместить на любое количество узлов в кластере.

Если этот параметр не указан, приложение использует существующее максимальное количество узлов, установленных для приложения.

Тип:Int64
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Metrics

Задает массив метрик. Эти метрики используются Диспетчером кластерных ресурсов Service Fabric для управления ресурсами в кластере. Дополнительные сведения о метриках и управлении ресурсами в Service Fabric см. в статье Общие сведения о кластере Service Fabric Resource Manager. Каждая метрика может следовать шаблону MetricName,NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity, или может указать имя метрики и использовать имена параметров NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity, за которым следует значение параметра, разделенное двоеточием. Каждая пара name:value может отображаться по крайней мере один раз.

  • MetricName. Указывает имя метрики.
  • NodeReservationCapacity. Указывает объем нагрузки метрик, зарезервированной на узлах с экземплярами этого приложения. Если указан minimumNodes, продукт этих значений — это емкость, зарезервированная в кластере для приложения.
  • MaximumNodeCapacity. Задает максимальную нагрузку для экземпляра этого приложения на одном узле. Даже если емкость узла больше этого значения, Service Fabric ограничивает общую нагрузку дочерних реплик приложения на это значение.
  • TotalApplicationCapacity. Указывает общую емкость приложения в кластере. Service Fabric пытается ограничить сумму нагрузки дочерних реплик приложения на это значение.

При обновлении емкости Service Fabric выполняет следующие проверки и завершится ошибкой команды, если они не проходят:

  • NodeReservationCapacity не должно превышать MaximumNodeCapacity.
  • Если указаны оба параметра MinimumNodes и метрика NodeReservationCapacity, то продукт MinimumNodes и NodeReservationCapacity не должно превышать TotalApplicationCapacity.
Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MinimumNodes

Указывает количество узлов в кластере, на котором зарезервирована емкость для этого приложения, это не означает, что приложение гарантированно будет иметь реплики на всех этих узлах. Значение этого параметра должно быть неотрицательное целое число. Значение по умолчанию для этого равно нулю, что означает, что емкость приложения не зарезервирована.

Если значение MinimumNodes равно 0, емкость не зарезервирована.

Тип:Int64
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveApplicationCapacity

Указывает, что эта операция очищает все параметры, связанные с емкостью приложения для приложения. Если этот параметр указан, нельзя указать параметр метрик для обновления емкости приложения.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TimeoutSec

Указывает период времени ожидания (в секундах) для операции.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

System.Object