在 Windows 上準備您的開發環境

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

先決條件

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

下載並安裝執行階段和 SDK

附註

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

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

Package 版本
安裝適用於 Windows 的 Service Fabric 執行階段 11.6.235.1
安裝 Service Fabric SDK 8.6.235

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

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

安裝執行階段

必須從命令列殼層執行該執行階段安裝程式,而且您必須使用 /accepteula 旗標。 建議您使用提升的權限執行命令列殼層,以保留記錄列印輸出。 下列範例是在 PowerShell 中:

.\MicrosoftServiceFabric.<version>.exe /accepteula

安裝 SDK

安裝執行階段之後,您就可以成功安裝 SDK。 您可以從命令列殼層或檔案總管執行安裝程式。

附註

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

若要使用 Visual Studio 2017、2019、2022 或 2026

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

若要特別使用 Visual Studio 2026,請在 Visual Studio Marketplace 下載 “Service Fabric Tools” 擴充功能:Service Fabric Tools Extension

啟用 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 映像時的必要步驟。

後續步驟

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