文档

基于 Seata 的 Spring Cloud 应用样例

更新时间:
一键部署

使用 Seata 能够解决 Spring Cloud 微服务应用的分布式事务问题。本文通过一个样例工程介绍如何将基于 Seata 实现分布式事务的 Spring Cloud 应用运行在 GTS 上。

背景信息

GTS SDK 2.9.0 版本开始提供对 Seata 的兼容支持。

样例简介

该样例模拟了一个用户订购商品的业务系统,包含 3 个微服务:

  • Storage:库存服务,扣减指定商品的库存数量。
  • Order:订单服务,根据采购请求生成订单。
  • Account:账户服务,从用户账户中扣减金额。

订购商品的业务流程如下图所示:

样例场景-Spring Cloud
  1. Business 开启一个 GTS 管理的全局事务。
  2. Business 调用 Storage 和 Order。
  3. Order 调用 Account。

GTS 将保障整个服务调用链路上的数据一致性。

步骤一:下载样例工程

登录阿里云管理控制台,样例工程详情请参见基于Seata的Spring Cloud应用样例

步骤二:构建样例工程

  1. 创建一个用于运行样例的数据库,执行工程中的 init.sql 脚本,建立相关表。
  2. 构建工程。

    1. 构建工程依赖 Maven,准备一个可用的 Maven 环境。

    2. 在样例工程的根目录下,执行 mvn clean install 命令。

    SDK 包是由 common/lib 里的 download-maven-plugin 插件通过 wget 命令从 GTS 官网下载的。如果您的环境不能执行 wget 命令,上面的 Maven 构建会失败。这种情况下,请您按以下方式操作。

    1. 手工下载最新的 SDK开发包,并放在 common/lib 目录下。

    2. 在工程 pom.xml 文件的 modules 中将common 删掉。

      <modules>
       <!--<module>common</module>-->
       <module>bussiness</module>
       <module>account</module>
       <module>storage</module>
       <module>order</module>
       <module>eureka</module>
      </modules>                            
    3. 重新执行 mvn clean install 命令。

    运行成功后common/lib目录下会生成 GTS 的 SDK 包,包括:

    • 客户端主包:~txc-client-${gts.sdk.version}.jar

    • Spring Cloud 原生支持包:txc-client-springcloud-${gts.sdk.version}.jar

    说明

    需要执行以下命令,来触发download-maven-pluginwget

    mvn clean install

步骤三:导入样例工程到 IDE

为了方便运行和理解,建议您把工程导入到 IDE 中。

步骤四:运行样例工程

  1. 分别运行样例工程中 5 个 module 的 Main 方法,启动服务。

    • Storage:StorageApplication

    • Order:OrderApplication

    • Account:AccountApplication

    • Business:BusinessApplication

  2. 服务启动成功后,通过浏览器访问 http://127.0.0.1:8084/purchase 来调用订购业务。

    说明

    可选的调用参数请阅读样例中的 BusinessController.java 的代码来了解。

关键配置和运行机制解读

application.properties 中,seata.txc 前缀的一系列配置是 GTS 关键配置,说明如下:

  • GTS 全局事务调用链路上的每个服务都要做这些配置,例如样例中的Business、Storage、Order和Account。

  • seata.txc.txcAppName:为每个服务定义一个全局唯一的名字。

  • seata.txc.txServiceGroup:GTS 服务实例名。

    • 在本地运行通过公网访问 GTS 服务时,请使用公共的实例 txc_test_public.1129****3855****.QD 并配合使用下面的 seata.txc.servcieEndPoint 配置。

    • 在正式环境 ECS 上运行时,请使用您订购的 GTS 服务实例全名,并配合使用下面的 seata.txc.accessKeyseata.txc.secretKey 配置。

  • seata.txc.servcieEndPoint:公网访问 GTS 服务的接入地址,固定值 https://test-cs-gts.aliyuncs.com 。这个配置仅在本地公网访问时需要。

  • seata.txc.accessKeyseata.txc.secretKey:在阿里云环境上正式运行,这里配置您GTS服务实例使用者的AK和SK用于鉴权。默认是使用订购GTS 服务实例的用户(即实例全名中间部分账号ID对应用户)的AK和SK。也可以使用RAM授权的用户AK和SK,具体方法请参见为 RAM 用户授权事务分组

  • 本页导读 (1)
文档反馈