在 Windows 上準備您的開發環境

若要在您的 Windows 開發機器上建置並執行 Azure Service Fabric 應用程式,請安裝 Service Fabric 執行階段、SDK 和工具。 您也必須執行 SDK 中包含的 Windows PowerShell 指令碼

必要條件

請確定您使用的是支援的 Windows 版本

下載並安裝運行時間和 SDK

注意

先前用於 SDK/工具安裝的 WebPI 已於 2022 年 7 月 1 日淘汰

運行時間可以獨立安裝。 不過,SDK 需要運行時間,因此針對開發環境,您必須同時安裝運行時間和 SDK。 下列連結會下載運行時間和 SDK 的最新版本:

套件 版本
安裝適用於 Windows 的 Service Fabric 執行階段 10.1.1951.9590
安裝 Service Fabric SDK 7.1.1951

您可以在 Service Fabric 版本上 找到安裝程式的直接連結。

如需支援的版本,請參閱 Service Fabric 版本。

安裝執行階段

運行時間安裝程序必須從命令行殼層執行,而且您必須使用 /accepteula 旗標。 建議您使用提升的許可權來執行命令行殼層,以保留記錄列印輸出。 下列範例位於 PowerShell 中:

.\MicrosoftServiceFabric.<version>.exe /accepteula

安裝 SDK

安裝運行時間之後,您可以成功安裝 SDK。 您可以從命令行殼層或檔案總管執行安裝程式。

注意

單一機器叢集 (OneBox) 並不支援進行應用程式或叢集升級;如果您需要執行叢集升級,或是在執行應用程式升級時遇到任何問題,請刪除 OneBox 叢集並重新建立它。

若要使用 Visual Studio 2017 或 2019

Service Fabric 工具屬於 Visual Studio 2019 和 2017 中的 Azure 開發工作負載。 啟用此工作負載作為 Visual Studio 安裝的一部分。 此外,您必須安裝 Microsoft Azure Service Fabric SDK 和運行時間,如上述 下載並安裝運行時間和 SDK 所述。

啟用 PowerShell 指令碼執行

Service Fabric 會使用 Windows PowerShell 指令碼,以便建立本機開發叢集,以及從 Visual Studio 部署應用程式。 根據預設,Windows 會封鎖這些指令碼的執行。 若要啟用其,您必須修改 PowerShell 執行原則。 以系統管理員身分開啟 PowerShell 並輸入下列命令:

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser

安裝 Docker (選擇性)

Service Fabric 是容器協調者,可用於將微服務部署至整個機器叢集。 若要在本機開發叢集上執行 Windows 容器應用程式,您必須先安裝 Docker for Windows。 取得 Docker CE for Windows (穩定)。 安裝並啟動 Docker 之後,以滑鼠右鍵按兩下匣圖示,然後選取 [ 切換至 Windows 容器]。 這是執行以 Windows 為基礎的 Docker 映像時的必要步驟。

下一步

現在您已完成設定開發環境,請開始建置和執行應用程式。