Update-ServiceFabricClusterUpgrade

Ссылка

Модуль:: ServiceFabric

Изменяет описание обновления активного обновления кластера.

Синтаксис

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 , который включает настраиваемые политики работоспособности для некоторых или всех приложений. Если этот параметр не указан или вы не включаете запись в карту для приложения, это приложение оценивается с помощью политики работоспособности приложения, определенной в манифесте приложения, если она существует, или политики по умолчанию.

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

-ApplicationTypeHealthPolicyMap

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

Например, если некоторые приложения принадлежат к типу "критический", администратор кластера может добавить в сопоставление запись для этого типа и присвоить ему значение 0 % (т. е. не допускать каких-либо ошибок). Все остальные приложения можно оценить с помощью MaxPercentUnhealthyApplications равным 20 %, чтобы обеспечить некоторые сбои из тысяч экземпляров приложения.

Сопоставление политики работоспособности типа приложения используется только в том случае, если манифест кластера включает оценку работоспособности типа приложения с помощью записи конфигурации для HealthManager/EnableApplicationTypeHealthEvaluation.

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

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-ConsiderWarningAsError

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

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

-EnableDeltaHealthEvaluation

Указывает, следует ли включать разностные проверки работоспособности во время оценки работоспособности в отслеживаемых обновлениях. Если указать значение $True, Service Fabric создает моментальный снимок работоспособности в начале обновления. После завершения каждого домена обновления проверка работоспособности сравнивает текущее состояние кластера с моментальным снимком. Если наблюдается снижение работоспособности, которое не учитывает максимально допустимое значение в процентах от текущей политики работоспособности обновления кластера, проверка работоспособности завершается ошибкой.

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

-FailureAction

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

Откат
Вручную.

Type:	UpgradeFailureAction
Accepted values:	Invalid, Rollback, Manual
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

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

-ForceRestart

Указывает, следует ли перезапустить узел Service Fabric, даже если изменились только динамические конфигурации.

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

-HealthCheckRetryTimeoutSec

Указывает длительность (в секундах), после которой Service Fabric повторяет проверку работоспособности, если предыдущая проверка работоспособности завершается ошибкой.

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

-HealthCheckStableDurationSec

Указывает время ожидания Service Fabric в секундах, чтобы убедиться, что кластер является стабильным, прежде чем он переходит к следующему домену обновления или завершает обновление. Эта продолжительность ожидания предотвращает незамеченные изменения работоспособности сразу после выполнения проверки работоспособности.

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

-HealthCheckWaitDurationSec

Указывает длительность (в секундах), которую Service Fabric ожидает, прежде чем она выполнит начальную проверку работоспособности после завершения обновления в домене обновления.

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

-InstanceCloseDelayDurationSec

Указывает длительность в секундах, чтобы дождаться закрытия экземпляра без отслеживания состояния, затронутого обновлением кластера, чтобы разрешить активным запросам корректно очищать состояние. Эта продолжительность ожидания действима только для экземпляров служб без отслеживания состояния, для которых настроено значение, отличное от нуля, для InstanceCloseDelayDuration, и переопределит предварительно настроенное значение. Дополнительные сведения см. в разделе InstanceCloseDelayDuration .

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

-MaxPercentDeltaUnhealthyNodes

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

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

-MaxPercentUnhealthyApplications

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

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

-MaxPercentUnhealthyNodes

Указывает максимальный допустимый процент узлов, которые могут иметь агрегированные состояния работоспособности ошибки. Если обновление превышает этот процент, кластер неработоспособен.

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

-MaxPercentUpgradeDomainDeltaUnhealthyNodes

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

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

-NodeTypeHealthPolicyMap

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

Сопоставление политики работоспособности для типа узла используется при оценке работоспособности кластера для описания особых типов узлов. Типы узлов, включенные в карту, оцениваются в процентах, включенных в карту, а также с глобальными (см. раздел System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Узлы типов узлов, указанных на карте, также учитываются в глобальном пуле узлов; они являются независимыми проверками.

Type:	NodeTypeHealthPolicyMap
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

-UpgradeDomainTimeoutSec

Указывает максимальное время (в секундах), необходимое Service Fabric для обновления одного домена обновления. По истечении этого периода обновление завершается сбоем.

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

-UpgradeMode

Указывает новый upgradeMode для обновления.

Type:	RollingUpgradeMode
Accepted values:	Invalid, UnmonitoredAuto, UnmonitoredManual, Monitored
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpgradeReplicaSetCheckTimeoutSec

Указывает максимальное время (в секундах), которое Service Fabric ожидает перенастройки реплики в безопасное состояние, если оно еще не находится в безопасном состоянии, прежде чем Service Fabric продолжит обновление.

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

-UpgradeTimeoutSec

Указывает максимальное время (в секундах), которое Service Fabric занимает для всего обновления. По истечении этого периода обновление завершается сбоем.

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

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

None

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

System.Object