使用适用于 Eclipse 的 Service Fabric 插件开发 Java 应用程序

Eclipse 是面向 Java 开发人员的最常用集成开发环境 (IDE) 之一。 本文介绍如何设置适用于 Azure Service Fabric 的 Eclipse 开发环境。 了解如何安装 Service Fabric 插件、创建 Service Fabric 应用程序,以及将 Service Fabric 应用程序部署到 Eclipse 中的本地或远程 Service Fabric 群集。

Note

Windows 当前不支持 Eclipse 插件。

在 Eclipse 中安装或更新 Service Fabric 插件

可在 Eclipse 中安装 Service Fabric 插件。 该插件可帮助简化生成和部署 Java 服务的过程。

Important

Service Fabric 插件需要 Eclipse Neon 或更高版本。 请参阅此注意事项后面的说明,了解如何查看 Eclipse 的版本。 如果安装的是较旧版本的 Eclipse,可以从 Eclipse 站点下载较新的版本。 建议不要在现有 Eclipse 安装版本的基础上进行安装(覆盖)。 可以先删除现有版本,然后再运行安装程序,也可以在另一目录中安装较新的版本。

在 Ubuntu 上,建议直接从 Eclipse 站点进行安装,而不是使用包安装程序(aptapt-get)。 这样做可确保获取最新版 Eclipse。

Eclipse 站点安装 Eclipse Neon 或更高版本。 还安装 Buildship 2.2.1 版或更高版本(Service Fabric 插件与更旧版本的 Buildship 不兼容):

  • 若要检查已安装组件的版本,请在 Eclipse 中转到“帮助” > “关于 Eclipse” > “安装详细信息”。
  • 若要更新 Buildship,请参阅 Eclipse Buildship: Eclipse Plug-ins for Gradle(Eclipse Buildship:适用于 Gradle 的 Eclipse 插件)。
  • 若要检查并安装 Eclipse 的更新,请转到“帮助” > “检查更新”。

若要安装 Service Fabric 插件,请在 Eclipse 中转到“帮助” > “安装新软件”。

  1. 在“使用”框中,输入 http://dl.microsoft.com/eclipse
  2. 单击“添加” 。 适用于 Eclipse 的 Service Fabric 插件
  3. 选择 Service Fabric 插件,并单击“下一步”。
  4. 完成安装步骤,并接受 Microsoft 软件许可条款。

如果已安装 Service Fabric 插件,请安装最新版本。

  1. 若要检查可用的更新,请转到“帮助” > “关于 Eclipse” > “安装详细信息”。
  2. 在已安装插件的列表中选择“Service Fabric”,然后单击“更新”。 随后会安装可用的更新。
  3. 更新 Service Fabric 插件后,还需刷新 Gradle 项目。 右键单击 build.gradle,然后选择“刷新”。

Note

