Samouczek: uaktualnianie środowiska uruchomieniowego klastra usługi Service Fabric na platformie Azure

Ten samouczek jest częścią czwartej serii i pokazuje, jak uaktualnić środowisko uruchomieniowe usługi Service Fabric w klastrze usługi Azure Service Fabric. Ta część samouczka jest napisana dla klastrów usługi Service Fabric działających na platformie Azure i nie ma zastosowania do autonomicznych klastrów usługi Service Fabric.

Ostrzeżenie

Ta część samouczka wymaga programu PowerShell. Obsługa uaktualniania środowiska uruchomieniowego klastra nie jest jeszcze obsługiwana przez narzędzia interfejsu wiersza polecenia platformy Azure. Alternatywnie klaster można uaktualnić w portalu. Aby uzyskać więcej informacji, zobacz Uaktualnianie klastra usługi Azure Service Fabric.

Jeśli klaster jest już uruchomiony w najnowszym środowisku uruchomieniowym usługi Service Fabric, nie musisz wykonywać tego kroku. Jednak ten artykuł może służyć do instalowania dowolnego obsługiwanego środowiska uruchomieniowego w klastrze usługi Azure Service Fabric.

Z tego samouczka dowiesz się, jak wykonywać następujące działania:

  • Odczytaj wersję klastra
  • Ustawianie wersji klastra

Ta seria samouczków zawiera informacje na temat wykonywania następujących czynności:

Uwaga

Zalecamy korzystanie z modułu Azure Az programu PowerShell do interakcji z platformą Azure. Zobacz Instalowanie programu Azure PowerShell, aby rozpocząć. Aby dowiedzieć się, jak przeprowadzić migrację do modułu Az PowerShell, zobacz Migracja programu Azure PowerShell z modułu AzureRM do modułu Az.

Wymagania wstępne

Przed rozpoczęciem tego samouczka:

Zaloguj się na platformie Azure

Zaloguj się do swojego konta Azure i wybierz subskrypcję przed wykonaniem poleceń Azure.

Connect-AzAccount
Get-AzSubscription
Set-AzContext -SubscriptionId <guid>

Pobieranie wersji środowiska uruchomieniowego

Po nawiązaniu połączenia z platformą Azure wybierz subskrypcję zawierającą klaster usługi Service Fabric, możesz pobrać wersję środowiska uruchomieniowego klastra.

Get-AzServiceFabricCluster -ResourceGroupName SFCLUSTERTUTORIALGROUP -Name aztestcluster `
    | Select-Object ClusterCodeVersion

Możesz też pobrać listę wszystkich klastrów w ramach subskrypcji przy użyciu następującego przykładu:

Get-AzServiceFabricCluster | Select-Object Name, ClusterCodeVersion

Zanotuj wartość ClusterCodeVersion . Ta wartość będzie używana w następnej sekcji.

Uaktualnianie środowiska uruchomieniowego

Użyj wartości ClusterCodeVersion z poprzedniej sekcji z cmdlet Get-ServiceFabricRuntimeUpgradeVersion, aby dowiedzieć się, jakie wersje są dostępne do uaktualnienia. Polecenie cmdlet można uruchomić tylko na komputerze podłączonym do Internetu. Jeśli na przykład chcesz zobaczyć, jakie wersje środowiska uruchomieniowego można uaktualnić z wersji 5.7.198.9494, użyj następującego polecenia:

Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion "5.7.198.9494"

Za pomocą listy wersji możesz poinformować klaster usługi Azure Service Fabric o uaktualnieniu do nowszego środowiska uruchomieniowego. Jeśli na przykład wersja 6.0.219.9494 jest dostępna do uaktualnienia, użyj następującego polecenia, aby uaktualnić klaster.

Set-AzServiceFabricUpgradeType -ResourceGroupName SFCLUSTERTUTORIALGROUP `
                                    -Name aztestcluster `
                                    -UpgradeMode Manual `
                                    -Version "6.0.219.9494"

