Delen via


De Service Fabric-versie bijwerken die wordt uitgevoerd op uw cluster

Voor elk modern systeem is de mogelijkheid om te upgraden essentieel voor het succes van uw product op lange termijn. Een Azure Service Fabric-cluster is een resource die u bezit. In dit artikel wordt beschreven hoe u een upgrade uitvoert van de versie van Service Fabric die wordt uitgevoerd op uw zelfstandige cluster.

Notitie

Zorg ervoor dat uw cluster altijd een ondersteunde Service Fabric-versie uitvoert. Wanneer Microsoft de release van een nieuwe versie van Service Fabric aankondigt, wordt de vorige versie na minimaal 60 dagen na de datum van de aankondiging gemarkeerd voor het einde van de ondersteuning. Nieuwe releases worden aangekondigd in de Service Fabric-teamblog. De nieuwe release is beschikbaar om op dat moment te kiezen.

U kunt uw cluster alleen upgraden naar de nieuwe versie als u een configuratie van een productieknooppunt gebruikt, waarbij elk Service Fabric-knooppunt wordt toegewezen op een afzonderlijke fysieke of virtuele machine. Als u een ontwikkelcluster hebt, waarbij meer dan één Service Fabric-knooppunt zich op één fysieke of virtuele machine bevindt, moet u het cluster opnieuw maken met de nieuwe versie.

Twee afzonderlijke werkstromen kunnen uw cluster upgraden naar de nieuwste versie of een ondersteunde Service Fabric-versie. Eén werkstroom is bedoeld voor clusters die verbinding hebben om automatisch de nieuwste versie te downloaden. De andere werkstroom is bedoeld voor clusters die geen verbinding hebben om de nieuwste Service Fabric-versie te downloaden.

Automatische upgrade van de Service Fabric-versie van uw cluster inschakelen

Als u uw cluster wilt instellen om updates van Service Fabric te downloaden wanneer Microsoft een nieuwe versie publiceert, stelt u de fabricClusterAutoupgradeEnabled clusterconfiguratie in op waar. Als u handmatig een ondersteunde versie van Service Fabric wilt selecteren waarop uw cluster moet zijn ingeschakeld, stelt u de fabricClusterAutoupgradeEnabled clusterconfiguratie in op false.

Clusters upgraden die connectiviteit hebben om de meest recente code en configuratie te downloaden

Gebruik deze stappen om uw cluster te upgraden naar een ondersteunde versie als uw clusterknooppunten een internetverbinding hebben met het Microsoft Downloadcentrum.

Voor clusters die verbinding hebben met het Microsoft Downloadcentrum, controleert Microsoft regelmatig op de beschikbaarheid van nieuwe Service Fabric-versies.

Wanneer er een nieuwe Service Fabric-versie beschikbaar is, wordt het pakket lokaal gedownload naar het cluster en ingericht voor een upgrade. Om de klant op de hoogte te stellen van deze nieuwe versie, toont het systeem bovendien een expliciete clusterstatuswaarschuwing die vergelijkbaar is met de volgende:

"De huidige clusterversie [versie #] ondersteunt eindigt [datum]."

Nadat het cluster de nieuwste versie heeft uitgevoerd, verdwijnt de waarschuwing.

