Update-ServiceFabricApplication
Обновления или удаляет емкость приложения.
Синтаксис
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
Указывает имя обновляемого приложения.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumNodes
Указывает максимальное количество узлов, на которых будет размещаться приложение. Значение этого параметра должно быть неотрицательно целым числом. Значение по умолчанию — 0, указывающее, что приложение можно разместить на любом количестве узлов в кластере.
Если этот параметр не указан, приложение использует существующее максимальное число узлов, установленных для приложения.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Metrics
Задает массив метрик. Эти метрики используются кластером Service Fabric Resource Manager для управления ресурсами в кластере. Дополнительные сведения о метриках и управлении ресурсами в Service Fabric см. в разделе "Общие сведения о кластере Service Fabric Resource Manager". Каждая метрика может соответствовать шаблону MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity или указать MetricName и использовать имена параметров NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity, за которым следует значение параметра, разделенное двоеточием. Каждая пара параметров name:value может отображаться не более одного раза.
- MetricName. Указывает имя метрики.
- NodeReservationCapacity. Указывает объем нагрузки метрик, зарезервированной на узлах с экземплярами этого приложения. Если указано MinimumNodes , продукт этих значений является емкостью, зарезервированной в кластере для приложения.
- MaximumNodeCapacity. Указывает максимальную нагрузку для экземпляра этого приложения на одном узле. Даже если емкость узла больше этого значения, Service Fabric ограничивает общую нагрузку дочерних реплик приложения этим значением.
- TotalApplicationCapacity. Указывает общую емкость приложения в кластере. Service Fabric пытается ограничить сумму загрузки дочерних реплик приложения этим значением.
При обновлении емкости Service Fabric выполняет следующие проверки и завершится сбоем команды, если они не проходят:
- Значение NodeReservationCapacity не должно превышать MaximumNodeCapacity.
- Если указаны оба параметра MinimumNodes и метрика NodeReservationCapacity, продукт MinimumNodes и NodeReservationCapacity не должен превышать TotalApplicationCapacity.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinimumNodes
Указывает количество узлов в кластере, в котором зарезервирована емкость для этого приложения, это не означает, что приложение гарантированно будет иметь реплики на всех этих узлах. Значение этого параметра должно быть неотрицательно целым числом. Значение по умолчанию для этого параметра равно нулю, что означает, что для приложения не зарезервирована емкость.
Если для MinimumNodes задано значение 0, емкость не зарезервирована.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveApplicationCapacity
Указывает, что эта операция очищает все параметры, связанные с емкостью приложения для приложения. Если указать этот параметр, параметр метрик нельзя указать для обновления емкости приложения.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutSec
Указывает период времени ожидания (в секундах) для операции.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
None
Выходные данные
System.Object