多活高可用服务 MAS-配置项详细信息列表

时间:2025-01-26 10:40:06

配置项详细信息列表

MAS-DB-SDK配置分为props、etcd、sources、router四部分,在SpringBoot项目中配置项使用驼峰风格,详细信息如下表:

表1 props配置项

名称

说明

默认值

备注

props.appId

MAS应用ID

MAS服务应用列表页中“应用ID”列对应值。

props.monitorId

MAS监控器ID

MAS服务DB监控页中“监控ID”列对应值。

props.databaseName

MAS监控DB名称

MAS服务DB监控页选择应用单击“编辑”中连接池配置下“数据库名称”列对应值。

props.decipherClassName

密码解析类

com.huawei.devspore.mas.password.DefaultDecipher

需要实现基类 。com.huawei.devspore.mas.password.Decipher

props.version

配置文件版本号

当前固定填v1。

props.azs

服务所属AZ信息

路由算法为本地读单边写时必填。

  • props配置项中的值都是取自于本服务在MAS服务注册时展示的值。
  • props配置项中的值与在MAS服务中的来源请参考props、etcd配置项在MAS服务中如何查询
表2 etcd配置项

名称

说明

默认值

备注

etcd.address

ETCD地址

MAS服务总览页单击ETCD连接地址后的查看详情获取。

etcd.apiVersion

ETCD接口版本

v3

固定值v3。

etcd.username

ETCD用户名

MAS服务总览页单击ETCD连接地址后的查看详情获取。

etcd.password

ETCD密码

MAS服务总览页单击ETCD连接地址后的查看详情获取。

etcd.httpsEnable

ETCD是否启用https

false

根据ETCD实际情况选择,最新版本的MAS服务etcd均为https,此处需要配置为true,并配置证书路径。

etcd.certificatePath

启用https时证书存放路径

https证书存放路径。也支持不使用证书,此时不需要配置该配置项。

  • etcd配置项中的值都是取自于本服务在MAS服务etcd展示的值。
  • props配置项中的值与在etcd中的来源请参考props、etcd配置项在MAS服务中如何查询
  • etcd.apiVersion填写固定值V3。
  • etcd.httpsEnable的值取决于ETCD页面“etcd集群地址”访问是http,这里值为false;访问是https,这里值为true。查看方法参考props、etcd配置项在MAS服务中如何查询
表3 sources数据源配置项

名称

说明

默认值

备注

sources.ds1

数据库节点名称:ds1

MAS服务中连接池中的命名一致。

sources.ds1.driverClassName

数据库驱动类名

驱动名称,自定义。

sources.ds1.jdbcUrl

数据库连接地址

MAS服务中连接池中各节点下数据库连接地址一致。

sources.ds1.username

数据库用户名

MAS服务中连接池中各节点下数据库用户名一致。

sources.ds1.password

数据库密码

如果密码为加密,需要自定义实现解密类配置:props.decipherClassName

sources.ds1.type

数据源类型

支持类型如下:

  • com.zaxxer.hikari.HikariDataSource
  • org.apache.commons.dbcp2.BasicDataSource
  • com.alibaba.druid.pool.DruidDataSource

sources.ds1.props

数据源类型其他参数

根据自己选择的数据源类型配置。

props:

connection-timeout: 1000

validation-timeout: 1000

sources主要配置本项目中涉及的一组或者多组数据源,所以上表中"ds1"为数据源的节点名称,如果有多组数据源,按照同样的格式配置多组即可。
  • 对接MAS服务,各组数据源的节点名称与MAS服务中连接池中的命名一致。
  • 无对接MAS服务,各组数据源的节点名称应命名为具有区别意义的名称。
表4 router路由配置

名称

说明

默认值

备注

router.active

默认数据源的激活节点

-

-

router.routeAlgorithm

路由策略

single-read-write

单边读写single-read-write

router.nodes.ds1.loadBalance

读写分离负载均衡算法

可选项:

  • RANDOM是随机。
  • ROUND_ROBIN是轮询。

router.nodes.ds1.master

主数据源

  • 当slaves为空时,读写流量都在master
  • 当slaves不为空时,读流量在slaves,写流量,DDL,事务操作在master。

router.nodes.ds1.slaves

读写分离读数据源列表

-

router.nodes.ds1.azs

该数据中心所属AZ信息

路由算法为本地读单边写,且未对接MAS平台时必填。

router.nodes配置罗列本项目中数据源路由节点,所以上表中“ds1”为数据源路由节点名称,如果有多组数据源,按照同样的格式配置多组即可。
  • 节点router.nodes.ds1.master下配置的源名称为“表3 sources数据源配置项”中的“sources.ds1”主节点的值。
  • 节点router.nodes.ds1.slaves下配置的源名称为“表3”中的“sources.ds1”从节点的值。
  • router.active对应值为router.nodes的一个节点名称。
support.huaweicloud.com/devg-mas/mas-devg-0079.html