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

Článek
08/25/2024

U jakéhokoli moderního systému je možnost 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 běžící na 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, označí se předchozí verze pro ukončení podpory po uplynutí minimálně 60 dnů od data oznámení. Nové verze jsou oznámeny na blogu týmu Service Fabric. Nová verze je dostupná pro výběr v tomto okamžiku.

Cluster můžete upgradovat na novou verzi jenom v případě, že používáte konfiguraci uzlu ve stylu produkčního prostředí, kde 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 znovu vytvořit s novou verzí.

Dva různé pracovní postupy můžou upgradovat cluster na nejnovější verzi nebo podporovanou verzi Service Fabric. Jedním z pracovních postupů je clustery, které mají připojení 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 stahovat aktualizace Service Fabric, když Microsoft vydá novou verzi, nastavte konfiguraci clusteru fabricClusterAutoupgradeEnabled na true. Pokud chcete ručně vybrat podporovanou verzi Service Fabric, kterou chcete, aby byl váš cluster zapnutý, nastavte konfiguraci clusteru fabricClusterAutoupgradeEnabled na hodnotu false.

Upgrade clusterů s připojením ke stažení nejnovějšího kódu a konfigurace

Pomocí těchto kroků upgradujte cluster na podporovanou verzi, pokud uzly clusteru mají připojení k internetu ke službě Microsoft Download Center.

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

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

Aktuální verze clusteru [version #] končí [datum]."

Jakmile cluster spustí nejnovější verzi, upozornění zmizí.

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

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ý je tento skript spuštěný, 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

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:
Spusťte upgrade clusteru na dostupnou verzi pomocí příkazu Start-ServiceFabricClusterUpgrade windows PowerShellu.
```
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 nejsou splněné zásady stavu clusteru, upgrade se vrátí zpět. Pokud chcete zadat vlastní zásady stavu pro příkaz Start-ServiceFabricClusterUpgrade, přečtěte si dokumentaci ke start-ServiceFabricClusterUpgrade.

Po opravě problémů, které způsobily vrácení zpět, spusťte upgrade znovu podle stejných kroků, jaké jsme popsali dříve.

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

Pomocí těchto kroků upgradujte cluster na podporovanou verzi, pokud uzly clusteru nemají připojení k internetu ke službě Microsoft Download Center.

Poznámka:

Pokud používáte cluster, který není připojený k internetu, musíte 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é vás upozorní na nové verze.

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

Pokud chcete povolit automatické stahování a registraci nejnovější verze kódu, nastavte službu Service Fabric Update Service. Pokyny najdete v tématu Nástroje\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 clusteru nastavte 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 ve formátu JSON aktualizovat clusterConfigurationVersion.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

Pracovní postup upgradu clusteru

Spusťte Get-ServiceFabricClusterUpgrade z jednoho z uzlů v clusteru a poznamenejte si TargetCodeVersion.
Spuštěním následujícího příkazu z počítače připojeného k internetu vypíšete všechny verze kompatibilní s upgradem s aktuální verzí a stáhnete 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> 
```

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

Zkopírujte stažený balíček do úložiště imagí clusteru.

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

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 monitorovat v Service Fabric Exploreru nebo můžete spustit následující příkaz PowerShellu:
```
Get-ServiceFabricClusterUpgrade
```
Pokud nejsou splněné zásady stavu clusteru, upgrade se vrátí zpět. Pokud chcete zadat vlastní zásady stavu pro příkaz Start-ServiceFabricClusterUpgrade, přečtěte si dokumentaci ke start-ServiceFabricClusterUpgrade.

Po opravě problémů, které způsobily vrácení zpět, spusťte upgrade znovu podle stejných kroků, jaké jsme popsali dříve.

Další kroky

Upgrade konfigurace samostatného clusteru
Přizpůsobte některá nastavení clusteru Service Fabric.
Vertikálně navyšte nebo navyšte kapacitu clusteru.

Sdílet prostřednictvím