Update-ServiceFabricClusterUpgrade
Изменяет описание обновления активного обновления кластера.
Синтаксис
Update-ServiceFabricClusterUpgrade
[-ForceRestart <Boolean>]
[-UpgradeReplicaSetCheckTimeoutSec <UInt32>]
[-UpgradeMode <RollingUpgradeMode>]
[-FailureAction <UpgradeFailureAction>]
[-HealthCheckRetryTimeoutSec <UInt32>]
[-HealthCheckWaitDurationSec <UInt32>]
[-HealthCheckStableDurationSec <UInt32>]
[-UpgradeDomainTimeoutSec <UInt32>]
[-UpgradeTimeoutSec <UInt32>]
[-ConsiderWarningAsError <Boolean>]
[-MaxPercentUnhealthyApplications <Byte>]
[-MaxPercentUnhealthyNodes <Byte>]
[-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
[-EnableDeltaHealthEvaluation <Boolean>]
[-MaxPercentDeltaUnhealthyNodes <Byte>]
[-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
[-Force]
[-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
[-InstanceCloseDelayDurationSec <UInt32>]
[-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
[-TimeoutSec <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Update-ServiceFabricClusterUpgrade изменяет параметры описания обновления кластера, пока обновление остается активным. Service Fabric обнаруживает и применяет изменения в соответствии со значением FabricUpgradeStatusPollInterval, как указано в манифесте кластера. За исключением политик оценки работоспособности, этот командлет обновляет только указанные параметры. Неопределенные параметры остаются не затронутыми. Необходимо обновить следующие политики оценки работоспособности вместе, а не отдельно:
- ConsiderWarningAsError
- MaxPercentUnhealthyApplications
- MaxPercentUnhealthyNodes
Чтобы управлять кластерами Service Fabric, запустите Windows PowerShell с помощью параметра "Запуск от имени администратора". Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster.
Примеры
Пример 1. Обновление значения для обновления кластера
PS C:\> Update-ServiceFabricClusterUpgrade -UpgradeReplicaSetCheckTimeoutSec 0
Эта команда задает период ожидания ожидания проверки реплики на 0 для ожидающего обновления кластера. Обновление оставляет только все остальные значения обновления.
Пример 2. Обновление политики работоспособности для обновления кластера
PS C:\> $svcType = New-Object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
PS C:\> $svcType.MaxPercentUnhealthyPartitionsPerService = 100
PS C:\> $systemAppPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
PS C:\> $systemAppPolicy.DefaultServiceTypeHealthPolicy = $svcType
PS C:\> $appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
PS C:\> $appHealthPolicyMap.Add("fabric:/System", $systemAppPolicy)
PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)
PS C:\> Update-ServiceFabricClusterUpgrade -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -Force -MaxPercentUnhealthyApplications 20 -ApplicationHealthPolicyMap $appHealthPolicyMap
Эта команда изменяет политику работоспособности кластера обновления кластера. Он указывает карту политики работоспособности типа приложения, содержащую тип приложения CriticalAppType, который не допускает сбоев. Остальные приложения оцениваются с помощью 20% максимальной процент неработоспособности.
Команда также обновляет политику работоспособности приложения, используемую для оценки структуры:/System application в рамках оценки работоспособности обновления кластера. Новые политики допускают все ошибки секции.
Параметры
-ApplicationHealthPolicyMap
Указывает System.Fabric.Health.ApplicationHealthPolicyMap, включающую настраиваемые политики работоспособности для некоторых или всех приложений. Если этот параметр не указан или не включена запись в карту для приложения, это приложение оценивается политикой работоспособности приложения, определенной в манифесте приложения, если она существует, или политика по умолчанию.
Тип: | ApplicationHealthPolicyMap |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ApplicationTypeHealthPolicyMap
Указывает карту, которая определяет максимальный процент неработоспособных приложений, разрешенных для каждого типа приложения. Типы приложений на этой карте оцениваются с помощью определенных процентных значений, а не глобальных MaxPercentUnhealthyApplications процента.
Например, если некоторые приложения типа критически важны, администратор кластера может добавить запись в карту для этого типа приложения и назначить 0% (т. е. не допускает никаких сбоев). Все остальные приложения можно оценить с помощью MaxPercentUnhealthyApplications значение 20%, чтобы не допускать некоторых сбоев из тысяч экземпляров приложений.
Сопоставление политики работоспособности типов приложения используется только в том случае, если манифест кластера включает оценку работоспособности типов приложения с помощью записи конфигурации для HealthManager/EnableApplicationTypeHealthEvaluation.
Тип: | ApplicationTypeHealthPolicyMap |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ConsiderWarningAsError
Указывает, следует ли рассматривать отчет о работоспособности предупреждения как ошибку во время оценки работоспособности.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-EnableDeltaHealthEvaluation
Указывает, следует ли включить разностные проверки работоспособности во время оценки работоспособности в отслеживаемых обновлениях. Если указать значение $True, Service Fabric принимает моментальный снимок работоспособности в начале обновления. После завершения каждого домена обновления проверка работоспособности сравнивает текущее состояние кластера с моментальным снимком. Если происходит снижение работоспособности, которое не учитывает максимальный процент от текущей политики работоспособности обновления кластера, проверка работоспособности завершается ошибкой.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FailureAction
Указывает действие, которое необходимо предпринять, если отслеживаемое обновление завершается сбоем. Допустимые значения для этого параметра:
- Откат
- Вручную.
Тип: | UpgradeFailureAction |
Допустимые значения: | Invalid, Rollback, Manual |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Force
Указывает, что этот командлет пропускает предупреждение и заставляет обновление.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ForceRestart
Указывает, следует ли перезапустить узел Service Fabric, даже если изменились только динамические конфигурации.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-HealthCheckRetryTimeoutSec
Указывает длительность в секундах, после чего Service Fabric повторяет проверку работоспособности, если предыдущая проверка работоспособности завершается ошибкой.
Тип: | UInt32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-HealthCheckStableDurationSec
Указывает длительность( в секундах), которую Service Fabric ожидает, чтобы убедиться, что кластер стабильный, прежде чем он продолжит переход к следующему домену обновления или завершит обновление. Эта длительность ожидания предотвращает незамеченные изменения работоспособности сразу после выполнения проверки работоспособности.
Тип: | UInt32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-HealthCheckWaitDurationSec
Указывает длительность( в секундах), которую Service Fabric ожидает, прежде чем она выполнит начальную проверку работоспособности после завершения обновления в домене обновления.
Тип: | UInt32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InstanceCloseDelayDurationSec
Указывает длительность в секундах, чтобы ждать, прежде чем экземпляр без отслеживания состояния, затронутый обновлением кластера, позволяет активным запросам выполнять очистку. Эта длительность ожидания эффективна только для экземпляров этих служб без отслеживания состояния, которые имеют ненулевое значение, настроенное для InstanceCloseDelayDuration, и переопределит предварительно настроенное значение. Дополнительные сведения см. в instanceCloseDelayDuration.
Тип: | UInt32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MaxPercentDeltaUnhealthyNodes
Указывает максимальный допустимый процент разностных неработоспособных узлов, которые могут иметь агрегированные состояния работоспособности ошибки. Если текущие неработоспособные узлы не учитывают процент относительно состояния в начале обновления, кластер неработоспособен.
Тип: | Byte |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MaxPercentUnhealthyApplications
Указывает максимальный допустимый процент приложений, которые могут иметь агрегированное состояние работоспособности ошибки. Если обновление превышает этот процент, кластер неработоспособен.
Тип: | Byte |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MaxPercentUnhealthyNodes
Указывает максимальный допустимый процент узлов, которые могут иметь агрегированные состояния работоспособности ошибки. Если обновление превышает этот процент, кластер неработоспособен.
Тип: | Byte |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MaxPercentUpgradeDomainDeltaUnhealthyNodes
Указывает максимальный допустимый процент разностных неработоспособных узлов домена обновления, которые могут иметь агрегированное состояние работоспособности ошибки. Если есть домен обновления, в котором текущие неработоспособные узлы не учитывают процент относительно состояния в начале обновления, кластер неработоспособен.
Тип: | Byte |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-NodeTypeHealthPolicyMap
Определяет карту с максимальным процентом неработоспособных узлов для определенных типов узлов.
Сопоставление политики работоспособности типа узла можно использовать во время оценки работоспособности кластера для описания специальных типов узлов. Типы узлов, включенные в карту, оцениваются по процентам, включенным в карту, а также с глобальными (см. раздел System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Узлы типов узлов, указанных в карте, также учитываются в глобальном пуле узлов; они являются независимыми проверками.
Тип: | NodeTypeHealthPolicyMap |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TimeoutSec
Указывает период времени ожидания (в секундах) для операции.
Тип: | Int32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UpgradeDomainTimeoutSec
Указывает максимальное время в секундах, которое Service Fabric занимает для обновления одного домена обновления. После этого периода обновление завершается ошибкой.
Тип: | UInt32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UpgradeMode
Указывает новый UpgradeMode для обновления.
Тип: | RollingUpgradeMode |
Допустимые значения: | Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UpgradeReplicaSetCheckTimeoutSec
Указывает максимальное время в секундах, которое Service Fabric ожидает перенастройки реплики в безопасное состояние, если оно еще не находится в безопасном состоянии, прежде чем Service Fabric продолжит обновление.
Тип: | UInt32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UpgradeTimeoutSec
Указывает максимальное время в секундах, которое занимает Service Fabric для всего обновления. После этого периода обновление завершается ошибкой.
Тип: | UInt32 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
System.Object