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


Start-ServiceFabricClusterUpgrade

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

Тип: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

-ClusterManifestVersion

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

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Code

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

Тип:SwitchParameter
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CodePackageVersion

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

Тип:String
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Config

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

Тип:SwitchParameter
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ConsiderWarningAsError

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

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableDeltaHealthEvaluation

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FailureAction

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

  • Откат
  • Вручную
Тип:UpgradeFailureAction
Допустимые значения:Invalid, Rollback, Manual
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceRestart

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

Тип:SwitchParameter
Position:2
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

-Monitored

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NodeTypeHealthPolicyMap

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

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

Тип:NodeTypeHealthPolicyMap
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ReplicaQuorumTimeoutSec

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

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

Тип:UInt32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RestartProcess

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

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SortOrder

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

Возможные значения:

  • Invalid — указывает, что этот порядок сортировки недопустим. Все перечисления Service Fabric имеют недопустимый тип.
  • Default. Указывает, что будет использоваться порядок сортировки по умолчанию (как указано в манифесте кластера).
  • Numeric — указывает, что будет использоваться порядок пересылки числовых чисел (имена пользователей, отсортированные по числовым номерам).
  • Lexicographical — указывает, что будет использоваться порядок лексографической сортировки (имена пользователей, отсортированные по строкам).
  • ReverseNumeric — указывает, что будет использоваться обратный порядок сортировки (имена пользователей, отсортированные по числовым номерам).
  • ReverseLexicographical— указывает, что будет использоваться обратный лексографический порядок сортировки (имена пользователей, отсортированные по строкам).
Тип:UpgradeSortOrder
Допустимые значения:Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:4
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TimeoutSec

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

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UnmonitoredAuto

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UnmonitoredManual

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UpgradeDomainTimeoutSec

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

Тип:UInt32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UpgradeReplicaSetCheckTimeoutSec

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

Тип:UInt32
Position:3
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