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

  • Artikel

Voor elk modern systeem is de mogelijkheid om te upgraden essentieel voor het succes van uw product op de 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 gemarkeerd voor beëindiging van de ondersteuning na minimaal 60 dagen vanaf de datum van de aankondiging. Nieuwe releases worden aangekondigd op de Blog van het Service Fabric-team. De nieuwe release is op dat moment beschikbaar om te kiezen.

U kunt uw cluster alleen upgraden naar de nieuwe versie als u een knooppuntconfiguratie in productiestijl gebruikt, waarbij elk Service Fabric-knooppunt wordt toegewezen op een afzonderlijke fysieke of virtuele machine. Als u een ontwikkelcluster hebt waarin 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. Een werkstroom is voor clusters met connectiviteit om de nieuwste versie automatisch te downloaden. De andere werkstroom is 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 wilt instellen dat uw cluster updates van Service Fabric downloadt wanneer Microsoft een nieuwe versie uitbrengt, stelt u de fabricClusterAutoupgradeEnabled clusterconfiguratie in op true. Als u handmatig een ondersteunde versie van Service Fabric wilt selecteren waarop u uw cluster wilt gebruiken, 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 bij te werken naar een ondersteunde versie als uw clusterknooppunten 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, geeft het systeem bovendien een expliciete clusterstatuswaarschuwing weer die vergelijkbaar is met het volgende:

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

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

Wanneer u de clusterstatuswaarschuwing ziet, voert u een upgrade uit van het cluster:

  1. Maak verbinding met het cluster vanaf elke computer met beheerderstoegang 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 krijgt een uitvoer die er ongeveer als volgt uitziet:

    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 te volgen als eerder beschreven.

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

Gebruik deze stappen om uw cluster bij te werken 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 de Service Fabric-teamblog controleren voor meer informatie over nieuwe releases. Het systeem geeft geen clusterstatuswaarschuwing weer om u te waarschuwen voor nieuwe releases.

Automatische inrichting versus handmatige inrichting

Als u automatisch downloaden en registreren voor de nieuwste codeversie wilt inschakelen, 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 meer informatie over het gebruik. 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 de TargetCodeVersion.

  2. Voer het volgende uit vanaf een computer met internetverbinding om alle upgrade-compatibele 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 met beheerderstoegang 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 van de clusterinstallatiekopie.

  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 controleren op Service Fabric Explorer 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 te volgen als eerder beschreven.

Volgende stappen