Configurar a atualização de um aplicativo do Service Fabric no Visual Studio

Artigo
08/24/2024

As ferramentas do Visual Studio para Azure Service Fabric fornecem suporte de atualização para publicação em clusters locais ou remotos. Há três cenários nos quais você deseja atualizar seu aplicativo para uma versão mais recente em vez de substituí-lo durante o teste e a depuração:

Os dados do aplicativo não serão perdidos durante a atualização.
A disponibilidade permanece alta, portanto, não haverá interrupção do serviço durante a atualização, se houver instâncias de serviço suficientes espalhadas pelos domínios de atualização.
Os testes podem ser executados em um aplicativo enquanto ele está sendo atualizado.

Parâmetros necessários para atualizar

Você pode escolher entre dois tipos de implantação: regular ou atualização. Uma implantação regular apaga todas as informações e dados de implantação anteriores no cluster, enquanto uma implantação de atualização os preserva. Ao atualizar um aplicativo do Service Fabric no Visual Studio, você precisa fornecer parâmetros de atualização de aplicativo e políticas de verificação de integridade. Os parâmetros de atualização do aplicativo ajudam a controlar a atualização, enquanto as políticas de verificação de integridade determinam se a atualização foi bem-sucedida. Consulte Atualização do aplicativo Service Fabric: parâmetros de atualização para obter mais detalhes.

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

Uma atualização monitorada automatiza a atualização e a verificação de integridade do aplicativo.
Uma atualização UnmonitoredAuto automatiza a atualização, mas ignora a verificação de integridade do aplicativo.
Quando você faz uma atualização UnmonitoredManual, você precisa atualizar manualmente cada domínio de atualização.

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

Atualizar um aplicativo do Service Fabric no Visual Studio

Se você estiver usando as ferramentas do Visual Studio Service Fabric para atualizar um aplicativo do Service Fabric, poderá especificar um processo de publicação como uma atualização em vez de uma implantação regular marcando a caixa de seleção Atualizar o aplicativo .

Para configurar os parâmetros de atualização

Clique no botão Configurações ao lado da caixa de seleção. A caixa de diálogo Editar parâmetros de atualização é exibida. 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 deseja usar e preencha a grade de parâmetros.

Cada parâmetro tem valores padrão. 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"}
```
Aqui está um exemplo da vida real:
```
@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }
```
Se você selecionar o modo de atualização manual não monitorado, deverá iniciar manualmente um console do PowerShell para continuar e concluir o processo de atualização. Consulte Atualização do aplicativo Service Fabric: tópicos avançados para saber como funciona a atualização manual.

Atualizar um aplicativo usando o PowerShell

Você pode usar cmdlets do PowerShell para atualizar um aplicativo do Service Fabric. Consulte Tutorial de atualização do aplicativo Service Fabric e Start-ServiceFabricApplicationUpgrade para obter informações detalhadas.

Especificar uma política de verificação de integridade no arquivo de manifesto do aplicativo

Cada serviço em um aplicativo do Service Fabric pode ter seus próprios parâmetros de política de integridade que substituem os valores padrão. Você pode fornecer esses valores de parâmetro no arquivo de manifesto do aplicativo.

O exemplo a seguir mostra como aplicar uma política de verificação de integridade exclusiva para cada serviço no manifesto do aplicativo.

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

Próximos passos

Para obter mais informações sobre como atualizar um aplicativo, consulte Atualizar um aplicativo usando o Visual Studio.

Partilhar via