你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

在 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 版本

安装运行时

运行时安装程序必须从命令行 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 安装过程中启用此工作负荷。 此外,需要安装 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 容器应用程序,必须先安装用于 Windows 的 Docker。 获取用于 Windows 的 Docker CE (稳定版)。 安装并启动 Docker 以后,右击任务栏图标,并选择“切换到 Windows 容器”。 此步骤是运行基于 Windows 的 Docker 映像所必需的。

后续步骤

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