使用 PowerShell 進行 Service Fabric 應用程式升級

發行項
06/01/2023

最常使用和建議的升級方法是監視輪流升級。 Azure Service Fabric 會根據健康狀態原則集，監視正在升級之應用程式的健康狀態。當更新網域 (UD) 中的應用程式升級之後，Service Fabric 會評估應用程式健康狀態，並根據健康狀態原則繼續進行下一個更新網域或讓升級失敗。

可以使用受控或原生 API、PowerShell、Azure CLI、Java 或 REST，執行監視應用程式升級。如需有關使用 Visual Studio 來執行升級的說明，請參閱使用 Visual Studio 升級您的應用程式。

透過 Service Fabric 監視輪流升級，應用程式系統管理員即可設定 Service Fabric 用來判斷應用程式健康狀態良好的健康狀態評估原則。此外，系統管理員也可設定當健康狀態評估失敗時採取的動作 (例如，進行自動回復)。本節會逐步解說使用 PowerShell 對其中一個 SDK 範例進行受監視的升級。

請查看此頁面以取得訓練影片，並引導您完成應用程式升級：

注意

ApplicationParameter 不會在應用程式升級期間保留。為了保留目前的應用程式參數，使用者應先取得參數，並將其傳遞至升級 API 呼叫，如下所示：

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters

$applicationParameterMap = @{}
foreach ($pair in $appParamCollection)
{
    $applicationParameterMap.Add($pair.Name, $pair.Value);
}

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

步驟 1：建置和部署視覺物件範例

在應用程式專案 VisualObjectsApplication 上按一下滑鼠右鍵，然後選取 [發佈] 命令來建置和發佈應用程式。如需詳細資訊，請參閱 Service Fabric 應用程式升級教學課程。或者，您可以使用 PowerShell 來部署您的應用程式。

注意

在 PowerShell 中使用任何 Service Fabric 命令之前，您必須先使用 Connect-ServiceFabricCluster Cmdlet 連接到叢集。同樣地，它會假設已經在本機電腦上設定叢集。請參閱設定 Service Fabric 開發環境上的文章

在 Visual Studio 中建置專案後，您可以使用 PowerShell 命令 Copy-ServiceFabricApplicationPackage 將應用程式封裝複製到 ImageStore。如果您想要在本機確認應用程式套件，使用 Test-ServiceFabricApplicationPackage cmdlet。下一個步驟是使用 Register-ServiceFabricApplicationType Cmdlet 將應用程式註冊至 Service Fabric 執行階段。下一個步驟是使用 New-ServiceFabricApplication Cmdlet 啟動應用程式的執行個體。這三個步驟類似於在 Visual Studio 中使用 [部署] 功能表項目。一旦佈建完成，您應該清除從映像存放區複製的應用程式套件，以減少耗用的資源。如果不再需要應用程式類型，應該基於相同原因將其取消註冊。如需詳細資訊，請參閱使用 PowerShell 部署與移除應用程式。

現在，您可以使用 Service Fabric Explorer 來檢視叢集與應用程式。該應用程式有一個 Web 服務，在 Internet Explorer 的網址列中輸入 http://localhost:8081/visualobjects，即可瀏覽至該服務。您應該會在畫面上看到一些浮動視覺物件四處移動。此外，您可以使用 Get-ServiceFabricApplication 檢查應用程式狀態。

步驟 2：更新視覺物件範例

您可能會注意到在步驟 1 中已部署的版本，視覺物件不會旋轉。讓我們將這個應用程式升級到其中的視覺物件也會旋轉的版本。

選取 VisualObjects 解決方案內的 VisualObjects.ActorService 專案，然後開啟 StatefulVisualObjectActor.cs 檔案。在該檔案內，瀏覽至 MoveObject 方法，然後將 this.State.Move() 標記為註解，然後將 this.State.Move(true) 取消註解。這項變更會在服務升級後旋轉物件。

我們也需要更新 VisualObjects.ActorService 專案的 ServiceManifest.xml檔案 (在 [PackageRoot] 底下)。請將 ServiceManifest.xml 檔案中的 CodePackage 和服務版本及對應的行更新成 2.0。您可以在對解決方案按一下滑鼠右鍵之後，使用 Visual Studio [編輯資訊清單檔案] 選項來進行資訊清單檔案變更。

進行變更之後，資訊清單應該會看起來如下 (醒目提示的部分即為所做的變更)：

<ServiceManifestName="VisualObjects.ActorService" Version="2.0" xmlns="http://schemas.microsoft.com/2011/01/fabric" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">

<CodePackageName="Code" Version="2.0">

現在，ApplicationManifest.xml 檔案 (可以在 VisualObjects 方案下的 VisualObjects 專案下找到)，會更新為 2.0 版的 VisualObjects.ActorService 專案。此外，應用程式版本也會從 1.0.0.0 更新為 2.0.0.0。 ApplicationManifest.xml 看起來應該類似下列程式碼片段︰

<ApplicationManifestxmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" ApplicationTypeName="VisualObjects" ApplicationTypeVersion="2.0.0.0" xmlns="http://schemas.microsoft.com/2011/01/fabric">

 <ServiceManifestRefServiceManifestName="VisualObjects.ActorService" ServiceManifestVersion="2.0" />

