Consul 配置中心
在 以 Consul 作为注册中心 的基础上,将 Seata 配置放到 Consul 中
本文基于 Seata 1.4.2,Consul 版本建议 1.8+,下文以 Consul 1.11.2 为例
准备工作
当您决定使用 Consul 作为 Seata 配置中心前,请确保已经启动 Consul 服务。
快速上手
将 Consul 作为 Seata 配置中心的操作步骤非常简单,可分为以下几步:
- seata-server 配置 Consul 为配置中心
- 提交 Key-Value 配置至 Consul
- Client 端 配置 Consul 为配置中心
配置 Consul 为配置中心
首先,请确保您的 Consul 服务已启动
在 Seata 目录下 /conf/registry.conf 中加入对应配置中心,其余配置参考
config {
type = "consul"
consul {
serverAddr = "127.0.0.1:8500"
aclToken = ""
}
}
此时启动 Seata 服务,会提示如下字样信息,可先关闭服务
config operation timeout,cost:5015 ms,op:GET,dataId:store.mode
config operation timeout,cost:5006 ms,op:GET,dataId:metrics.enabled
config operation timeout,cost:5001 ms,op:GET,dataId:transport.threadFactory.bossThreadPrefix
config operation timeout,cost:5009 ms,op:GET,dataId:transport.threadFactory.workerThreadPrefix
# 此处省略类似的其他信息~
提交 Key-Value 配置至 Consul
出现以上报错信息是因为 Consul 中缺少对应配置,请从以下方式中选择其中一种方式提交配置到 Consul Key/Value 中
- 通过 Consul 控制台 ui,Key/Value -> create
- 通过 http 请求
- 通过 Consul 命令行工具
- 推荐:使用官方提供的上传配置脚本
tips: 1.4.2 需要逐个创建 key-value,1.5.0 后支持 key 对应文件
以 store.mode=file 为例,提交报错信息对应的配置,在这里可以找到默认配置
store.mode=file
store.publicKey=
store.file.dir=file_store/data
store.file.maxBranchSessionSize=16384
# 剩下的配置项省略~
推荐使用官方脚本: 以上方式 1~3 需要逐个添加配置,操作较为繁琐,为此官方提供了 脚本 和 默认配置 以快速添加配置
将 config.txt 放在 consul-config.sh 的上层目录, 根据自己的需要微调 config.txt 的配置(主要是 seata.mode 及 seata.file | seata.db | seata.redis 这几个前缀的配置)
执行如下命令
sh {PATH}/consul-config.sh -h localhost -p 8500
具体操作可参考README.md
此时重启 Seata 服务,发现不再报错,即成功使用 Consul 作为配置中心了,后面如需调整配置,可前往控制台单独修改对应的配置,修改后需重启服务
Client 端 配置 Consul 为配置中心
以 SpringBoot 项目为例,在项目 pom.xml 中加入
<dependency>
<groupId>io.seata</groupId>
<artifactId>seata-spring-boot-starter</artifactId>
<version>最新版(Seata版本)</version>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-consul-config</artifactId>
</dependency>
Client端配置
在 application.yml 中加入对应的配置中心,其余配置参考
seata:
config:
type: consul
consul:
server-addr: 127.0.0.1:8500
重启 Client 即可