Atualizar a versão do Service Fabric que é executada no cluster

Artigo
10/15/2024

Para qualquer sistema moderno, a capacidade de atualizar é a chave para o sucesso a longo prazo do seu produto. Um cluster do Azure Service Fabric é um recurso de sua propriedade. Este artigo descreve como atualizar a versão do Service Fabric em execução no cluster autônomo.

Nota

Certifique-se de que o cluster sempre executa uma versão suportada do Service Fabric. Quando a Microsoft anuncia o lançamento de uma nova versão do Service Fabric, a versão anterior é marcada para o fim do suporte após um mínimo de 60 dias a partir da data do anúncio. Novos lançamentos são anunciados no blog da equipe do Service Fabric. A nova versão está disponível para escolha nesse momento.

Você pode atualizar seu cluster para a nova versão somente se estiver usando uma configuração de nó de estilo de produção, onde cada nó do Service Fabric é alocado em uma máquina física ou virtual separada. Se você tiver um cluster de desenvolvimento, onde mais de um nó do Service Fabric está em uma única máquina física ou virtual, deverá recriar o cluster com a nova versão.

Dois fluxos de trabalho distintos podem atualizar seu cluster para a versão mais recente ou uma versão suportada do Service Fabric. Um fluxo de trabalho é para clusters que têm conectividade para baixar a versão mais recente automaticamente. O outro fluxo de trabalho é para clusters que não têm conectividade para baixar a versão mais recente do Service Fabric.

Habilitar a atualização automática da versão do Service Fabric do cluster

Para definir o cluster para baixar atualizações do Service Fabric quando a Microsoft lançar uma nova versão, defina a configuração do fabricClusterAutoupgradeEnabled cluster como true. Para selecionar manualmente uma versão suportada do Service Fabric na qual você deseja que o cluster esteja, defina a configuração do fabricClusterAutoupgradeEnabled cluster como false.

Atualizar clusters que têm conectividade para baixar o código e a configuração mais recentes

Use estas etapas para atualizar o cluster para uma versão com suporte se os nós do cluster tiverem conectividade com a Internet para o Centro de Download da Microsoft.

Para clusters com conectividade com o Centro de Download da Microsoft, a Microsoft verifica periodicamente a disponibilidade de novas versões do Service Fabric.

Quando uma nova versão do Service Fabric está disponível, o pacote é baixado localmente para o cluster e provisionado para atualização. Além disso, para informar o cliente sobre essa nova versão, o sistema mostra um aviso explícito de integridade do cluster semelhante ao seguinte:

"O suporte da versão atual do cluster [versão #] termina [data]."

Depois que o cluster estiver executando a versão mais recente, o aviso desaparecerá.

Quando vir o aviso de integridade do cluster, atualize o cluster:

Conecte-se ao cluster de qualquer máquina que tenha acesso de administrador a todas as máquinas listadas como nós no cluster. A máquina na qual esse script é executado não precisa fazer parte do cluster.

###### connect to the secure cluster using certs
$ClusterName= "mysecurecluster.something.com:19000"
$CertThumbprint= "70EF5E22ADB649799DA3C8B6A6BF7FG2D630F8F3"
Connect-serviceFabricCluster -ConnectionEndpoint $ClusterName -KeepAliveIntervalInSec 10 `
    -X509Credential `
    -ServerCertThumbprint $CertThumbprint  `
    -FindType FindByThumbprint `
    -FindValue $CertThumbprint `
    -StoreLocation CurrentUser `
    -StoreName My

Obtenha a lista de versões do Service Fabric para as quais você pode atualizar.
```
###### Get the list of available Service Fabric versions
Get-ServiceFabricRegisteredClusterCodeVersion
```
Você deve obter uma saída semelhante a esta:
Inicie uma atualização de cluster para uma versão disponível usando o comando Start-ServiceFabricClusterUpgrade do Windows PowerShell.
```
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion <codeversion#> -Monitored -FailureAction Rollback

###### Here is a filled-out example

Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion 5.3.301.9590 -Monitored -FailureAction Rollback
```
Para monitorar o progresso da atualização, você pode usar o Service Fabric Explorer ou executar o seguinte comando do PowerShell:
```
Get-ServiceFabricClusterUpgrade
```
Se as políticas de integridade do cluster não forem atendidas, a atualização será revertida. Para especificar políticas de integridade personalizadas para o comando Start-ServiceFabricClusterUpgrade, consulte a documentação de Start-ServiceFabricClusterUpgrade.

