先决条件
开始之前,请安装 Service Fabric SDK、Azure CLI,并在 Linux 开发环境中设置开发群集。 如果使用 Mac OS X,则可使用 Vagrant 在虚拟机中设置 Linux 开发环境。
此外还需配置 Azure CLI 2.0(推荐)或 XPlat CLI,以便部署应用程序。
创建应用程序
Service Fabric 应用程序包含一个或多个服务,每个服务都在提供应用程序功能时具有特定角色。 适用于 Linux 的 Service Fabric SDK 包含 Yeoman 生成器,使用它可以轻松创建第一个服务并在以后添加更多服务。 此外,还可使用适用于 Eclipse 的插件创建、生成和部署 Service Fabric Java 应用程序。 请参阅使用 Eclipse 创建和部署第一个 Java 应用程序。 对于本快速入门,使用 Yeoman 创建具有单项服务的应用程序,该服务用于存储和获取获取计数器值。
- 在终端中,键入
yo azuresfjava
。 - 为应用程序命名。
- 选择第一个服务的类型并为其命名。 对于本教程,请选择“Reliable Actor 服务”。 有关其他服务类型的详细信息,请参阅 Service Fabric 编程模型概述。
构建应用程序
Service Fabric Yeoman 模板包含 Gradle 的生成脚本,可用于从终端生成应用程序。 若要生成并打包应用程序,请运行以下命令:
cd myapp
gradle
部署应用程序
生成应用程序后,可以将其部署到本地群集。
使用 XPlat CLI
-
连接到本地 Service Fabric 群集。
bash复制azure servicefabric cluster connect
-
运行模板中提供的安装脚本可将应用程序包复制到群集的映像存储区、注册应用程序类型和创建应用程序实例。
bash复制./install.sh
使用 Azure CLI 2.0
部署生成的应用程序时,其方式与部署任何其他 Service Fabric 应用程序相同。 如需详细的说明,请参阅相关文档,了解如何使用 Azure CLI 管理 Service Fabric 应用程序。
这些命令的参数可以在应用程序包内的生成清单中找到。
应用程序部署完以后,请打开浏览器并导航到 Service Fabric Explorer,其地址为 http://localhost:19080/Explorer。 然后,展开“应用程序”节点,注意现在有一个条目是用于应用程序类型,另一个条目用于该类型的第一个实例。
启动测试客户端并执行故障转移
执行组件本身不执行任何操作,它们需要其他服务或客户端向其发送消息。 执行组件模板包含简单的测试脚本,可用于与执行组件服务交互。
-
使用监视实用工具运行脚本,查看执行组件服务的输出。 测试脚本对角色调用
setCountAsync()
方法来递增计数器,对角色调用getCountAsync()
方法来获取新的计数器值,并向控制台显示该值。bash复制cd myactorsvcTestClient
watch -n 1 ./testclient.sh -
在 Service Fabric Explorer 中,找到托管角色服务的主要副本的节点。 在以下屏幕截图中,该节点是节点 3。 主要服务副本处理读写操作。 然后将服务状态更改向外复制到次要副本,该副本在下方屏幕截图的节点 0 和 1 上运行。
在“节点”中,单击上一步找到的节点,然后从“操作”菜单中选择“停用(重启)”。 此操作重启运行主要服务副本的节点,并强制故障转移到在其他节点上运行的其中一个次要副本。 该次要副本将提升为主要副本,并在其他节点上创建另一次要副本,然后主要副本开始执行读/写操作。 节点重启时,请注意来自测试客户端的输出,并注意虽然发生故障转移,但计数器仍继续递增。
删除应用程序
使用模板中提供的卸载脚本可从群集的映像存储区删除应用程序实例、注销应用程序包并删除应用程序包。
./uninstall.sh
在 Service Fabric Explorer 中,可看到应用程序和应用程序类型不再显示在“应用程序”节点中。