Wanneer u de waarschuwing over de clusterstatus ziet, voert u een upgrade uit van het cluster:

  1. Maak verbinding met het cluster vanaf elke computer die beheerderstoegang heeft tot alle computers die worden vermeld als knooppunten in het cluster. De computer waarop dit script wordt uitgevoerd, hoeft geen deel uit te maken van het 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
    
  2. Haal de lijst met Service Fabric-versies op waarnaar u een upgrade kunt uitvoeren.

    ###### Get the list of available Service Fabric versions
    Get-ServiceFabricRegisteredClusterCodeVersion
    

    U moet een uitvoer krijgen die er ongeveer als volgt uit ziet:

    Service Fabric-versies ophalen

  3. Start een clusterupgrade naar een beschikbare versie met behulp van de Opdracht 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
    

    Als u de voortgang van de upgrade wilt controleren, kunt u Service Fabric Explorer gebruiken of de volgende PowerShell-opdracht uitvoeren:

    Get-ServiceFabricClusterUpgrade
    

    Als niet aan het clusterstatusbeleid wordt voldaan, wordt de upgrade teruggedraaid. Raadpleeg de documentatie voor Start-ServiceFabricClusterUpgrade om aangepast statusbeleid op te geven voor de opdracht Start-ServiceFabricClusterUpgrade.

    Nadat u de problemen hebt opgelost die hebben geleid tot het terugdraaien, start u de upgrade opnieuw door dezelfde stappen uit te voeren als eerder beschreven.

Clusters upgraden die geen verbinding hebben om de meest recente code en configuratie te downloaden

Gebruik deze stappen om uw cluster te upgraden naar een ondersteunde versie als uw clusterknooppunten geen internetverbinding hebben met het Microsoft Downloadcentrum.

Notitie

Als u een cluster uitvoert dat niet is verbonden met internet, moet u het Service Fabric-teamblog controleren om meer te weten te komen over nieuwe releases. Er wordt geen clusterstatuswaarschuwing weergegeven om u te waarschuwen voor nieuwe releases.

Automatische inrichting versus handmatige inrichting

Als u automatisch downloaden en registreren wilt inschakelen voor de meest recente codeversie, stelt u de Service Fabric Update Service in. Zie Tools\ServiceFabricUpdateService.zip\Readme_InstructionsAndHowTos.txt in het zelfstandige pakket voor instructies.

Volg deze instructies voor het handmatige proces.

Wijzig de clusterconfiguratie om de volgende eigenschap in te stellen op false voordat u een configuratie-upgrade start:

"fabricClusterAutoupgradeEnabled": false,

Zie de PowerShell-opdracht Start-ServiceFabricClusterConfigurationUpgrade voor gebruiksgegevens. Zorg ervoor dat u 'clusterConfigurationVersion' bijwerkt in uw JSON voordat u de configuratie-upgrade start.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

Werkstroom voor clusterupgrade

  1. Voer Get-ServiceFabricClusterUpgrade uit vanaf een van de knooppunten in het cluster en noteer targetCodeVersion.

  2. Voer het volgende uit vanaf een computer met internetverbinding om alle upgradecompatibele versies met de huidige versie weer te geven en download het bijbehorende pakket via de bijbehorende downloadkoppelingen:

    ###### Get list of all upgrade compatible packages  
    Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion <TargetCodeVersion as noted in Step 1> 
    
  3. Maak verbinding met het cluster vanaf elke computer die beheerderstoegang heeft tot alle computers die worden vermeld als knooppunten in het cluster. De computer waarop dit script wordt uitgevoerd, hoeft geen deel uit te maken van het cluster.

    ###### 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. Kopieer het gedownloade pakket naar het archief met clusterinstallatiekopieën.

  5. Registreer het gekopieerde pakket.

    ###### 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. Start een clusterupgrade naar een beschikbare versie.

    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
    

    U kunt de voortgang van de upgrade in Service Fabric Explorer controleren of u kunt de volgende PowerShell-opdracht uitvoeren:

    Get-ServiceFabricClusterUpgrade
    

    Als niet aan het clusterstatusbeleid wordt voldaan, wordt de upgrade teruggedraaid. Raadpleeg de documentatie voor Start-ServiceFabricClusterUpgrade om aangepast statusbeleid op te geven voor de opdracht Start-ServiceFabricClusterUpgrade.

    Nadat u de problemen hebt opgelost die hebben geleid tot het terugdraaien, start u de upgrade opnieuw door dezelfde stappen uit te voeren als eerder beschreven.

Volgende stappen