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