在 Windows 上准备开发环境

项目
08/26/2024

若要在 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.2338.9590
安装 Service Fabric SDK	7.1.2338

可以在 Service Fabric 版本上找到早期版本安装程序的直接链接。

有关支持的版本，请参阅 Service Fabric 版本。

安装运行时

运行时安装程序必须从命令行 shell 运行，并且必须使用/accepteula标志。建议使用提升的权限运行命令行 shell 以保留日志打印输出。以下示例在 PowerShell 中：

.\MicrosoftServiceFabric.<version>.exe /accepteula

安装 SDK

安装运行时后，可以成功安装 SDK。可以从命令行 shell 或文件资源管理器运行安装程序。

注意

应用程序或群集升级不支持单机群集 (OneBox)；如果需要执行群集升级，或在执行应用程序升级时遇到任何问题，请删除 OneBox 群集并重新创建它。

使用 Visual Studio 2017 或 2019

Service Fabric 工具是 Visual Studio 2019 和 2017 中 Azure 开发工作负荷的一部分。在 Visual Studio 安装过程中启用此工作负荷。此外，需要安装 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 容器应用程序，必须先安装用于 Windows 的 Docker。获取用于 Windows 的 Docker CE (稳定版)。安装并启动 Docker 以后，右击任务栏图标，并选择“切换到 Windows 容器”。此步骤是运行基于 Windows 的 Docker 映像所必需的。

后续步骤

完成设置开发环境之后，便可开始生成和运行应用。

通过