Dela via

Uppgradera den Service Fabric-version som körs i klustret

  • Artikel

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 i ditt fristående kluster.

Kommentar

Kontrollera att klustret alltid kör en Service Fabric-version som stöds. När Microsoft meddelar att en ny version av Service Fabric har släppts markeras den tidigare versionen för supportens slut efter minst 60 dagar från dagen för tillkännagivandet. Nya versioner tillkännages 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å ställer du in klusterkonfigurationen fabricClusterAutoupgradeEnabled på false.

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 hälsovarning för klustret som liknar följande:

"Den aktuella klusterversionen [version #] support upphör [datum]."

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

När du ser klustrets hälsovarning uppgraderar du klustret:

  1. Anslut till klustret från alla datorer som har administratörsåtkomst till alla datorer som visas 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

  2. 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:

    Hämta Service Fabric-versioner

  3. Starta en klusteruppgradering till en tillgänglig version med hjälp av Windows PowerShell-kommandot Start-ServiceFabricClusterUpgrade .

    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 klustrets hälsoprinciper 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 de problem 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 dina klusternoder inte har internetanslutning till Microsoft Download Center.

Kommentar

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 Update Service. Anvisningar finns i Verktyg\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,

Mer 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

  1. Kör Get-ServiceFabricClusterUpgrade från en av noderna i klustret och notera TargetCodeVersion.

  2. Kör följande från en Internetansluten dator för att visa alla uppgraderingskompatibla versioner med den aktuella versionen och ladda ned motsvarande paket från tillhörande nedladdningslänkar:

    ###### Get list of all upgrade compatible packages  
Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion <TargetCodeVersion as noted in Step 1>

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

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

  4. Kopiera det nedladdade paketet till klusteravbildningsarkivet.

  5. Registrera det kopierade paketet.

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

  6. Starta en klusteruppgradering till en tillgänglig version.

    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

    Du kan övervaka uppgraderingens förlopp i Service Fabric Explorer eller köra följande PowerShell-kommando:

    Get-ServiceFabricClusterUpgrade

    Om klustrets hälsoprinciper 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 de problem som resulterade i återställningen initierar du uppgraderingen igen genom att följa samma steg som tidigare beskrivits.

Nästa steg