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


Start-ServiceFabricComposeDeploymentUpgrade

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

Синтаксис

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. Этот командлет запускает обновление в кластере.

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

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

Примеры

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

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

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

Параметры

-Compose

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

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

-Confirm

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

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

-ConsiderWarningAsError

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

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

-DefaultServiceTypeHealthPolicy

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

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DeploymentName

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

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера: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:5
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

-MaxPercentUnhealthyDeployedApplications

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

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

-Monitored

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

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

-PasswordEncrypted

Указывает, шифруется ли RegistryPasswordInvoke-ServiceFabricEncryptText.

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

-RegistryPassword

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

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

-RegistryUserName

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

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

-ServiceTypeHealthPolicyMap

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

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

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

-TimeoutSec

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

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

-UnmonitoredAuto

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

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

-UnmonitoredManual

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

Тип: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:6
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:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

None

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

System.Object