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


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