若要在您的 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 映像時的必要步驟。
後續步驟
現在開發環境已完成設定,可以開始建置和執行應用程式。