Service Fabric for Visual Studio Code

适用于 VS Code 的 Service Fabric Reliable Services 扩展提供所需的工具用于在 Windows、Linux 和 macOS 操作系统上创建、生成和调试 Service Fabric 应用程序。

本文概述该扩展的要求和设置,以及该扩展提供的各个命令的用法。

重要

可在 Windows 计算机上开发 Service Fabric Java 应用程序,但只能将其部署到 Azure Linux 群集。 Windows 不支持调试 Java 应用程序。

必备条件

必须在所有环境中安装以下必备组件。

  • Visual Studio Code

  • Node.js

  • Git

  • Service Fabric SDK

  • Yeoman 生成器 -- 为应用程序安装相应的生成器

    npm install -g yo
    npm install -g generator-azuresfjava
    npm install -g generator-azuresfcsharp
    npm install -g generator-azuresfcontainer
    npm install -g generator-azuresfguest
    

必须为 Java 开发安装以下必备组件:

  • Java SDK(版本 1.8)
  • Gradle
  • 调试 Java 服务时所需的适用于 Java VS Code 的调试程序扩展。 仅支持在 Linux 上调试 Java 服务。 可通过以下方法之一安装该扩展:在 VS Code 中的活动栏上单击“扩展”图标并搜索该扩展,或者从 VS Code 市场安装。

必须为 .NET Core/C# 开发安装以下必备组件:

设置

  1. 打开 VS Code。
  2. 在 VS Code 左侧的活动栏中单击“扩展”图标。 搜索“Service Fabric”。 单击 Service Fabric Reliable Services 扩展对应的“安装”。

命令

适用于 VS Code 的 Service Fabric Reliable Services 扩展提供许多命令用于帮助开发人员创建和部署 Service Fabric 项目。 可以从命令面板调用命令:按 (Ctrl + Shift + p),在输入栏中键入命令名称,然后从提示列表中选择所需的命令即可。

  • Service Fabric: 创建应用程序
  • Service Fabric: 发布应用程序
  • Service Fabric: 部署应用程序
  • Service Fabric: 删除应用程序
  • Service Fabric: 生成应用程序
  • Service Fabric: 清理应用程序

Service Fabric: 创建应用程序

“Service Fabric: 创建应用程序”命令在当前工作区中创建新的 Service Fabric 应用程序。 根据开发计算机上安装的 yeoman 生成器,可以创建多种类型的 Service Fabric 应用程序,包括 Java、C#、容器和来宾项目。

  1. 选择“Service Fabric: 创建应用程序”命令
  2. 选择新 Service Fabric 应用程序的类型。
  3. 输入要创建的应用程序的名称
  4. 选择要添加到 Service Fabric 应用程序的服务的类型。
  5. 遵照提示将服务命名。
  6. 新 Service Fabric 应用程序将显示在工作区中。
  7. 打开新应用程序所在的文件夹,使其成为工作区中的根文件夹。 可以继续在此处执行命令。

Service Fabric: 添加服务

“Service Fabric: 添加服务”命令将新服务添加到现有的 Service Fabric 应用程序。 要将服务添加到的应用程序必须是工作区的根目录。

  1. 选择“Service Fabric: 添加服务”命令。
  2. 选择当前 Service Fabric 应用程序的类型。
  3. 选择要添加到 Service Fabric 应用程序的服务的类型。
  4. 遵照提示将服务命名。
  5. 新服务将显示在项目目录中。

Service Fabric: 发布应用程序

“Service Fabric: 发布应用程序”命令在远程群集上部署 Service Fabric 应用程序。 目标群集可以是安全的群集,也可以是不安全的群集。 如果未在 Cloud.json 中设置参数,应用程序将部署到本地群集。

  1. 首次生成应用程序时,将在项目目录中生成 Cloud.json 文件。
  2. 在 Cloud.json 文件中,输入要连接到的群集的值。
  3. 选择“Service Fabric: 发布应用程序”命令。
  4. 使用 Service Fabric Explorer 查看目标群集,确认已安装该应用程序。

Service Fabric: 部署应用程序(Localhost)

“Service Fabric: 部署应用程序”命令将 Service Fabric 应用程序部署到本地群集。 使用该命令之前,请确保本地群集正在运行。

  1. 选择“Service Fabric: 部署应用程序”命令
  2. 使用 Service Fabric Explorer (http://localhost:19080/Explorer) 查看本地群集,确认已安装该应用程序。 此过程可能需要一段时间,请耐心等待。
  3. 也可以在未在 Cloud.json 文件中设置任何参数的情况下,使用“Service Fabric: 发布应用程序”命令部署到本地群集。

注意

Windows 计算机上不支持将 Java 应用程序部署到本地群集。

Service Fabric: 删除应用程序

“Service Fabric: 删除应用程序”命令将 Service Fabric 应用程序从先前使用 VS Code 扩展将它部署到的群集中删除它。

  1. 选择“Service Fabric: 删除应用程序”命令。
  2. 使用 Service Fabric Explorer 查看该群集,确认已删除该应用程序。 此过程可能需要一段时间,请耐心等待。

Service Fabric: 生成应用程序

“Service Fabric: 生成应用程序”命令可以生成 Java 或 C# Service Fabric 应用程序。

  1. 执行此命令之前,请确保在应用程序根文件夹中操作。 该命令会识别应用程序的类型(C# 或 Java),并相应地生成应用程序。
  2. 选择“Service Fabric: 生成应用程序”命令。
  3. 生成过程的输出将写入集成式终端。

Service Fabric: 清理应用程序

“Service Fabric: 清理应用程序”命令会删除生成过程生成的所有 jar 文件和本机库。 此命令仅对 Java 应用程序有效。

  1. 执行此命令之前,请确保在应用程序根文件夹中操作。
  2. 选择“Service Fabric: 清理应用程序”命令。
  3. 清理过程的输出将写入集成式终端。

后续步骤