事务分组专题
事务分组是什么?
- 事务分组:seata的资源逻辑,可以按微服务的需要,在应用程序(客户端)对自行定义事务分组,每组取一个名字。
- 集群:seata-server服务端一个或多个节点组成的集群cluster。 应用程序(客户端)使用时需要指定事务逻辑分组与Seata服务端集群的映射关系。
事务分组如何找到后端Seata集群?
- 首先应用程序(客户端)中配置了事务分组(GlobalTransactionScanner 构造方法的txServiceGroup参数)。若应用程序是SpringBoot则通过seata.tx-service-group 配置
- 应用程序(客户端)会通过用户配置的配置中心去寻找service.vgroupMapping .[事务分组配置项],取得配置项的值就是TC集群的名称。若应用程序是SpringBoot则通过seata.service.vgroup-mapping.事务分组名=集群名称 配置
- 拿到集群名称程序通过一定的前后缀+集群名称去构造服务名,各配置中心的服务名实现不同(前提是Seata-Server已经完成服务注册,且Seata-Server向注册中心报告cluster名与应用程序(客户端)配置的集群名称一致)
- 拿到服务名去相应的注册中心去拉取相应服务名的服务列表,获得后端真实的TC服务列表(即Seata-Server集群节点列表)
为什么这么设计,不直接取服务名?
这里多了一层获取事务分组到映射集群的配置。这样设计后,事务分组可以作为资源的逻辑隔离单位,出现某集群故障时可以快速failover,只切换对应分组,可以把故障缩减到服务级别,但前提也是你有足够server集群。
事务分组使用案例
seata注册、配置中心类型分为两大类:
- 内置File
- 第三方注册(配置)中心。如nacos等等,注册中心和配置中心之间没有约束,可各自使用不同具体选型。
第一类:内置File
Seata Server端
registry.conf
registry {
# file 、nacos 、eureka、redis、zk、consul、etcd3、sofa
type = "file" ---------------> 使用file作为注册中心
}
config {
# file、nacos 、apollo、zk、consul、etcd3
type = "file" ---------------> 使用file作为配置中心
file {
name = "file.conf"
}
}
- file、db模式启动Seata Server,见文章上方节点:启动Seata Server
Client端
registry.conf
registry {
# file 、nacos 、eureka、redis、zk、consul、etcd3、sofa
type = "file" ---------------> 使用file作为注册中心
}
config {
# file、nacos 、apollo、zk、consul、etcd3
type = "file" ---------------> 使用file作为配置中心
file {
name = "file.conf" ---------------> 配置参数存储文件
}
}
file.conf
service {
vgroupMapping.my_test_tx_group = "default"
default.grouplist = "127.0.0.1:8091"
}
application.properties
seata.tx-service-group=my_test_tx_group ---------------> 事务分组配置(在v1.5之后默认值为default_tx_group)
- 读取配置 通过FileConfiguration本地加载file.conf的配置参数
- 获取事务分组(服务启动时加载配置) spring/springboot可配置在yml、properties中,对应值”my_test_tx_group”即为事务分组名,若不配置则默认以:spring.application.name值+”-seata-service-group”拼接后的字符串作为分组名
- 查找TC集群名 拿到事务分组名”my_test_tx_group”拼接成”service.vgroupMapping.my_test_tx_group”查找TC集群名clusterName为”default”
- 查询TC服务 拼接”service.”+clusterName+”.grouplist”找到真实TC服务地址127.0.0.1:8091
第二类:注册中心和配置中心(以nacos为例)
Seata Server端
registry.conf
registry {
# file 、nacos 、eureka、redis、zk、consul、etcd3、sofa
type = "nacos" ---------------> 使用nacos作为注册中心
nacos {
application = "seata-server" ---------------> 指定注册至nacos注册中心的服务名
group = "SEATA_GROUP" ---------------> 指定注册至nacos注册中心的分组名
serverAddr = "localhost" ---------------> nacos注册中心IP:端口
namespace = "" ---------------> nacos命名空间id,""为nacos保留public空间控件,用户勿配置namespace = "public"
cluster = "default" ---------------> 指定注册至nacos注册中心的集群名
}
}
config {
# file、nacos 、apollo、zk、consul、etcd3
type = "nacos" ------------> 使用nacos作为配置中心
nacos {
serverAddr = "localhost" ---------------> nacos注册中心IP:端口
namespace = ""
group = "SEATA_GROUP" ---------------> nacos配置中心的分组名
dataId = "seataServer.properties" ---------------> nacos配置中心的配置ID
}
}
配置中心配置项
在Seata Server的安装目录conf下
README-zh.md
或README.md
文件中介绍了Seata需要的常见脚本URL链接,包括三类:客户端的配置和SQL、SeataServer端部署所需SQL和脚本、配置中心配置项模板和脚本。 其中在script/config-center下有文件和目录如下:- README.md 使用帮助
- config.txt 配置项模板(包含Server和Client)
- nacos/ 推至nacos的python和shell脚本
- apollo/ 推至apollo的shell脚本
- consul/ 推至consul的shell脚本
- etcd3/ 推至etcd3的shell脚本
- zk/ 推至zookeeper的shell脚本
config.txt模板中的配置项,需要根据实际情况筛选和修改。 然后配置到配置中心:即可参照README.md使用帮助通过脚本推送至配置中心。也将config.txt中的内容人工拷贝至配置中心(例如通过nacos配置中心的Web页面)。 配置完毕后需要检查结果是否正确。
注册至注册中心 启动seata-server注册至nacos注册中心,查看nacos控制台服务列表确认是否成功
Client端
seata.tx-service-group=my_test_tx_group ---------------> 事务分组配置(在v1.5之后默认值为default_tx_group)
registry {
# file 、nacos 、eureka、redis、zk、consul、etcd3、sofa
type = "nacos" ---------------> 从nacos获取TC服务
nacos {
serverAddr = "localhost"
namespace = ""
}
}
config {
# file、nacos 、apollo、zk、consul、etcd3
type = "nacos" ---------------> 使用nacos作为配置中心
nacos {
serverAddr = "localhost"
namespace = ""
}
}
Client端(SpringBoot)
application.properties
seata.tx-service-group=my_test_tx_group ---------------> 事务分组配置(在v1.5之后默认值为default_tx_group)
seata.service.vgroup-mapping.my_test_tx_group=default ---------------> 指定事务分组至集群映射关系(等号右侧的集群名需要与Seata-server注册到Nacos的cluster保持一致)
seata.registry.type=nacos ---------------> 使用nacos作为注册中心
seata.registry.nacos.server-addr=nacos注册中心IP:端口
seata.registry.nacos.application=seata-server ---------------> Seata服务名(应与seata-server实际注册的服务名一致)
seata.registry.nacos.group=SEATA_GROUP ---------------> Seata分组名(应与seata-server实际注册的分组名一致)
另外:若Client不通过Nacos获取seata-server服务信息,而是直接指定seata-server服务端节点的IP和端口信息,则可将以上application.properties中涉及nacos几个配置改为如两个配置:
seata.registry.type=file ——> 不推荐在正式环境使用
seata.service.grouplist.cluster_beijing=127.0.0.1:8091 ——> vgroup-mapping(服务端cluster)各个seata-server节点信息
- 读取配置 通过NacosConfiguration远程读取seata配置参数
- 获取事务分组(服务启动时加载配置) spring/springboot可配置在yml、properties中,对应值”my_test_tx_group”即为事务分组名,若不配置则默认以:spring.application.name值+”-seata-service-group”拼接后的字符串作为分组名
- 查找TC集群名 拿到事务分组名”my_test_tx_group”拼接成”service.vgroupMapping.my_test_tx_group”从配置中心查找到TC集群名clusterName为”default”
- 查找TC服务 根据serverAddr和namespace以及clusterName在注册中心找到真实TC服务列表
注:serverAddr和namespace与Server端一致,clusterName与Server端cluster一致