六、 配置项手册
1. 配置详情
1) application
每个应用必须要有且只有一个application配置,对应的配置类:org.apache.dubbo.config.ApplicationConfig
属性 |
对应URL参数 |
类型 |
是否必填 |
缺省值 |
作用 |
描述 |
兼容性 |
name |
application |
string |
必填 |
|
服务治理 |
当前应用名称,用于注册中心计算应用间依赖关系,注意:消费者和提供者应用名不要一样,此参数不是匹配条件,你当前项目叫什么名字就填什么,和提供者消费者角色无关,比如:kylin应用调用了morgan应用的服务,则kylin项目配成kylin,morgan项目配成morgan,可能kylin也提供其它服务给别人使用,但kylin项目永远配成kylin,这样注册中心将显示kylin依赖于morgan |
2.7.0以上版本 |
compiler |
compiler |
string |
可选 |
javassist |
性能优化 |
Java字节码编译器,用于动态类的生成,可选:jdk或javassist |
2.7.0以上版本 |
logger |
logger |
string |
可选 |
slf4j |
性能优化 |
日志输出方式,可选:slf4j,jcl,log4j,log4j2,jdk |
2.7.0以上版本 |
owner |
owner |
string |
可选 |
|
服务治理 |
应用负责人,用于服务治理,请填写负责人公司邮箱前缀 |
2.0.5以上版本 |
organization |
organization |
string |
可选 |
|
服务治理 |
组织名称(BU或部门),用于注册中心区分服务来源,此配置项建议不要使用autoconfig,直接写死在配置中,比如china,intl,itu,crm,asc,dw,aliexpress等 |
2.0.0以上版本 |
architecture <br class="atl-forced-newline" /> |
architecture <br class="atl-forced-newline" /> |
string |
可选 |
|
服务治理 |
用于服务分层对应的架构。如,intl、china。不同的架构使用不同的分层。 |
2.0.7以上版本 |
environment |
environment |
string |
可选 |
|
服务治理 |
应用环境,如:develop/test/product,不同环境使用不同的缺省值,以及作为只用于开发测试功能的限制条件 |
2.0.0以上版本 |
version |
application.version |
string |
可选 |
|
服务治理 |
当前应用的版本 |
2.7.0以上版本 |
dumpDirectory |
dump.directory |
string |
可选 |
|
服务治理 |
当进程出问题如线程池满时,框架自动dump文件的存储路径 |
2.7.0以上版本 |
qosEnable |
qos.enable |
boolean |
可选 |
|
服务治理 |
是否启用 qos 运维端口 |
2.7.0以上版本 |
qosHost |
qos.host |
string |
可选 |
|
服务治理 |
监听的网络接口地址,默认 0.0.0.0 |
2.7.3以上版本 |
qosPort |
qos.port |
int |
可选 |
|
服务治理 |
监听的网络端口 |
2.7.0以上版本 |
qosAcceptForeignIp |
qos.accept.foreign.ip |
boolean |
可选 |
|
服务治理 |
安全配置,是否接收除localhost本机访问之外的外部请求 |
2.7.0以上版本 |
shutwait |
dubbo.service.shutdown.wait |
string |
可选 |
|
服务治理 |
优雅停机时 shutdown 的等待时间(ms) |
2.7.0以上版本 |
hostname |
|
string |
可选 |
本机主机名 |
服务治理 |
主机名 |
2.7.5以上版本 |
registerConsumer |
registerConsumer |
boolean |
可选 |
true |
服务治理 |
是否注册实例到注册中心。当时实例为纯消费者时才设置为false |
2.7.5以上版本 |
repository |
application.version |
string |
可选 |
|
服务治理 |
当前应用的版本 |
2.7.6以上版本 |
enableFileCache |
file.cache |
boolean |
可选 |
true |
服务治理 |
是否开启本地缓存 |
3.0.0以上版本 |
protocol |
|
string |
可选 |
dubbo |
服务治理 |
首选协议,适用于无法确定首选协议的时候 |
3.0.0以上版本 |
metadataType |
metadata-type |
String |
可选 |
local |
服务治理 |
应用级服务发现 metadata 传递方式,是以 Provider 视角而言的,Consumer 侧配置无效,可选值有: * remote - Provider 把 metadata 放到远端注册中心,Consumer 从注册中心获取; * local - Provider 把 metadata 放在本地,Consumer 从 Provider 处直接获取; |
2.7.5以上版本 |
metadataServiceProtocol |
metadata-service-protocol |
string |
可选 |
dubbo |
服务治理 |
如 metadataType 配置为 local,则该属性设置 MetadataService 服务所用的通信协议,默认为 dubbo |
3.0.0以上版本 |
metadataServicePort |
metadata-service-port |
int |
可选 |
|
服务治理 |
如 metadataType 配置为 local,则该属性设置 MetadataService 服务所用的端口号 |
2.7.9以上版本 |
livenessProbe |
liveness-probe |
string |
可选 |
|
服务治理 |
概念和格式对应 k8s 体系 liveness probe |
3.0.0以上版本 |
readinessProbe |
readiness-probe |
string |
可选 |
|
服务治理 |
概念和格式对应 k8s 体系 readiness probe |
3.0.0以上版本 |
startupProbe |
startup-probe |
string |
可选 |
|
服务治理 |
概念和格式对应 k8s 体系 startup probe |
3.0.0以上版本 |
registerMode |
register-mode |
string |
可选 |
all |
服务治理 |
控制地址注册行为,应用级服务发现迁移用。 * instance 只注册应用级地址; * interface 只注册接口级地址; * all(默认) 同时注册应用级和接口级地址; |
3.0.0以上版本 |
《Apache Dubbo微服务开发从入门到精通》——配置手册——六、 配置项手册(2) :https://developer.aliyun.com/article/1225092