Start-ServiceFabricApplicationUpgrade

Модуль:

ServiceFabric

Обновляет приложение Service Fabric до указанного ApplicationTypeVersion.

Синтаксис

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-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>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Описание

Командлет Start-ServiceFabricApplicationUpgrade обновляет приложение Service Fabric. Перед использованием этого командлета необходимо скопировать обновленный пакет приложения в хранилище образов и зарегистрировать обновленный тип приложения. Используйте copy-ServiceFabricApplicationPackage, чтобы скопировать пакет приложения в хранилище образов. Используйте командлет Register-ServiceFabricApplicationType для регистрации обновленного типа приложения.

Этот командлет запускает обновление в кластере.

ApplicationParameters не сохраняются при обновлении приложения. Чтобы сохранить текущие параметры приложения, пользователь должен сначала получить параметры и передать их в вызов API обновления, как показано в примере 1 ниже.

Дополнительные сведения об обновлениях приложений Service Fabric см. в концептуальной документации.

Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster .

Примеры

Пример 1. Получение параметров приложения для передачи в вызов обновления

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}

foreach ($pair in $appParamCollection)
{ $applicationParameterMap.Add($pair.Name, $pair.Value); }

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

Пример 2. Обновление приложения

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\PersistentToDoListServiceV2" -ImageStoreConnectionString "file:C:\ProgramData\ServiceFabric\ImageStore"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListServiceV2"
PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeVersion "2.0" -ForceRestart -UnMonitoredManual

Первая команда использует командлет Copy-ServiceFabricApplicationPackage для копирования обновленного пакета приложения в хранилище образов.

Вторая команда использует командлет Register-ServiceFabricApplicationType для регистрации обновленного типа приложения.

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

Параметры

-ApplicationName

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

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

-ApplicationParameter

Задает переопределения параметров приложения в виде пар "имя-значение".

Type:	Hashtable
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationTypeVersion

Указывает версию типа приложения Service Fabric. Командлет обновляет приложение до указанной версии.

Type:	String
Position:	1
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

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

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

-DefaultServiceTypeHealthPolicy

Указывает политику работоспособности, которую тип службы по умолчанию будет использовать для отслеживаемого обновления, в формате: MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Например, "5,10,15" указывает следующие значения:

• MaxPercentUnhealthyPartitionsPerService = 5
• MaxPercentUnhealthyReplicasPerPartition = 10
• MaxPercentUnhealthyServices = 15

Type:	String
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:	3
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 (in New-ServiceFabricService).

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

-MaxPercentUnhealthyDeployedApplications

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

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

-Monitored

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

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

-ServiceTypeHealthPolicyMap

Указывает карту политики работоспособности для различных типов служб в виде хэш-таблицы в следующем формате: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Пример:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Type:	Hashtable
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:	5
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-ServiceFabricApplicationUpgrade.

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:	4
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

Связанные ссылки

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricApplicationUpgrade
• Resume-ServiceFabricApplicationUpgrade
• Copy-ServiceFabricApplicationPackage
• Register-ServiceFabricApplicationType