将现有可执行文件部署到 Service Fabric

可以在 Azure Service Fabric 中运行任何类型的代码(如 Node.js、Java 或 C++)作为服务。 Service Fabric 将这些类型的服务称为来宾可执行文件。

来宾可执行文件由 Service Fabric 如同无状态服务一样进行处理。 因此,它们会基于可用性和其他指标放在群集中的节点上。 本文介绍了如何使用 Visual Studio 或命令行实用工具打包来宾可执行文件,并将其部署到 Service Fabric 群集中。

注意

根据设计,Service Fabric 群集是单租户,托管应用程序被视为受信任。 如果你正在考虑托管不受信任的应用程序,请参阅在 Service Fabric 群集中托管不受信任的应用程序

在 Service Fabric 中运行来宾可执行文件的好处

在 Service Fabric 群集中运行来宾可执行文件有诸多优势:

  • 高可用性。 在 Service Fabric 中运行的应用程序都是高度可用的。 Service Fabric 会确保应用程序的实例正在运行。
  • 运行状况监视。 Service Fabric 运行状况监视功能可检测应用程序是否正在运行,并在出现故障时提供诊断信息。
  • 应用程序生命周期管理。 除了提供无需停机的升级,Service Fabric 还可以在升级过程中报告坏健康事件时自动回滚到先前的版本。
  • 密度。 可以在群集中运行多个应用程序,这样便无需使每个应用程序在自己的硬件上运行。
  • 可发现性:使用 REST,可以调用要在群集中查找其他服务的 Service Fabric 命名服务。

示例

应用程序和服务清单文件概述

在部署来宾可执行文件期间,最好先了解 Service Fabric 打包和部署模型(如应用程序模型中所述)。 Service Fabric 打包模型依赖两个 XML 文件:应用程序清单和服务清单。 ApplicationManifest.xml 和 ServiceManifest.xml 文件的架构定义随 Service Fabric SDK 一起安装到 C:\Program Files\Microsoft SDKs\Service Fabric\schemas\ServiceFabricServiceModel.xsd

  • 应用程序清单:应用程序清单用于描述应用程序。 其中会列出应用程序所包含的服务,以及用于定义应如何部署一个或多个服务的其他参数(如实例数)。

    在 Service Fabric 中,应用程序就是一个部署和升级单元。 应用程序可以作为单一单元进行升级,从中可以管控潜在失败和可能的回滚。 Service Fabric 可保证要么升级成功,要么即使升级失败,也不会让应用程序处于未知或不稳定状态。

  • 服务清单:服务清单描述服务的组件。 其中包括数据(如服务的名称和类型)及其代码和配置。 服务清单还包含一些可以用于在部署之后配置服务的其他参数。

应用程序包文件结构

应用程序应遵循预定义的目录结构,才能将应用程序部署到 Service Fabric。 下面的示例展示了此结构。

|-- ApplicationPackageRoot
    |-- GuestService1Pkg
        |-- Code
            |-- existingapp.exe
        |-- Config
            |-- Settings.xml
        |-- Data
        |-- ServiceManifest.xml
    |-- ApplicationManifest.xml

ApplicationPackageRoot 包含定义应用程序的 ApplicationManifest.xml 文件。 应用程序中包含的每个服务的子目录用于包含相应服务需要的所有项目。 这些子目录为 ServiceManifest.xml 以及如下目录(一般情况下):

  • Code。 此目录包含服务代码。
  • Config。此目录包含一个 Settings.xml 文件(必要时,还包含其他文件),服务可以在运行时访问该文件以检索特定的配置设置。
  • 数据。 这是用于存储服务可能需要的其他本地数据的其他目录。 Data 只应用来存储暂存数据。 如果服务需要进行重定位(例如,在故障转移期间),Service Fabric 不会复制数据目录所发生的变化。

注意

如果不需要,就无需创建 configdata 目录。

后续步骤

有关相关信息和任务,请参阅以下文章。