Uaktualnianie wersji usługi Service Fabric uruchomionej w klastrze

Artykuł
06/01/2023

W przypadku dowolnego nowoczesnego systemu możliwość uaktualnienia jest kluczem do długoterminowego sukcesu produktu. Klaster usługi Azure Service Fabric to zasób, którego jesteś właścicielem. W tym artykule opisano sposób uaktualniania wersji usługi Service Fabric uruchomionej w klastrze autonomicznym.

Uwaga

Upewnij się, że klaster zawsze uruchamia obsługiwaną wersję usługi Service Fabric. Gdy firma Microsoft ogłasza wydanie nowej wersji usługi Service Fabric, poprzednia wersja zostanie oznaczona do zakończenia pomocy technicznej po upływie co najmniej 60 dni od daty ogłoszenia. Nowe wersje są ogłaszane na blogu zespołu usługi Service Fabric. Nowa wersja jest dostępna do wyboru w tym momencie.

Klaster można uaktualnić do nowej wersji tylko wtedy, gdy używasz konfiguracji węzła w stylu produkcyjnym, gdzie każdy węzeł usługi Service Fabric jest przydzielany na oddzielnej maszynie fizycznej lub wirtualnej. Jeśli masz klaster deweloperów, w którym znajduje się więcej niż jeden węzeł usługi Service Fabric na jednej maszynie fizycznej lub wirtualnej, musisz ponownie utworzyć klaster z nową wersją.

Dwa odrębne przepływy pracy mogą uaktualnić klaster do najnowszej wersji lub obsługiwanej wersji usługi Service Fabric. Jednym z przepływów pracy są klastry, które mają łączność z automatycznym pobieraniem najnowszej wersji. Drugi przepływ pracy dotyczy klastrów, które nie mają łączności z pobieraniem najnowszej wersji usługi Service Fabric.

Włączanie automatycznego uaktualniania wersji klastra usługi Service Fabric

Aby ustawić klaster w celu pobrania aktualizacji usługi Service Fabric, gdy firma Microsoft wyda nową wersję, ustaw dla konfiguracji klastra fabricClusterAutoupgradeEnabledwartość true. Aby ręcznie wybrać obsługiwaną wersję usługi Service Fabric, która ma być włączona w klastrze, ustaw konfigurację klastra fabricClusterAutoupgradeEnabled na wartość false.

Uaktualnianie klastrów, które mają łączność w celu pobrania najnowszego kodu i konfiguracji

Wykonaj następujące kroki, aby uaktualnić klaster do obsługiwanej wersji, jeśli węzły klastra mają łączność internetową z Centrum pobierania Microsoft.

W przypadku klastrów, które mają łączność z Centrum pobierania Microsoft, firma Microsoft okresowo sprawdza dostępność nowych wersji usługi Service Fabric.

Po udostępnieniu nowej wersji usługi Service Fabric pakiet jest pobierany lokalnie do klastra i aprowizowany do uaktualnienia. Ponadto, aby poinformować klienta o tej nowej wersji, system wyświetla jawne ostrzeżenie o kondycji klastra podobne do następującego:

"Bieżąca wersja klastra [wersja #] kończy się [date]."

Po uruchomieniu najnowszej wersji klastra ostrzeżenie zniknie.

Po wyświetleniu ostrzeżenia o kondycji klastra uaktualnij klaster:

Połącz się z klastrem z dowolnej maszyny, która ma dostęp administratora do wszystkich maszyn wymienionych jako węzły w klastrze. Maszyna, na którą jest uruchamiany ten skrypt, nie musi być częścią klastra.

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

Pobierz listę wersji usługi Service Fabric, do których można przeprowadzić uaktualnienie.
```
###### Get the list of available Service Fabric versions
Get-ServiceFabricRegisteredClusterCodeVersion
```
Powinny zostać wyświetlone dane wyjściowe podobne do następujących:
Uruchom uaktualnienie klastra do dostępnej wersji przy użyciu polecenia 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
```
Aby monitorować postęp uaktualniania, możesz użyć Service Fabric Explorer lub uruchomić następujące polecenie programu PowerShell:
```
Get-ServiceFabricClusterUpgrade
```
Jeśli zasady kondycji klastra nie zostaną spełnione, uaktualnienie zostanie wycofane. Aby określić niestandardowe zasady kondycji polecenia Start-ServiceFabricClusterUpgrade, zobacz dokumentację polecenia Start-ServiceFabricClusterUpgrade.

Po rozwiązaniu problemów, które spowodowały wycofanie, zainicjuj uaktualnienie ponownie, wykonując te same kroki, co wcześniej opisane.

Uaktualnianie klastrów bez łączności w celu pobrania najnowszego kodu i konfiguracji

Wykonaj następujące kroki, aby uaktualnić klaster do obsługiwanej wersji, jeśli węzły klastra nie mają łączności z Internetem z Centrum pobierania Microsoft.

Uwaga

Jeśli korzystasz z klastra, który nie jest połączony z Internetem, musisz monitorować blog zespołu usługi Service Fabric , aby dowiedzieć się więcej o nowych wersjach. System nie wyświetla ostrzeżenia o kondycji klastra, aby otrzymywać alerty o nowych wersjach.

Automatyczna aprowizacja a ręczna aprowizacja

Aby włączyć automatyczne pobieranie i rejestrację dla najnowszej wersji kodu, skonfiguruj usługę Service Fabric Update Service. Aby uzyskać instrukcje, zobacz Tools\ServiceFabricUpdateService.zip\Readme_InstructionsAndHowTos.txt w pakiecie autonomicznym.

W przypadku procesu ręcznego postępuj zgodnie z tymi instrukcjami.

Zmodyfikuj konfigurację klastra, aby ustawić następującą właściwość na wartość false przed rozpoczęciem uaktualniania konfiguracji:

"fabricClusterAutoupgradeEnabled": false,

Aby uzyskać szczegółowe informacje o użyciu, zobacz polecenie Start-ServiceFabricClusterConfigurationUpgrade Programu PowerShell. Przed rozpoczęciem uaktualniania konfiguracji pamiętaj, aby zaktualizować plik "clusterConfigurationVersion" w formacie JSON.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

Przepływ pracy uaktualniania klastra

Uruchom polecenie Get-ServiceFabricClusterUpgrade z jednego z węzłów w klastrze i zanotuj wartość TargetCodeVersion.
Uruchom następujące polecenie z komputera połączonego z Internetem, aby wyświetlić listę wszystkich wersji zgodnych z uaktualnieniem z bieżącą wersją i pobrać odpowiedni pakiet ze skojarzonych linków pobierania:
```
###### 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"

Skopiuj pobrany pakiet do magazynu obrazów klastra.

Zarejestruj skopiowany pakiet.

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

Uruchom uaktualnienie klastra do dostępnej wersji.
```
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
```
Postęp uaktualniania można monitorować na Service Fabric Explorer lub uruchomić następujące polecenie programu PowerShell:
```
Get-ServiceFabricClusterUpgrade
```
Jeśli zasady kondycji klastra nie zostaną spełnione, uaktualnienie zostanie wycofane. Aby określić niestandardowe zasady kondycji polecenia Start-ServiceFabricClusterUpgrade, zobacz dokumentację polecenia Start-ServiceFabricClusterUpgrade.

Po rozwiązaniu problemów, które spowodowały wycofanie, zainicjuj uaktualnienie ponownie, wykonując te same kroki, co wcześniej opisane.