Upgrade verze Service Fabric, která běží na vašem clusteru

  • Článek

U každého moderního systému je schopnost upgradu klíčem k dlouhodobému úspěchu vašeho produktu. Cluster Azure Service Fabric je prostředek, který vlastníte. Tento článek popisuje, jak upgradovat verzi Service Fabric spuštěnou v samostatném clusteru.

Poznámka

Ujistěte se, že váš cluster vždy používá podporovanou verzi Service Fabric. Když Microsoft oznámí vydání nové verze Service Fabric, předchozí verze se po uplynutí minimálně 60 dnů od data oznámení označí jako ukončená podpora. Nové verze jsou oznámeny na blogu týmu Service Fabric. V tomto okamžiku si můžete vybrat novou verzi.

Cluster můžete upgradovat na novou verzi pouze v případě, že používáte konfiguraci uzlu ve stylu produkčního prostředí, kdy je každý uzel Service Fabric přidělený na samostatném fyzickém nebo virtuálním počítači. Pokud máte vývojový cluster, ve kterém je na jednom fyzickém nebo virtuálním počítači více než jeden uzel Service Fabric, musíte cluster vytvořit znovu s novou verzí.

Cluster můžete upgradovat na nejnovější verzi nebo podporovanou verzi Service Fabric dvěma různými pracovními postupy. Jeden pracovní postup je určený pro clustery s připojením ke stažení nejnovější verze automaticky. Druhý pracovní postup je pro clustery, které nemají připojení ke stažení nejnovější verze Service Fabric.

Povolení automatického upgradu verze Service Fabric vašeho clusteru

Pokud chcete nastavit cluster tak, aby se stahovály aktualizace Service Fabric, když Microsoft vydá novou verzi, nastavte konfiguraci clusteru fabricClusterAutoupgradeEnabled na true. Pokud chcete ručně vybrat podporovanou verzi Service Fabric, na které chcete mít cluster, nastavte konfiguraci clusteru fabricClusterAutoupgradeEnabled na false.

Upgradujte clustery, které mají připojení ke stažení nejnovějšího kódu a konfigurace.

Pokud uzly clusteru mají připojení k internetu ke službě Stažení softwaru, použijte tento postup k upgradu clusteru na podporovanou verzi.

U clusterů, které mají připojení ke službě Microsoft Download Center, Microsoft pravidelně kontroluje dostupnost nových verzí Service Fabric.

Když je k dispozici nová verze Service Fabric, balíček se stáhne místně do clusteru a zřídí se pro upgrade. Aby systém informoval zákazníka o této nové verzi, zobrazuje explicitní upozornění na stav clusteru, které je podobné následujícímu:

Podpora aktuální verze clusteru [version #] končí [date]."

Jakmile v clusteru běží nejnovější verze, upozornění zmizí.

Když se zobrazí upozornění na stav clusteru, upgradujte cluster:

  1. Připojte se ke clusteru z libovolného počítače, který má přístup správce ke všem počítačům uvedeným jako uzly v clusteru. Počítač, na kterých se tento skript spouští, nemusí být součástí clusteru.

    ###### 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. Získejte seznam verzí Service Fabric, na které můžete upgradovat.

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

    Měl by se zobrazit výstup podobný tomuto:

    Získání verzí Service Fabric

  3. Spusťte upgrade clusteru na dostupnou verzi pomocí příkazu 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

    Pokud chcete monitorovat průběh upgradu, můžete použít Service Fabric Explorer nebo spustit následující příkaz PowerShellu:

    Get-ServiceFabricClusterUpgrade

    Pokud zásady stavu clusteru nejsou splněné, upgrade se vrátí zpět. Pokud chcete pro příkaz Start-ServiceFabricClusterUpgrade zadat vlastní zásady stavu, přečtěte si dokumentaci pro Start-ServiceFabricClusterUpgrade.

    Po vyřešení problémů, které vedly k vrácení zpět, zahajte upgrade znovu pomocí stejných kroků, které jsme popsali výše.

Upgradujte clustery, které nemají připojení ke stažení nejnovějšího kódu a konfigurace.

Pokud uzly clusteru nemají připojení k internetu ke službě Stažení softwaru, použijte tento postup k upgradu clusteru na podporovanou verzi.

Poznámka

Pokud používáte cluster, který není připojený k internetu, budete muset sledovat blog týmu Service Fabric , abyste se dozvěděli o nových verzích. Systém nezobrazuje upozornění na stav clusteru, které by vás upozornilo na nové verze.

Automatické zřizování vs. ruční zřizování

Pokud chcete povolit automatické stahování a registraci pro nejnovější verzi kódu, nastavte službu Service Fabric Update Service. Pokyny najdete v tématuTools\ServiceFabricUpdateService.zip\Readme_InstructionsAndHowTos.txt v samostatném balíčku.

V případě ručního procesu postupujte podle těchto pokynů.

Před zahájením upgradu konfigurace upravte konfiguraci clusteru tak, aby nastavil následující vlastnost na false :

"fabricClusterAutoupgradeEnabled": false,

Podrobnosti o využití najdete v příkazu PowerShellu Start-ServiceFabricClusterConfigurationUpgrade . Před zahájením upgradu konfigurace nezapomeňte aktualizovat clusterConfigurationVersion ve vašem kódu JSON.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

Pracovní postup upgradu clusteru

  1. Z jednoho z uzlů v clusteru spusťte rutinu Get-ServiceFabricClusterUpgrade a poznamenejte si hodnotu TargetCodeVersion.

  2. Spuštěním následujícího příkazu z počítače připojeného k internetu zobrazte seznam všech verzí kompatibilních s upgradem s aktuální verzí a stáhněte si odpovídající balíček z přidružených odkazů ke stažení:

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

  3. Připojte se ke clusteru z libovolného počítače, který má přístup správce ke všem počítačům uvedeným jako uzly v clusteru. Počítač, na kterých se tento skript spouští, nemusí být součástí clusteru.

    ###### 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. Zkopírujte stažený balíček do úložiště imagí clusteru.

  5. Zaregistrujte zkopírovaný balíček.

    ###### 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. Spusťte upgrade clusteru na dostupnou verzi.

    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

    Průběh upgradu můžete sledovat na Service Fabric Explorer nebo můžete spustit následující příkaz PowerShellu:

    Get-ServiceFabricClusterUpgrade

    Pokud zásady stavu clusteru nejsou splněné, upgrade se vrátí zpět. Pokud chcete pro příkaz Start-ServiceFabricClusterUpgrade zadat vlastní zásady stavu, přečtěte si dokumentaci pro Start-ServiceFabricClusterUpgrade.

    Po vyřešení problémů, které vedly k vrácení zpět, zahajte upgrade znovu pomocí stejných kroků, které jsme popsali výše.

Další kroky