Share via

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

  • Artykuł

Ten samouczek jest częścią czterech 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

Na potrzeby tej części samouczka wymagany jest program PowerShell. Uaktualnianie środowiska uruchomieniowego klastra nie jest jeszcze obsługiwane przez narzędzia interfejsu wiersza polecenia platformy Azure. Alternatywnie klaster możesz 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 korzystając z tego artykułu, możesz zainstalować dowolne obsługiwane środowisko uruchomieniowe w klastrze usługi Azure Service Fabric.

Ten samouczek zawiera informacje na temat wykonywania następujących czynności:

  • Odczytywanie wersji 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:

Logowanie do platformy Azure

Przed wykonaniem poleceń platformy Azure zaloguj się na konto platformy Azure i wybierz subskrypcję.

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

Uzyskiwanie 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 z następującym przykładem:

Get-AzServiceFabricCluster | Select-Object Name, ClusterCodeVersion

Zanotuj wartość ClusterCodeVersion. Będzie ona używana w następnej sekcji.

Uaktualnianie środowiska uruchomieniowego

Podaj wartość ClusterCodeVersion z poprzedniej sekcji w poleceniu cmdlet Get-ServiceFabricRuntimeUpgradeVersion, aby dowiedzieć się, do jakich wersji możesz uaktualnić. To polecenie cmdlet możesz uruchomić tylko na komputerze, który został połączony z Internetem. Jeśli na przykład chcesz zobaczyć wersje środowiska uruchomieniowego, do których można uaktualnić wersję 5.7.198.9494, użyj następującego polecenia:

Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion "5.7.198.9494"

Dysponując listą wersji, możesz wydać klastrowi usługi Azure Service Fabric polecenie uaktualnienia do nowszej wersji środowiska uruchomieniowego. Jeśli na przykład na potrzeby uaktualnienia jest dostępna wersja 6.0.219.9494, użyj następującego polecenia w celu uaktualnienia klastra.

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. Stan uaktualnienia możesz sprawdzić za pomocą innej sesji programu PowerShell.

Stan uaktualnienia możesz monitorować przy użyciu 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 cmdlet Connect-ServiceFabricCluster lub polecenia sfctl cluster upgrade-status.

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

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 następującego.

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 niniejszym samouczku zawarto informacje na temat wykonywania następujących czynności:

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

Przejdź do następnego samouczka:

Usuwanie klastra