Start-ServiceFabricClusterUpgrade

Ссылка

Модуль:: ServiceFabric

Обновляет кластер Service Fabric.

Синтаксис

Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Code]
     [-CodePackageVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-Config]
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricClusterUpgrade
     [-CodePackageVersion] <String>
     [-ClusterManifestVersion] <String>
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-MaxPercentUnhealthyApplications <Byte>]
     [-MaxPercentUnhealthyNodes <Byte>]
     [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
     [-EnableDeltaHealthEvaluation]
     [-MaxPercentDeltaUnhealthyNodes <Byte>]
     [-MaxPercentUpgradeDomainDeltaUnhealthyNodes <Byte>]
     [-Force]
     [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
     [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Описание

Командлет Start-ServiceFabricClusterUpgrade обновляет кластер Service Fabric. Вы можете обновить код Service Fabric, конфигурацию или код и конфигурацию.

Чтобы управлять кластерами Service Fabric, запустите Windows PowerShell с помощью параметра "Запуск от имени администратора". Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster .

Примеры

Пример 1. Запуск неотслеживаемого обновления вручную

PS C:\> Start-ServiceFabricClusterUpgrade -CodePackageVersion "2.0.59.0" -ClusterManifestVersion "v2" -UnmonitoredManual

Эта команда запускает неотслеживаемое обновление вручную для указанного пакета кода и конфигурации.

Пример 2. Запуск обновления только для кода

PS C:\> Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion "2.0.59.0" -UnmonitoredAuto

Эта команда запускает автоматическое обновление без мониторинга для указанного пакета кода. Обновление конфигурации отсутствует.

Пример 3. Запуск обновления конфигурации

Start-ServiceFabricClusterUpgrade -ClusterManifestVersion "v2" -Config -FailureAction Rollback -Monitored

Эта команда запускает отслеживаемую конфигурацию только для указанной версии манифеста кластера. При обновлении используются политики работоспособности по умолчанию, а действие сбоя указано в качестве отката.

Пример 4. Начало обновления с помощью настраиваемой политики работоспособности

PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)

PS C:\> $svcType = New-Object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
PS C:\> $svcType.MaxPercentUnhealthyPartitionsPerService = 20
PS C:\> $svcType.MaxPercentUnhealthyReplicasPerPartition = 20
PS C:\> $warningAsErrorPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
PS C:\> $warningAsErrorPolicy.ConsiderWarningAsError = $true
PS C:\> $warningAsErrorPolicy.DefaultServiceTypeHealthPolicy = $svcType

PS C:\> $appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
PS C:\> $appHealthPolicyMap.Add("fabric:/System", $warningAsErrorPolicy)

PS C:\> Start-ServiceFabricClusterUpgrade -CodePackageVersion "4.2.83.9493" -ClusterManifestVersion "ScaleMin-1.0" -Monitored -FailureAction Rollback -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -Force -MaxPercentUnhealthyNodes 20 -MaxPercentUnhealthyApplications 20 -ApplicationHealthPolicyMap $appHealthPolicyMap

Эта команда запускает отслеживаемое обновление для указанного пакета кода и конфигурации и передает пользовательские политики работоспособности. Он задает настраиваемую политику работоспособности кластера, определяет разные значения MaxPercentUnhealthyApplications для критического типа приложения и настраиваемой политики работоспособности приложений для приложения системы кластера.

Параметры

-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

-ClusterManifestVersion

Указывает версию, хранящуюся в манифесте кластера Service Fabric.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Code

Указывает, что пакет содержит только файл .msi Service Fabric.

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

-CodePackageVersion

Указывает версию файла .msi Service Fabric.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Config

Указывает, что пакет является манифестом кластера Service Fabric.

Type:	SwitchParameter
Position:	0
Default value:	None
Required:	True
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

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

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

-EnableDeltaHealthEvaluation

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

Type:	SwitchParameter
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:	True
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

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

Type:	SwitchParameter
Position:	2
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

-Monitored

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
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

-ReplicaQuorumTimeoutSec

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

Этот параметр устарел. Укажите вместо этого параметр UpgradeReplicaSetCheckTimeoutSec .

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

-RestartProcess

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

Этот параметр устарел. Укажите вместо этого параметр ForceRestart .

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

-SortOrder

Определяет порядок, в котором выполняется обновление кластера.

Возможны следующие значения:

Invalid — указывает, что этот порядок сортировки недопустим. Все перечисления Service Fabric имеют недопустимый тип.
Default — указывает, что будет использоваться порядок сортировки по умолчанию (как указано в манифесте кластера).
Numeric — Указывает, что будет использоваться порядок переадресации числовых чисел (имена определяемых пользователем типов, отсортированные по числовым номерам).
Lexicographical — Указывает, что будет использоваться порядок сортировки пересылки лексикографических (имена определяемых пользователем типов, отсортированные по строкам).
ReverseNumeric — Указывает, что будет использоваться обратный порядок сортировки (имена пользователей, отсортированные по числу).
ReverseLexicographical— Указывает, что будет использоваться обратный лексикографический порядок сортировки (имена определяемых пользователем типов, отсортированные по строкам).

Type:	UpgradeSortOrder
Accepted values:	Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:	4
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

-UnmonitoredAuto

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

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

-UnmonitoredManual

Указывает, что режим обновления выполняется пользователем вручную и является отслеживаемым. После обновления домена обновления Service Fabric ожидает явного запуска обновления следующего домена обновления командлет Resume-ServiceFabricClusterUpgrade .

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
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

-UpgradeReplicaSetCheckTimeoutSec

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

Type:	UInt32
Position:	3
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