Start-ServiceFabricApplicationUpgrade

  • Referência
Módulo:
ServiceFabric

Atualiza uma aplicação de Tecido de Serviço para a Versão De Aplicação Especificada.

Sintaxe

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

Description

O cmdlet Start-ServiceFabricApplicationUpgrade atualiza uma aplicação de Tecido de Serviço. Antes de utilizar este cmdlet, tem de copiar o pacote de aplicações atualizado para a loja de imagens e registar o tipo de aplicação atualizado. Utilize o Copy-ServiceFabricApplicationPackage para copiar o pacote de aplicações para a loja de imagens. Utilize o registo-serviçoFabricApplicationType cmdlet para registar o tipo de aplicação atualizado.

Este cmdlet inicia a atualização no cluster.

Os Aplicativosparmetros não são preservados através de uma atualização de aplicações. Para preservar os parâmetros de aplicação atuais, o utilizador deve obter os parâmetros primeiro e passá-los para a chamada API de atualização, como mostra o Exemplo 1 abaixo.

Para obter mais informações sobre as atualizações da aplicação Service Fabric, consulte a documentação conceptual.

Antes de efetuar qualquer operação num cluster de tecido de serviço, estabeleça uma ligação ao cluster utilizando o cmdlet Connect-ServiceFabricCluster .

Exemplos

Exemplo 1: Obter os parâmetros de aplicação para passar para a chamada de upgrade

$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

Exemplo 2: Atualizar uma aplicação

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

O primeiro comando utiliza o copy-ServiceFabricApplicationPackage cmdlet para copiar o pacote de aplicações atualizado para a loja de imagens.

O segundo comando utiliza o Registo-ServiçoFabricApplicationType cmdlet para registar o tipo de aplicação atualizado.

O terceiro comando atualiza a aplicação. O comando executa uma atualização manual não monitorizada, que inclui um reinício do servidor que acolhe a aplicação.

Parâmetros

-ApplicationName

Especifica o Identificador de Recursos Uniforme (URI) de uma aplicação de Tecido de Serviço. O cmdlet atualiza a aplicação que tem o URI que especifica.

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

-ApplicationParameter

Especifica as sobreposições para parâmetros de aplicação como pares de nome/valor.

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

-ApplicationTypeVersion

Especifica a versão de um tipo de aplicação De Tecido de Serviço. O cmdlet atualiza a aplicação para a versão que especifica.

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-ConsiderWarningAsError

Indica se deve tratar um evento de saúde de aviso como um evento de erro durante a avaliação de saúde.

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 saúde para o tipo de serviço predefinido a utilizar para a atualização monitorizada 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

-FailureAction

Especifica a ação a tomar se a atualização monitorizada 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 este 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 o anfitrião de serviço reinicia mesmo que a atualização seja uma alteração apenas de configuração.

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

-HealthCheckRetryTimeoutSec

Especifica a duração, em segundos, após o qual o Service Fabric retira o exame de saúde se o exame de saúde 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 a aplicação é estável antes de passar para o domínio de atualização seguinte ou completar a atualização. Esta duração de espera evita alterações de saúde não detetadas logo após a verificação de saúde.

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 efetuar a verificação de saúde inicial depois de terminar a atualização no domínio da atualização.

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

-InstanceCloseDelayDurationSec

Especifica a duração em segundos, para aguardar que uma instância apátrida que seja impactada pela atualização da aplicação seja encerrada, para permitir que os pedidos ativos drene graciosamente. Esta duração de espera só é eficaz para os casos dos serviços apátridas que têm um valor não nulo configurado para a InstanceCloseDelayDuration, e que sobreporão ao valor pré-configurado. Consulte InstanceCloseDelayDuration (in New-ServiceFabricService) para obter mais informações.

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

-MaxPercentUnhealthyDeployedApplications

Especifica a percentagem máxima das instâncias de aplicação implementadas nos nós do cluster que têm um estado de erro de saúde antes do estado de saúde da aplicação para o cluster é 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 é monitorizado. Depois de o cmdlet terminar uma atualização para um domínio de upgrade, se a saúde do domínio de upgrade e o cluster cumprirem as políticas de saúde que define, o Service Fabric atualiza o próximo domínio de atualização. Se o domínio ou cluster de atualização não cumprir as políticas de saúde, a atualização falha e o Service Fabric reverte a atualização para o domínio de atualização ou reverte para o modo manual de acordo com a política especificada. Este é o modo recomendado para atualizações de aplicações em ambiente de produção.

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

-ReplicaQuorumTimeoutSec

Especifica o período de tempo de ício, em segundos, para verificar se o conjunto de réplicas tem quórum. Após o período de tempo de ício, a atualização prossegue.

Este parâmetro foi depreciado. Em vez disso, especifique o parâmetro UpgradeReplicaSetCheckTimeoutSec .

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

-RestartProcess

Indica que o anfitrião de serviço reinicia como parte da atualização.

Este parâmetro foi depreciado. Em vez disso, especifique o parâmetro ForceRestart .

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

-ServiceTypeHealthPolicyMap

Especifica o mapa da política de saúde a utilizar para diferentes tipos de serviço como tabela 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

-SortOrder

Define a ordem pela qual uma atualização procede através do cluster.

Os valores possíveis são:

  • Invalid - Indica que esta ordem não é válida. Todas as enumerações de Tecido de Serviço têm o tipo inválido.
  • Default - Indica que a ordem de classificação predefinida (conforme especificado no manifesto de cluster) será utilizada.
  • Numeric - Indica que será utilizada a ordem de classificação numérica avançada (nomes de UD classificados como números).
  • Lexicographical - Indica que será utilizada a ordem de classificação lexicográfica para a frente (nomes de UD classificados como cordas).
  • ReverseNumeric - Indica que será utilizada a ordem de classificação numérica inversa (nomes de UD classificados como números).
  • ReverseLexicographical- Indica que será utilizada a ordem de classificação lexicográfica inversa (nomes de UD classificados como cordas).
Tipo:UpgradeSortOrder
Valores aceites:Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:5
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TimeoutSec

Especifica o período de tempo de ício, 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 não é monitorizado automaticamente. Depois de o Service Fabric atualizar um domínio de upgrade, o Service Fabric atualiza o próximo domínio de atualização, independentemente do estado de saúde da aplicação. Este modo não é recomendado para produção, e só é útil durante o desenvolvimento de uma aplicaçã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 é monitorizado manualmente. Depois de o Service Fabric atualizar um domínio de atualização, espera que atualize o próximo domínio de atualização utilizando 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 este período, a atualização falha.

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 espera que um serviço se reconfigure em estado seguro, se não já em estado seguro, antes que o Service Fabric prossiga com a atualização.

Tipo:UInt32
Position:4
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 este período, a atualização falha.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Entradas

None

Saídas

System.Object