Udostępnij za pośrednictwem


Uaktualnianie wersji usługi Service Fabric uruchomionej w klastrze

W przypadku każdego 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łosi wydanie nowej wersji usługi Service Fabric, poprzednia wersja zostanie oznaczona do zakończenia wsparcia technicznego 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, w której każdy węzeł usługi Service Fabric jest przydzielany na oddzielnej maszynie fizycznej lub wirtualnej. Jeśli masz klaster projektowy, 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 do pobierania aktualizacji usługi Service Fabric, gdy firma Microsoft wyda nową wersję, ustaw konfigurację klastra fabricClusterAutoupgradeEnabled na wartość true. Aby ręcznie wybrać obsługiwaną wersję usługi Service Fabric, do której ma być włączony klaster, 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ść z Internetem 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.

Gdy jest dostępna nowa wersja usługi Service Fabric, pakiet jest pobierany lokalnie do klastra i aprowizowany do uaktualnienia. Ponadto w celu poinformowania klienta o tej nowej wersji system wyświetla jawne ostrzeżenie o kondycji klastra podobne do następującego:

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

Po uruchomieniu najnowszej wersji klastra ostrzeżenie zniknie.

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

  1. 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
    
  2. 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:

    Pobieranie wersji usługi Service Fabric

  3. Uruchom uaktualnienie klastra do dostępnej wersji przy użyciu polecenia Start-ServiceFabricClusterUpgrade środowiska 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ć narzędzia 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 dla 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 aprowizacja ręczna

Aby włączyć automatyczne pobieranie i rejestrację dla najnowszej wersji kodu, skonfiguruj usługę Aktualizacji usługi Service Fabric. Aby uzyskać instrukcje, zobacz Narzędzia\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 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 o zaktualizowaniu pliku "clusterConfigurationVersion" w formacie JSON.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

Przepływ pracy uaktualniania klastra

  1. Uruchom polecenie Get-ServiceFabricClusterUpgrade z jednego z węzłów w klastrze i zanotuj wartość TargetCodeVersion.

  2. 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> 
    
  3. 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.

    ###### 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. Skopiuj pobrany pakiet do magazynu obrazów klastra.

  5. 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
    
  6. 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
    

    Możesz monitorować postęp uaktualniania w programie 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 dla 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.

Następne kroki