Uppgradera Service Fabric-versionen som körs i klustret

Artikel
06/01/2023

För alla moderna system är möjligheten att uppgradera nyckeln till produktens långsiktiga framgång. Ett Azure Service Fabric-kluster är en resurs som du äger. Den här artikeln beskriver hur du uppgraderar den version av Service Fabric som körs på ditt fristående kluster.

Anteckning

Kontrollera att klustret alltid kör en Service Fabric-version som stöds. När Microsoft tillkännager lanseringen av en ny version av Service Fabric markeras den tidigare versionen för support upphör efter minst 60 dagar från datumet för tillkännagivandet. Nya versioner presenteras på Service Fabric-teamets blogg. Den nya versionen är tillgänglig att välja vid den tidpunkten.

Du kan bara uppgradera klustret till den nya versionen om du använder en nodkonfiguration i produktionsstil, där varje Service Fabric-nod allokeras på en separat fysisk eller virtuell dator. Om du har ett utvecklingskluster, där mer än en Service Fabric-nod finns på en enda fysisk eller virtuell dator, måste du återskapa klustret med den nya versionen.

Två distinkta arbetsflöden kan uppgradera klustret till den senaste versionen eller en Service Fabric-version som stöds. Ett arbetsflöde är för kluster som har anslutning för att ladda ned den senaste versionen automatiskt. Det andra arbetsflödet gäller för kluster som inte har anslutning för att ladda ned den senaste Service Fabric-versionen.

Aktivera automatisk uppgradering av Service Fabric-versionen av klustret

Om du vill att klustret ska ladda ned uppdateringar av Service Fabric när Microsoft släpper en ny version anger du klusterkonfigurationen fabricClusterAutoupgradeEnabled till true. Om du vill välja en version av Service Fabric som stöds manuellt som du vill att klustret ska vara på anger du klusterkonfigurationen fabricClusterAutoupgradeEnabled till falskt.

Uppgradera kluster som har anslutning för att ladda ned den senaste koden och konfigurationen

Använd de här stegen för att uppgradera klustret till en version som stöds om klusternoderna har internetanslutning till Microsoft Download Center.

För kluster som har anslutning till Microsoft Download Center söker Microsoft regelbundet efter tillgängligheten för nya Service Fabric-versioner.

När en ny Service Fabric-version är tillgänglig laddas paketet ned lokalt till klustret och etableras för uppgradering. För att informera kunden om den här nya versionen visar systemet dessutom en explicit varning om klusterhälsa som liknar följande:

"Stöd för den aktuella klusterversionen [version #] upphör [date]."

När klustret har kört den senaste versionen försvinner varningen.

När du ser varningen om klusterhälsa uppgraderar du klustret:

Anslut till klustret från alla datorer som har administratörsåtkomst till alla datorer som listas som noder i klustret. Den dator som skriptet körs på behöver inte vara en del av klustret.

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

Hämta listan över Service Fabric-versioner som du kan uppgradera till.
```
###### Get the list of available Service Fabric versions
Get-ServiceFabricRegisteredClusterCodeVersion
```
Du bör få utdata som liknar följande:
Starta en klusteruppgradering till en tillgänglig version med hjälp av kommandot Start-ServiceFabricClusterUpgrade 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
```
Om du vill övervaka uppgraderingens förlopp kan du använda Service Fabric Explorer eller köra följande PowerShell-kommando:
```
Get-ServiceFabricClusterUpgrade
```
Om principerna för klusterhälsa inte uppfylls återställs uppgraderingen. Information om hur du anger anpassade hälsoprinciper för kommandot Start-ServiceFabricClusterUpgrade finns i dokumentationen för Start-ServiceFabricClusterUpgrade.

När du har åtgärdat problemen som resulterade i återställningen initierar du uppgraderingen igen genom att följa samma steg som tidigare beskrivits.

Uppgradera kluster som inte har någon anslutning för att ladda ned den senaste koden och konfigurationen

Använd de här stegen för att uppgradera klustret till en version som stöds om klusternoderna inte har internetanslutning till Microsoft Download Center.

Anteckning

Om du kör ett kluster som inte är anslutet till Internet måste du övervaka Service Fabric-teamets blogg för att lära dig mer om nya versioner. Systemet visar ingen varning om klusterhälsa för att varna dig om nya versioner.

Automatisk etablering jämfört med manuell etablering

Om du vill aktivera automatisk nedladdning och registrering för den senaste kodversionen konfigurerar du Service Fabric-uppdateringstjänsten. Anvisningar finns iTools\ServiceFabricUpdateService.zip\Readme_InstructionsAndHowTos.txt i det fristående paketet.

Följ de här anvisningarna för den manuella processen.

Ändra klusterkonfigurationen så att följande egenskap anges till false innan du startar en konfigurationsuppgradering:

"fabricClusterAutoupgradeEnabled": false,

Information om användning finns i PowerShell-kommandot Start-ServiceFabricClusterConfigurationUpgrade . Se till att uppdatera "clusterConfigurationVersion" i din JSON innan du startar konfigurationsuppgraderingen.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

Arbetsflöde för klusteruppgradering

Kör Get-ServiceFabricClusterUpgrade från en av noderna i klustret och notera TargetCodeVersion.
Kör följande från en Internetansluten dator för att visa en lista över alla uppgraderingskompatibla versioner med den aktuella versionen och ladda ned motsvarande paket från de associerade nedladdningslänkarna:
```
###### Get list of all upgrade compatible packages  
Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion <TargetCodeVersion as noted in Step 1> 
```