Start-ServiceFabricComposeDeploymentUpgrade

Módulo:

ServiceFabric

PREVISUALIZAR. Atualiza uma implantação de composição do Service Fabric com um novo arquivo de composição.

Sintaxe

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>]

Description

Este cmdlet está em PREVIEW e está sujeito a alterações na(s) próxima(s) versão(ões). Não há garantia de compatibilidade.

O cmdlet Start-ServiceFabricComposeDeploymentUpgrade atualiza uma implantação de composição do Service Fabric. Este cmdlet inicia a atualização no cluster.

Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster.

Para obter orientação sobre a implantação de composição do Service Fabric, consulte: Implantação de composição no Service Fabric

Exemplos

Exemplo 1: Atualizar uma implantação de composição

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

O comando executa uma atualização automática monitorada na implantação de composição chamada mydeployment do arquivo de composição docker-compose.yml. A atualização será revertida se a atualização monitorada falhar. Não é necessário registar previamente o tipo de pedido.

Parâmetros

-Compose

Especifica o caminho do arquivo para um arquivo de composição de destino que descreve a implantação de composição do Service Fabric.

Tipo:	String
Position:	1
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ConsiderWarningAsError

Indica se um evento de integridade de aviso deve ser tratado como um evento de erro durante a avaliação de integridade.

Tipo:	Boolean
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultServiceTypeHealthPolicy

Especifica a política de integridade para o tipo de serviço padrão a ser usado para a atualização monitorada no formato MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Por exemplo, 5,10,15 indica os seguintes valores:

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DeploymentName

Especifica o nome da implantação de composição. O cmdlet atualiza a implantação de composição com esse nome.

Tipo:	String
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-FailureAction

Especifica a ação a ser executada se a atualização monitorada falhar. Os valores aceitáveis para este parâmetro são:

• Reversão
• Manual

Tipo:	UpgradeFailureAction
Valores aceites:	Invalid, Rollback, Manual
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Force

Indica que esse cmdlet ignora a mensagem de aviso e força a atualização.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ForceRestart

Indica que todos os contêineres no arquivo de composição devem ser recriados, mesmo que as descrições de serviço não tenham sido alteradas no novo arquivo de composição.

Tipo:	SwitchParameter
Position:	5
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-HealthCheckRetryTimeoutSec

Especifica a duração, em segundos, após a qual o Service Fabric tenta novamente a verificação de integridade se a verificação de integridade anterior falhar.

Tipo:	UInt32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-HealthCheckStableDurationSec

Especifica a duração, em segundos, que o Service Fabric aguarda para verificar se o aplicativo que compõe a implantação implantada está estável antes de passar para o próximo domínio de atualização ou concluir a atualização. Essa duração de espera evita alterações de integridade não detetadas logo após a verificação de integridade ser executada.

Tipo:	UInt32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-HealthCheckWaitDurationSec

Especifica a duração, em segundos, que o Service Fabric aguarda antes de executar a verificação de integridade inicial depois de concluir a atualização no domínio de atualização.

Tipo:	UInt32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-MaxPercentUnhealthyDeployedApplications

Especifica a porcentagem máxima das instâncias de aplicativo implantadas nos nós do cluster que têm um estado de integridade de erro antes que o estado de integridade do aplicativo para o cluster seja erro.

Tipo:	Byte
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Monitored

Indica que o modo de atualização é monitorado. Depois que o cmdlet concluir uma atualização para um domínio de atualização, se a integridade do domínio de atualização e do cluster atenderem às políticas de integridade definidas, o Service Fabric atualizará o próximo domínio de atualização. Se o domínio ou cluster de atualização não atender às políticas de integridade, a atualização falhará e o Service Fabric reverterá a atualização para o domínio de atualização ou reverterá para o modo manual de acordo com a política especificada. Este é o modo recomendado para compor atualizações de implantação em um ambiente de produção.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PasswordEncrypted

Indica se RegistryPassword é criptografado por Invoke-ServiceFabricEncryptText .

Tipo:	SwitchParameter
Position:	4
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-RegistryPassword

Indica a senha do registro do contêiner. Se este parmameter for fornecido, RegistryUserName precisam ser fornecidos juntos.

Tipo:	String
Position:	3
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-RegistryUserName

Indica o nome de usuário do registro de contêiner. Se este parmameter for fornecido, RegistryPassword precisam ser fornecidos juntos.

Tipo:	String
Position:	2
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ServiceTypeHealthPolicyMap

Especifica o mapa da política de integridade a ser usada para diferentes tipos de serviço como uma tabela de hash no seguinte formato: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Por exemplo:

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

Tipo:	Hashtable
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-TimeoutSec

Especifica o período de tempo limite, em segundos, para a operação.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UnmonitoredAuto

Indica que o modo de atualização é automático não monitorado. Depois que o Service Fabric atualiza um domínio de atualização, o Service Fabric atualiza o próximo domínio de atualização, independentemente do estado de integridade do aplicativo. Esse modo não é recomendado para produção e só é útil durante o desenvolvimento de uma implantação de composição.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UnmonitoredManual

Indica que o modo de atualização não é monitorado manualmente. Depois que o Service Fabric atualiza um domínio de atualização, ele aguarda que você atualize o próximo domínio de atualização usando o cmdlet Resume-ServiceFabricApplicationUpgrade.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UpgradeDomainTimeoutSec

Especifica o tempo máximo, em segundos, que o Service Fabric leva para atualizar um único domínio de atualização. Após esse período, a atualização falhará.

Tipo:	UInt32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UpgradeReplicaSetCheckTimeoutSec

Especifica o tempo máximo que o Service Fabric aguarda para que um serviço seja reconfigurado em um estado seguro, se ainda não estiver em um estado seguro, antes que o Service Fabric prossiga com a atualização.

Tipo:	UInt32
Position:	6
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UpgradeTimeoutSec

Especifica o tempo máximo, em segundos, que o Service Fabric leva para toda a atualização. Após esse período, a atualização falhará.

Tipo:	UInt32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

None

Saídas

System.Object

Ligações Relacionadas

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricComposeDeploymentUpgrade
• Resume-ServiceFabricApplicationUpgrade