Ważne

Uaktualnienie środowiska uruchomieniowego klastra może zająć dużo czasu. Program PowerShell jest zablokowany podczas uaktualniania. Możesz użyć innej sesji programu PowerShell, aby sprawdzić stan uaktualnienia.

Stan uaktualnienia można monitorować za pomocą programu PowerShell lub interfejsu wiersza polecenia usługi Azure Service Fabric (sfctl).

Najpierw połącz się z klastrem przy użyciu certyfikatu TLS/SSL utworzonego w pierwszej części samouczka. Użyj polecenia Connect-ServiceFabricCluster cmdlet lub sfctl cluster upgrade-status.

$endpoint = "<mycluster>.southcentralus.cloudapp.azure.com:19000"
$thumbprint = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"

Connect-ServiceFabricCluster -ConnectionEndpoint $endpoint `
                             -KeepAliveIntervalInSec 10 `
                             -X509Credential -ServerCertThumbprint $thumbprint `
                             -FindType FindByThumbprint -FindValue $thumbprint `
                             -StoreLocation CurrentUser -StoreName My
sfctl cluster select --endpoint https://aztestcluster.southcentralus.cloudapp.azure.com:19080 \
--pem ./aztestcluster201709151446.pem --no-verify

Następnie użyj polecenia Get-ServiceFabricClusterUpgrade lub sfctl cluster upgrade-status , aby wyświetlić stan. Zostanie wyświetlony wynik podobny do poniższego.

Get-ServiceFabricClusterUpgrade

TargetCodeVersion                          : 6.0.219.9494
TargetConfigVersion                        : 3
StartTimestampUtc                          : 11/28/2017 3:09:48 AM
UpgradeState                               : RollingForwardPending
UpgradeDuration                            : 00:09:00
CurrentUpgradeDomainDuration               : 00:09:00
NextUpgradeDomain                          : 1
UpgradeDomainsStatus                       : { "0" = "Completed";
                                             "1" = "Pending";
                                             "2" = "Pending";
                                             "3" = "Pending";
                                             "4" = "Pending" }
UpgradeKind                                : Rolling
RollingUpgradeMode                         : Monitored
FailureAction                              : Rollback
ForceRestart                               : False
UpgradeReplicaSetCheckTimeout              : 37201.09:59:01
HealthCheckWaitDuration                    : 00:05:00
HealthCheckStableDuration                  : 00:05:00
HealthCheckRetryTimeout                    : 00:45:00
UpgradeDomainTimeout                       : 02:00:00
UpgradeTimeout                             : 12:00:00
ConsiderWarningAsError                     : False
MaxPercentUnhealthyApplications            : 0
MaxPercentUnhealthyNodes                   : 100
ApplicationTypeHealthPolicyMap             : {}
EnableDeltaHealthEvaluation                : True
MaxPercentDeltaUnhealthyNodes              : 0
MaxPercentUpgradeDomainDeltaUnhealthyNodes : 0
ApplicationHealthPolicyMap                 : {}
sfctl cluster upgrade-status

{
  "codeVersion": "6.0.219.9494",
  "configVersion": "3",

... item cut to save space ...

  },
  "upgradeDomains": [
    {
      "name": "0",
      "state": "Completed"
    },
    {
      "name": "1",
      "state": "Pending"
    },
    {
      "name": "2",
      "state": "Pending"
    },
    {
      "name": "3",
      "state": "Pending"
    },
    {
      "name": "4",
      "state": "Pending"
    }
  ],
  "upgradeDurationInMilliseconds": "PT1H2M4.63889S",
  "upgradeState": "RollingForwardPending"
}

Następne kroki

W tym samouczku nauczyłeś się następujących rzeczy:

  • Pobieranie wersji środowiska uruchomieniowego klastra
  • Uaktualnianie środowiska uruchomieniowego klastra
  • Monitorowanie uaktualnienia

Przejdź do następnego samouczka: