Configurar a atualização de uma aplicação do Service Fabric no Visual Studio

Artigo
06/01/2023

As ferramentas do Visual Studio para o Azure Service Fabric fornecem suporte de atualização para publicação em clusters locais ou remotos. Existem três cenários em que pretende atualizar a sua aplicação para uma versão mais recente em vez de substituir a aplicação durante os testes e a depuração:

Os dados da aplicação não serão perdidos durante a atualização.
A disponibilidade permanece elevada, pelo que não haverá qualquer interrupção do serviço durante a atualização, se existirem instâncias de serviço suficientes distribuídas por domínios de atualização.
Os testes podem ser executados numa aplicação enquanto estão a ser atualizados.

Parâmetros necessários para atualizar

Pode escolher entre dois tipos de implementação: regular ou atualização. Uma implementação regular apaga todas as informações e dados de implementação anteriores no cluster, enquanto uma implementação de atualização os preserva. Quando atualiza uma aplicação do Service Fabric no Visual Studio, tem de fornecer parâmetros de atualização de aplicações e políticas de verificação de estado de funcionamento. Os parâmetros de atualização da aplicação ajudam a controlar a atualização, enquanto as políticas de verificação de estado de funcionamento determinam se a atualização foi efetuada com êxito. Veja Atualização da aplicação do Service Fabric: atualizar parâmetros para obter mais detalhes.

Existem três modos de atualização: Monitorizado, UnmonitoredAuto e UnmonitoredManual.

Uma Atualização monitorizada automatiza a atualização e a verificação do estado de funcionamento da aplicação.
Uma atualização UnmonitoredAuto automatiza a atualização, mas ignora a verificação do estado de funcionamento da aplicação.
Quando efetua uma atualização UnmonitoredManual, tem de atualizar manualmente cada domínio de atualização.

Cada modo de atualização requer diferentes conjuntos de parâmetros. Veja Parâmetros de atualização da aplicação para saber mais sobre as opções de atualização disponíveis.

Atualizar uma aplicação do Service Fabric no Visual Studio

Se estiver a utilizar as ferramentas do Visual Studio Service Fabric para atualizar uma aplicação do Service Fabric, pode especificar um processo de publicação para ser uma atualização em vez de uma implementação regular ao selecionar a caixa de verificação Atualizar a aplicação .

Para configurar os parâmetros de atualização

Clique no botão Definições junto à caixa de verificação. É apresentada a caixa de diálogo Editar Parâmetros de Atualização . A caixa de diálogo Editar Parâmetros de Atualização suporta os modos de atualização Monitored, UnmonitoredAuto e UnmonitoredManual.
Selecione o modo de atualização que pretende utilizar e, em seguida, preencha a grelha de parâmetros.

Cada parâmetro tem valores predefinidos. O parâmetro opcional DefaultServiceTypeHealthPolicy requer uma entrada de tabela hash. Segue-se um exemplo do formato de entrada de tabela hash para DefaultServiceTypeHealthPolicy:
```
@{ ConsiderWarningAsError = "false"; MaxPercentUnhealthyDeployedApplications = 0; MaxPercentUnhealthyServices = 0; MaxPercentUnhealthyPartitionsPerService = 0; MaxPercentUnhealthyReplicasPerPartition = 0 }
```
ServiceTypeHealthPolicyMap é outro parâmetro opcional que utiliza uma entrada de tabela hash no seguinte formato:
```
@ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}
```
Eis um exemplo da vida real:
```
@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }
```
Se selecionar UnmonitoredManual upgrade mode ,tem de iniciar manualmente uma consola do PowerShell para continuar e concluir o processo de atualização. Veja Atualização da aplicação do Service Fabric: tópicos avançados para saber como funciona a atualização manual.

Atualizar uma aplicação com o PowerShell

Pode utilizar cmdlets do PowerShell para atualizar uma aplicação do Service Fabric. Veja Tutorial de atualização da aplicação do Service Fabric e Start-ServiceFabricApplicationUpgrade para obter informações detalhadas.

Especificar uma política de verificação de estado de funcionamento no ficheiro de manifesto da aplicação

Cada serviço numa aplicação do Service Fabric pode ter os seus próprios parâmetros de política de estado de funcionamento que substituem os valores predefinidos. Pode fornecer estes valores de parâmetros no ficheiro de manifesto da aplicação.

O exemplo seguinte mostra como aplicar uma política de verificação de estado de funcionamento exclusiva para cada serviço no manifesto da aplicação.

<Policies>
    <HealthPolicy ConsiderWarningAsError="false" MaxPercentUnhealthyDeployedApplications="20">
        <DefaultServiceTypeHealthPolicy MaxPercentUnhealthyServices="20"               
                MaxPercentUnhealthyPartitionsPerService="20"
                MaxPercentUnhealthyReplicasPerPartition="20" />
        <ServiceTypeHealthPolicy ServiceTypeName="ServiceTypeName1"
                MaxPercentUnhealthyServices="20"
                MaxPercentUnhealthyPartitionsPerService="20"
                MaxPercentUnhealthyReplicasPerPartition="20" />      
    </HealthPolicy>
</Policies>

Passos seguintes

Para obter mais informações sobre a atualização de uma aplicação, veja Atualizar uma aplicação com o Visual Studio.