現在只選取 [ActorService] 專案，然後以滑鼠右鍵按一下並選取 Visual Studio 中的 [組建] 選項建置專案。如果您選取 [全部重建]，因為程式碼已變更，所以您要更新所有專案的版本。接下來，在 VisualObjectsApplication 上按一下滑鼠右鍵，選取 Service Fabric 功能表，然後選擇 [封裝]，來封裝已更新的應用程式。這個動作會建立可部署的應用程式封裝。更新的應用程式已準備好進行部署。

步驟 3：決定健康狀態原則並升級參數

請您熟悉應用程式升級參數和升級程序，以了解套用的各種升級參數、逾時和健康狀態準則。對於此逐步解說，服務健康狀態評估準則會設定為預設值 (和建議值)，這表示升級之後，所有服務和執行個體應該是「健康狀態良好」。

但是，讓我們將 HealthCheckStableDuration 增加為 180 秒 (如此一來，在升級繼續至下一個更新網域之前，至少有 120 秒的時間服務是健康狀態良好的)。同時也要將 UpgradeDomainTimeout 設為 1200 秒，將 UpgradeTimeout 設為 3000 秒。

最後，我們也將 UpgradeFailureAction 設定為回復。此選項要求 Service Fabric 在升級期間如果遇到任何問題時要將應用程式回復為舊版。因此在啟動升級 (在步驟 4) 時，會指定下列參數︰

FailureAction = Rollback

HealthCheckStableDurationSec = 180

UpgradeDomainTimeoutSec = 1200

UpgradeTimeout = 3000

步驟 4：準備應用程式以進行升級

現在，應用程式已建置並且準備好進行升級。如果您以系統管理員身分開啟 PowerShell 視窗並且輸入 Get-ServiceFabricApplication，它應該會讓您知道它是已部署之 VisualObjects 的應用程式類型 1.0.0.0。

應用程式套件儲存在您先前解壓縮 Service Fabric SDK 的下列相對路徑下：Samples\Services\Stateful\VisualObjects\VisualObjects\obj\x64\Debug。您應該會在該目錄中找到 "Package" 資料夾，這是應用程式封裝儲存的位置。檢查時間戳記以確保它是最新組建 (您也可能需要適當地修改路徑)。

現在讓我們將更新的應用程式封裝複製到 Service Fabric ImageStore (Service Fabric 在其中儲存應用程式封裝)。參數 ApplicationPackagePathInImageStore 會通知 Service Fabric 可以在哪裡找到應用程式封裝。使用下列命令將更新的應用程式放在 "VisualObjects_V2" (您可能需要再次適當地修改路徑)。

Copy-ServiceFabricApplicationPackage -ApplicationPackagePath .\Samples\Services\Stateful\VisualObjects\VisualObjects\obj\x64\Debug\Package -ApplicationPackagePathInImageStore "VisualObjects\_V2"

下一步是向 Service Fabric 註冊此應用程式，這可以使用 Register-ServiceFabricApplicationType 命令來執行：

Register-ServiceFabricApplicationType -ApplicationPathInImageStore "VisualObjects\_V2"

如果上述命令不成功，很可能是您需要重建所有服務。如步驟 2 中所述，您可能也必須更新您的 WebService 版本。

建議您在成功註冊應用程式之後，移除應用程式套件。從映像存放區刪除應用程式套件會釋放系統資源。保留未使用的應用程式套件會耗用磁碟儲存空間，並會導致應用程式效能問題。

Remove-ServiceFabricApplicationPackage -ApplicationPackagePathInImageStore "VisualObjects\_V2" -ImageStoreConnectionString fabric:ImageStore

步驟 5：開始應用程式升級

現在，您已準備好使用 Start-ServiceFabricApplicationUpgrade命令來啟動應用程式升級：

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/VisualObjects -ApplicationTypeVersion 2.0.0.0 -HealthCheckStableDurationSec 60 -UpgradeDomainTimeoutSec 1200 -UpgradeTimeout 3000   -FailureAction Rollback -Monitored

應用程式名稱如 ApplicationManifest.xml 檔案中所述。 Service Fabric 會使用這個名稱來識別要升級哪一個應用程式。如果您設定的逾時太短，您可能會遇到失敗訊息，指出此問題。請參閱疑難排解章節，或增加逾時。

現在，當應用程式升級進行時，您可以使用 Service Fabric Explorer 或 Get-ServiceFabricApplicationUpgrade PowerShell 命令監視進度。

Get-ServiceFabricApplicationUpgrade fabric:/VisualObjects

幾分鐘後，使用上述 PowerShell 命令所取得的狀態應該會顯示所有更新網域已升級 (完成)。而且，您應該會在瀏覽器視窗中發現該視覺物件已經開始旋轉！

您可以嘗試從第 2 版升級到第 3 版，或練習從第 2 版升級為第 1 版。從第 2 版移至第 1 版也視為一種升級。練習逾時和健康狀態原則，讓自己更熟練。當您部署至 Azure 叢集時，參數必須正確設定。最好保守地設定逾時。

下一步

使用 Visual Studio 升級您的應用程式將引導您完成使用 Visual Studio 進行應用程式升級的步驟。

使用升級參數來控制您應用程式的升級方式。

了解如何使用資料序列化，以讓您的應用程式升級相容。

參考進階主題，以了解如何在升級您的應用程式時使用進階功能。

參考疑難排解應用程式升級中的步驟，以修正應用程式升級中常見的問題。