带你读《Apache Dubbo微服务开发从入门到精通》——六、 配置项手册（4）

属性

对应URL参数

类型

是否必填

缺省值

描述

兼容性

protocol

protocol

string

可选

zookeeper

使用哪个配置中心：apollo、zookeeper、nacos等。 以zookeeper为例 1. 指定protocol，则address可以简化为127.0.0.1:2181； 2. 不指定protocol，则address取值为zookeeper://127.0.0.1:2181

2.7.0以上版本

address

address

string

必填

配置中心地址。 取值参见protocol说明

2.7.0以上版本

highestPriority

highest-priority

boolean

可选

true

来自配置中心的配置项具有最高优先级，即会覆盖本地配置项。

2.7.0以上版本

namespace

namespace

string

可选

dubbo

通常用于多租户隔离，实际含义视具体配置中心而不同。 如： zookeeper - 环境隔离，默认值dubbo； apollo - 区分不同领域的配置集合，默认使用dubbo和application

2.7.0以上版本

cluster

cluster

string

可选

含义视所选定的配置中心而不同。 如Apollo中用来区分不同的配置集群

2.7.0以上版本

group

group

string

可选

dubbo

含义视所选定的配置中心而不同。 nacos - 隔离不同配置集 zookeeper - 隔离不同配置集

2.7.0以上版本

check

check

boolean

可选

true

当配置中心连接失败时，是否终止应用启动。

2.7.0以上版本

configFile

config-file

string

可选

dubbo.properties

全局级配置文件所映射到的key zookeeper - 默认路径/dubbo/config/dubbo/dubbo.properties apollo - dubbo namespace中的dubbo.properties键

2.7.0以上版本

appConfigFile

app-config-file

string

可选

“configFile”是全局级共享的。此项仅限于此应用程序配置的属性

2.7.0以上版本

timeout

timeout

int

可选

3000ms

获取配置的超时时间

2.7.0以上版本

username

username

string

可选

如果配置中心需要做校验，用户名 Apollo暂未启用

2.7.0以上版本

password

password

string

可选

如果配置中心需要做校验，密码 Apollo暂未启用

2.7.0以上版本

parameters

parameters

Map<string, string>

可选

扩展参数，用来支持不同配置中心的定制化配置参数

2.7.0以上版本

includeSpringEnv

include-spring-env

boolean

可选

false

使用Spring框架时支持，为true时，会自动从Spring Environment中读取配置。 默认依次读取 key为dubbo.properties的配置 key为dubbo.properties的PropertySource

2.7.0以上版本

属性

对应URL参数

类型

是否必填

缺省值

描述

兼容性

address

address

string

必填

元数据中心地址。

2.7.0以上版本

protocol

protocol

string

可选

zookeeper

元数据中心协议：zookeeper、nacos、redis等。 以zookeeper为例 1. 指定protocol，则address可以简化为127.0.0.1:2181； 2. 不指定protocol，则address取值为zookeeper://127.0.0.1:2181

2.7.13以上版本

port

port

int

可选

元数据中心端口号。指定port，则address可简化，不用配置端口号

2.7.13以上版本

username

username

string

可选

元数据中心需要做校验，用户名 Apollo暂未启用

2.7.0以上版本

password

password

string

可选

元数据中心需要做校验，密码 Apollo暂未启用

2.7.0以上版本

timeout

timeout

int

可选

获取元数据超时时间(ms)

2.7.0以上版本

group

group

string

可选

dubbo

元数据分组，适用于环境隔离。与注册中心group意义相同

2.7.0以上版本

retryTimes

retry-times

int

可选

100

重试次数

2.7.0以上版本

retryPeriod

retry-period

int

可选

3000ms

重试间隔时间(ms)

2.7.0以上版本

cycleReport

cycle-report

boolean

可选

true

是否每天更新完整元数据

2.7.0以上版本

syncReport

sync-report

boolean

可选

false

是否同步更新元数据，默认为异步

2.7.0以上版本

cluster

cluster

string

可选

含义视所选定的元数据中心而不同。 如Apollo中用来区分不同的配置集群

2.7.0以上版本

file

file

string

可选

使用文件缓存元数据中心列表，应用重启时将基于此文件恢复，注意：两个元数据中心不能使用同一文件存储

2.7.0以上版本

check

check

boolean

可选

true

当元数据中心连接失败时，是否终止应用启动。

3.0.0以上版本

reportMetadata

report-metadata

boolean

可选

false

是否上地址发现中的接口配置报元数据，dubbo.application.metadata-type=remote 该配置不起作用即一定会上报，dubbo.application.metadata-type=local 时是否上报由该配置值决定

3.0.0以上版本

reportDefinition

report-definition

boolean

可选

true

是否上报服务运维用元数据

3.0.0以上版本

reportConsumerDefinition

report-consumer-definition

boolean

可选

true

是否在消费端上报服务运维用元数据

3.0.0以上版本

parameters

parameters

Map<string, string>

可选

扩展参数，用来支持不同元数据中心的定制化配置参数

2.7.0以上版本