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

Start-ServiceFabricComposeDeploymentUpgrade

  • Ссылка
Модуль:
ServiceFabric

ПРЕДВАРИТЕЛЬНЫЙ ПРОСМОТР. Обновляет развертывание Service Fabric compose с помощью нового файла создания.

Синтаксис

Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <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-ServiceFabricComposeDeploymentUpgrade обновляет развертывание Service Fabric compose. Этот командлет запускает обновление в кластере.

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

Рекомендации по развертыванию Service Fabric compose см. в статье "Создание развертывания в Service Fabric"

Примеры

Пример 1. Обновление развертывания создания

PS C:\> Start-ServiceFabricComposeDeploymentUpgrade -DeploymentName mydeployment -Compose docker-compose.yml -Monitored -FailureAction Rollback

Команда выполняет отслеживаемое автоматическое обновление при развертывании compose с именем mydeployment из файла compose-docker-compose.yml. Обновление откатится, если отслеживаемое обновление завершается ошибкой. Заранее регистрировать тип приложения не требуется.

Параметры

-Compose

Указывает путь к целевому файлу создания, описывающего развертывание Service Fabric compose.

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

-DeploymentName

Указывает имя развертывания compose. Командлет обновляет развертывание compose с таким именем.

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

-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

-PasswordEncrypted

Указывает, зашифрован ли RegistryPassword с помощью Invoke-ServiceFabricEncryptText.

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

-RegistryPassword

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

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

-RegistryUserName

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

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

-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:6
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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

None

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

System.Object