Aggiornare la versione di Service Fabric eseguita nel cluster

Articolo
2025-04-24

Per qualsiasi sistema moderno, la possibilità di eseguire l'aggiornamento è fondamentale per il successo a lungo termine del prodotto. Un cluster di Azure Service Fabric è una risorsa di cui si è proprietari. Questo articolo descrive come aggiornare la versione di Service Fabric in esecuzione nel cluster autonomo.

Annotazioni

Assicurarsi che il cluster esegua sempre una versione di Service Fabric supportata. Quando Microsoft annuncia il rilascio di una nuova versione di Service Fabric, la versione precedente viene contrassegnata per la fine del supporto dopo almeno 60 giorni dalla data dell'annuncio. Le nuove versioni vengono annunciate nel blog del team di Service Fabric. La nuova versione è disponibile per scegliere a questo punto.

È possibile aggiornare il cluster alla nuova versione solo se si usa una configurazione del nodo in stile produzione, in cui ogni nodo di Service Fabric viene allocato in una macchina fisica o virtuale separata. Se si dispone di un cluster di sviluppo, in cui più nodi di Service Fabric si trovano in una singola macchina fisica o virtuale, è necessario ricreare il cluster con la nuova versione.

Due flussi di lavoro distinti possono aggiornare il cluster alla versione più recente o a una versione supportata di Service Fabric. Un flusso di lavoro è destinato ai cluster con connettività per scaricare automaticamente la versione più recente. L'altro flusso di lavoro è destinato ai cluster che non hanno connettività per scaricare la versione più recente di Service Fabric.

Abilitare l'aggiornamento automatico della versione di Service Fabric del cluster

Per impostare il cluster per scaricare gli aggiornamenti di Service Fabric quando Microsoft rilascia una nuova versione, impostare la configurazione del fabricClusterAutoupgradeEnabled cluster su true. Per selezionare manualmente una versione supportata di Service Fabric in cui si vuole che il cluster sia attivo, impostare la configurazione del fabricClusterAutoupgradeEnabled cluster su false.

Aggiornare i cluster con connettività per scaricare il codice e la configurazione più recenti

Seguire questa procedura per aggiornare il cluster a una versione supportata se i nodi del cluster hanno connettività Internet all'Area download Microsoft.

Per i cluster con connettività all'Area download Microsoft, Microsoft verifica periodicamente la disponibilità delle nuove versioni di Service Fabric.

Quando è disponibile una nuova versione di Service Fabric, il pacchetto viene scaricato localmente nel cluster ed è stato effettuato il provisioning per l'aggiornamento. Inoltre, per informare il cliente di questa nuova versione, il sistema visualizza un avviso esplicito di integrità del cluster simile al seguente:

"Il supporto per la versione corrente del cluster [numero versione] termina il [data]."

Dopo che il cluster esegue la versione più recente, l'avviso viene eliminato.

Quando viene visualizzato l'avviso di integrità del cluster, aggiornare il cluster:

Connettersi al cluster da qualsiasi computer con accesso amministratore a tutti i computer elencati come nodi nel cluster. Il computer in cui viene eseguito questo script non deve far parte del cluster.

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

Ottenere l'elenco delle versioni di Service Fabric a cui è possibile eseguire l'aggiornamento.
```
###### Get the list of available Service Fabric versions
Get-ServiceFabricRegisteredClusterCodeVersion
```
Dovrebbe essere visualizzato un output simile al seguente:
Avviare un aggiornamento del cluster a una versione disponibile usando il comando Start-ServiceFabricClusterUpgrade di 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
```
Per monitorare lo stato di avanzamento dell'aggiornamento, è possibile usare Service Fabric Explorer o eseguire il comando di PowerShell seguente:
```
Get-ServiceFabricClusterUpgrade
```
Se i criteri di integrità del cluster non vengono soddisfatti, viene eseguito il rollback dell'aggiornamento. Per specificare criteri di integrità personalizzati per il comando Start-ServiceFabricClusterUpgrade, vedere la documentazione relativa a Start-ServiceFabricClusterUpgrade.

Dopo aver risolto i problemi che hanno generato il rollback, avviare di nuovo l'aggiornamento seguendo gli stessi passaggi descritti in precedenza.

Aggiornare i cluster senza connettività per scaricare il codice e la configurazione più recenti

Utilizzare questi passaggi per aggiornare il cluster a una versione supportata se i nodi del cluster non hanno connettività Internet al Microsoft Download Center.

Annotazioni

Se si esegue un cluster che non è connesso a Internet, è necessario monitorare il blog del team di Service Fabric per informazioni sulle nuove versioni. Il sistema non mostra un avviso sullo stato di salute del cluster per informarti delle nuove versioni.

Confronto tra provisioning automatico e provisioning manuale

Per abilitare il download automatico e la registrazione per la versione del codice più recente, configurare il servizio di aggiornamento di Service Fabric. Per istruzioni, vedere Strumenti\ServiceFabricUpdateService.zip\Readme_InstructionsAndHowTos.txt nel pacchetto autonomo.

Per il processo manuale, seguire queste istruzioni.

Modificare la configurazione del cluster per impostare la proprietà seguente su false prima di avviare un aggiornamento della configurazione:

"fabricClusterAutoupgradeEnabled": false,

Per informazioni dettagliate sull'utilizzo, vedere il comando Start-ServiceFabricClusterConfigurationUpgrade di PowerShell. Assicurarsi di aggiornare "clusterConfigurationVersion" nel codice JSON prima di avviare l'aggiornamento della configurazione.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

Flusso di lavoro di aggiornamento del cluster

Eseguire Get-ServiceFabricClusterUpgrade da uno dei nodi del cluster e prendere nota di TargetCodeVersion.
Eseguire il comando seguente da un computer connesso a Internet per elencare tutte le versioni compatibili con l'aggiornamento con la versione corrente e scaricare il pacchetto corrispondente dai collegamenti di download associati:
```
###### 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"

Copiare il pacchetto scaricato nell'archivio immagini del cluster.

Registrare il pacchetto copiato.

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

Avviare un aggiornamento del cluster a una versione disponibile.
```
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
```
È possibile monitorare lo stato di avanzamento dell'aggiornamento in Service Fabric Explorer oppure eseguire il comando di PowerShell seguente:
```
Get-ServiceFabricClusterUpgrade
```
Se i criteri di integrità del cluster non vengono soddisfatti, viene eseguito il rollback dell'aggiornamento. Per specificare criteri di integrità personalizzati per il comando Start-ServiceFabricClusterUpgrade, vedere la documentazione relativa a Start-ServiceFabricClusterUpgrade.

Dopo aver risolto i problemi che hanno generato il rollback, avviare di nuovo l'aggiornamento seguendo gli stessi passaggi descritti in precedenza.

Passaggi successivi

Aggiornare la configurazione di un cluster autonomo
Personalizzare alcune impostazioni del cluster di Service Fabric.
Ridimensiona il cluster aumentandolo o riducendolo.

Condividi tramite