教學課程：在 Azure 中升級 Service Fabric 叢集的執行階段

本教學課程是一系列教學課程中的第四部分，會顯示如何升級 Azure Service Fabric 叢集上的 Service Fabric 執行階段。 這部分的教學課程是針對在 Azure 上執行的 Service Fabric 叢集所撰寫，並不適用於獨立的 Service Fabric 叢集。

警告

這個部分的教學課程需要 PowerShell。 Azure CLI 工具尚不支援叢集執行階段的升級。 或者，您也可以在入口網站中升級叢集。 如需詳細資訊，請參閱升級 Azure Service Fabric 叢集。

若您的叢集所執行的已是最新版 Service Fabric 執行階段，則不需要進行此步驟。 不過，本文可以用來在 Azure Service Fabric 叢集上安裝任何支援的執行階段。

在本教學課程中，您會了解如何：

• 讀取叢集版本
• 設定叢集版本

在本教學課程系列中，您將了解如何：

• 在 Azure 上使用範本建立安全的 Windows 叢集
• 監視叢集
• 將叢集相應縮小或相應放大
• 升級叢集的執行階段
• 刪除叢集

注意

建議您使用 Azure Az PowerShell 模組來與 Azure 互動。 若要開始使用，請參閱安裝 Azure PowerShell (部分機器翻譯)。 若要了解如何移轉至 Az PowerShell 模組，請參閱將 Azure PowerShell 從 AzureRM 移轉至 Az。

必要條件

開始進行本教學課程之前：

• 如果您沒有 Azure 訂用帳戶，請建立免費帳戶
• 安裝 Azure PowerShell 或 Azure CLI。
• 在 Azure 上建立安全的 Windows 叢集
• 設定 Windows 開發環境。 安裝 Visual Studio 2019 和 Azure 開發、ASP.NET 和 Web 開發以及 .NET Core 跨平台開發工作負載。 然後設定 .NET 開發環境。

登入 Azure

請先登入您的 Azure 帳戶並選取您的訂用帳戶，再執行 Azure 命令。

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

取得執行階段版本

連線到 Azure 之後，請選取包含 Service Fabric 叢集的訂用帳戶，就可以取得叢集的執行階段版本。

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

或者，您也可以使用下列範例，直接取得訂用帳戶中所有叢集的清單：

Get-AzServiceFabricCluster | Select-Object Name, ClusterCodeVersion

請注意 ClusterCodeVersion 值。 下一節將使用此值。

升級執行階段

以 Get-ServiceFabricRuntimeUpgradeVersion Cmdlet 使用來自上一節的 ClusterCodeVersion 值，探索可以升級到哪些版本。 此 Cmdlet 只能在可連線到網際網路的電腦上執行。 例如，若您想要查看可以從 5.7.198.9494 版升級到哪些執行階段版本，請使用下列命令：

Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion "5.7.198.9494"

有了版本的清單，就可以令 Azure Service Fabric 叢集升級到較新的執行階段。 例如，若可升級為 6.0.219.9494 版，請使用下列命令以升級您的叢集。

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

重要

叢集執行階段升級可能需要很長的時間才能完成。 正在執行升級時，PowerShell 會遭到封鎖。 您可以使用另一個 PowerShell 工作階段來檢查升級狀態。

可以使用 PowerShell 或 Azure Service Fabric CLI (sfctl) 來監視升級狀態。

首先請以本教學課程第一個部分中所建立的 TLS/SSL 憑證連線到叢集。 請使用 Connect-ServiceFabricCluster Cmdlet 或 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

接下來，使用 Get-ServiceFabricClusterUpgrade 或 sfctl cluster upgrade-status 來顯示狀態。 應該會顯示類似下面的結果。

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

下一步

在本教學課程中，您已了解如何：

• 取得叢集執行階段版本
• 升級叢集執行階段
• 對升級進行監視

前進到下一個教學課程：

刪除叢集