Depois de corrigir os problemas que resultaram na reversão, inicie a atualização novamente seguindo as mesmas etapas descritas anteriormente.

Atualizar clusters que não têm conectividade para baixar o código e a configuração mais recentes

Use estas etapas para atualizar seu cluster para uma versão com suporte se os nós do cluster não tiverem conectividade com a Internet para o Centro de Download da Microsoft.

Nota

Se você estiver executando um cluster que não está conectado à Internet, precisará monitorar o blog da equipe do Service Fabric para saber mais sobre as novas versões. O sistema não mostra um aviso de integridade do cluster para alertá-lo sobre novas versões.

Provisionamento automático versus provisionamento manual

Para habilitar o download automático e o registro para a versão de código mais recente, configure o Serviço de Atualização do Service Fabric. Para obter instruções, consulte Tools\ServiceFabricUpdateService.zip\Readme_InstructionsAndHowTos.txt no pacote autônomo.

Para o processo manual, siga estas instruções.

Modifique a configuração do cluster para definir a seguinte propriedade como false antes de iniciar uma atualização de configuração:

"fabricClusterAutoupgradeEnabled": false,

Para obter detalhes de uso, consulte o comando Start-ServiceFabricClusterConfigurationUpgrade PowerShell. Certifique-se de atualizar 'clusterConfigurationVersion' em seu JSON antes de iniciar a atualização de configuração.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

Fluxo de trabalho de atualização de cluster

Execute Get-ServiceFabricClusterUpgrade a partir de um dos nós no cluster e anote o TargetCodeVersion.
Execute o seguinte a partir de uma máquina conectada à Internet para listar todas as versões compatíveis com a atualização com a versão atual e baixar o pacote correspondente dos links de download associados:
```
###### Get list of all upgrade compatible packages  
Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion <TargetCodeVersion as noted in Step 1> 
```

###### Get the list of available Service Fabric versions
Copy-ServiceFabricClusterPackage -Code -CodePackagePath <name of the .cab file including the path to it> -ImageStoreConnectionString "fabric:ImageStore"

###### Here is a filled-out example
Copy-ServiceFabricClusterPackage -Code -CodePackagePath .\MicrosoftAzureServiceFabric.5.3.301.9590.cab -ImageStoreConnectionString "fabric:ImageStore"

Copie o pacote baixado para o armazenamento de imagens do cluster.

Registre o pacote copiado.

###### Get the list of available Service Fabric versions
Register-ServiceFabricClusterPackage -Code -CodePackagePath <name of the .cab file>

###### Here is a filled-out example
Register-ServiceFabricClusterPackage -Code -CodePackagePath MicrosoftAzureServiceFabric.5.3.301.9590.cab

Inicie uma atualização de cluster para uma versão disponível.
```
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion <codeversion#> -Monitored -FailureAction Rollback

###### Here is a filled-out example
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion 5.3.301.9590 -Monitored -FailureAction Rollback
```
Você pode monitorar o progresso da atualização no Service Fabric Explorer ou executar o seguinte comando do PowerShell:
```
Get-ServiceFabricClusterUpgrade
```
Se as políticas de integridade do cluster não forem atendidas, a atualização será revertida. Para especificar políticas de integridade personalizadas para o comando Start-ServiceFabricClusterUpgrade, consulte a documentação de Start-ServiceFabricClusterUpgrade.

Depois de corrigir os problemas que resultaram na reversão, inicie a atualização novamente seguindo as mesmas etapas descritas anteriormente.

Próximos passos

Atualizar a configuração de um cluster autônomo
Personalize algumas configurações de cluster do Service Fabric.
Dimensione o cluster para dentro e para fora.

Partilhar via