如果安装或更新 Service Fabric 插件时运行缓慢,原因可能是 Eclipse 设置有问题。 Eclipse 将收集有关所有更改的元数据,以更新已注册到 Eclipse 实例的站点。 若要加速 Service Fabric 插件更新的检查和安装过程,请转到“可用软件站点”。 清除所有站点对应的复选框,但指向 Service Fabric 插件位置 (http://dl.microsoft.com/eclipse/azure/servicefabric) 的站点除外。

Note

如果 Eclipse 在 Mac 上未按预期方式工作,或者需要你以超级用户身份运行,请转到 ECLIPSE_INSTALLATION_PATH 文件夹,然后导航到子文件夹 Eclipse.app/Contents/MacOS。 运行 ./eclipse 启动 Eclipse。

在 Eclipse 中创建 Service Fabric 应用程序

  1. 在 Eclipse 中,转到“文件” > “新建” > “其他”。 选择“Service Fabric 项目”,然后单击“下一步”。

    Service Fabric 新建项目第 1 页

  2. 输入项目的名称,然后单击“下一步”。

    Service Fabric 新建项目第 2 页

  3. 从模板列表中,选择“服务模板”。 选择服务模板类型(“执行组件”、“无状态”、“容器”或“来宾二进制”),然后单击“下一步”。

    Service Fabric 新建项目第 3 页

  4. 输入服务名称和服务详细信息,然后单击“完成”。

    Service Fabric 新建项目第 4 页

  5. 创建第一个 Service Fabric 项目时,请在“打开关联的透视图”对话框中单击“是”。

    Service Fabric 新建项目第 5 页

  6. 新项目如下所示:

    Service Fabric 新建项目第 6 页

在 Eclipse 中生成和部署 Service Fabric 应用程序

  1. 右键单击新建的 Service Fabric 应用程序,然后选择“Service Fabric”。

    Service Fabric 右键菜单

  2. 在子菜单中选择所需的选项:

    • 若要生成应用程序但不清理,请单击“生成应用程序”。
    • 若要生成已清理的应用程序,请单击“重新生成应用程序”。
    • 若要清理已生成项目的应用程序,请单击“清理应用程序”。
  3. 还可以通过此菜单部署、取消部署和发布应用程序:

    • 若要部署到本地群集,请单击“部署应用程序”。
    • 在“发布应用程序”对话框中选择发布配置文件:

      • Local.json
      • Cloud.json

      这些 JavaScript 对象表示法 (JSON) 文件存储连接到本地群集或云 (Azure) 群集所需的信息(例如连接终结点和安全信息)。

    Service Fabric 发布菜单

部署 Service Fabric 应用程序的另一种方式是使用 Eclipse 运行配置。

  1. 转到“运行” > “运行配置”。
  2. 在“Gradle 项目”下面,选择“ServiceFabricDeployer”运行配置。
  3. 在右窗格中的“参数”选项卡上,请为“publishProfile”选择“local”或“cloud”。 默认值为 local。 若要部署到远程群集或云群集,请选择“cloud”。
  4. 为了确保在发布配置文件中填充正确的信息,请根据需要编辑 Local.jsonCloud.json。 可以添加或更新终结点详细信息和安全凭据。
  5. 确保“工作目录”指向要部署的应用程序。 若要更改应用程序,请单击“工作区”按钮,然后选择所需的应用程序。
  6. 单击“应用”,然后单击“运行”。

应用程序会在片刻之后生成和部署。 可在 Service Fabric Explorer 中监视部署状态。

将 Service Fabric 服务添加到 Service Fabric 应用程序

要将 Service Fabric 服务添加到现有的 Service Fabric 应用程序,请执行以下步骤:

  1. 右键单击要将该服务添加到的项目,然后单击“Service Fabric”。

    Service Fabric 添加服务第 1 页

  2. 单击“添加 Service Fabric 服务”,完成将服务添加到项目的一系列步骤。

  3. 选择要添加到项目的服务模板,然后单击“下一步”。

    Service Fabric 添加服务第 2 页

  4. 输入服务名称(根据需要输入其他详细信息),然后单击“添加服务”按钮。

    Service Fabric 添加服务第 3 页

  5. 添加该服务后,整个项目结构类似于以下项目:

    Service Fabric 添加服务第 4 页

编辑 Service Fabric Java 应用程序的清单版本

若要编辑清单版本,请右键单击项目,转到“Service Fabric”,然后从下拉菜单中选择“编辑清单版本...”。 在向导中,可以更新应用程序清单和服务清单的清单版本,以及“代码”、“配置”和“数据”包的版本。

如果选中“自动更新应用程序和服务的版本”选项,然后更新了一个版本,则会自动更新清单版本。 举例来说,首先选中该复选框,然后将“代码”版本从 0.0.0 更新为 0.0.1,最后再单击“完成”,则服务清单版本和应用程序清单版本就会自动更新为 0.0.1。

升级 Service Fabric Java 应用程序

对于升级方案,假设使用 Service Fabric 插件在 Eclipse 中创建了 App1 项目。 已使用该插件部署了此项目,以创建名为 fabric:/App1Application 的应用程序。 该应用程序的类型为 App1AppicationType,应用程序版本为 1.0。 现在,要在不影响可用性的情况下升级该应用程序。

首先,请对应用程序进行任何更改,然后重新生成已修改的服务。 使用服务的更新版本(以及相关的代码、配置或数据)更新已修改服务的清单文件 (ServiceManifest.xml)。 同时,请使用更新的应用程序版本号和已修改的服务修改应用程序的清单 (ApplicationManifest.xml)。

若要使用 Eclipse 升级应用程序,可以创建重复的运行配置文件。 然后,根据需要使用该文件升级应用程序。

  1. 转到“运行” > “运行配置”。 在左窗格中,单击“Gradle 项目”左侧的小箭头。
  2. 右键单击“ServiceFabricDeployer”,然后选择“复制”。 输入此配置的新名称,例如 ServiceFabricUpgrader
  3. 在右侧面板中的“参数”选项卡上,将 -Pconfig='deploy' 更改为 -Pconfig='upgrade',然后单击“应用”。

此过程会创建并保存随时可用于升级应用程序的运行配置配置文件。 此过程还会从应用程序清单文件中获取最近更新的应用程序类型版本。

应用程序升级需要几分钟时间。 可在 Service Fabric Explorer 中监视应用程序升级状态。

迁移要与 Maven 配合使用的旧式 Service Fabric Java 应用程序

我们最近已将 Service Fabric Java 库从 Service Fabric Java SDK 移至 Maven 存储库。 虽然使用 Eclipse 生成的新应用程序会生成最近更新的项目(会兼容 Maven),但你可以对现有的 Service Fabric 无状态或执行组件 Java 应用程序(此前使用 Service Fabric Java SDK)进行更新,使之能够使用 Maven 提供的 Service Fabric Java 依赖项。 请按此处提及的步骤操作,确保旧版应用程序兼容 Maven。