配置中心 on Apache Dubbo

配置中心

Mon, 01 Jan 0001 00:00:00 +0000

配置中心 (config-center) 在 Dubbo 中可承担两类职责：

外部化配置：启动配置的集中式存储（简单理解为 dubbo.properties 的外部化存储）。
流量治理规则存储

请参考具体扩展实现了解如何启用配置中心。

值得注意的是 Dubbo 动态配置中心定义了两个不同层次的隔离选项，分别是 namespace 和 group。

namespace - 配置命名空间，默认值 dubbo。命名空间通常用于多租户隔离，即对不同用户、不同环境或完全不关联的一系列配置进行逻辑隔离，区别于物理隔离的点是不同的命名空间使用的还是同一物理集群。
group - 配置分组，默认值 dubbo。group 通常用于归类一组相同类型/目的的配置项，是对 namespace 下配置项的进一步隔离。

参考配置说明 - 配置项手册了解 namespace 和 group 之外 config-center 开放的更多配置项。

使用注册中心作为默认配置中心

在使用 Zookeeper、Nacos 作为注册中心且没有显式配置配置中心的情况下，Dubbo 框架会默认将此 Zookeeper、Nacos 用作配置中心，用作服务治理用途。

Zookeeper

Mon, 01 Jan 0001 00:00:00 +0000

1 前置条件

了解 Dubbo 基本开发步骤
安装并启动 Zookeeper

2 使用说明

在此查看完整示例代码

2.1 增加 Maven 依赖

如果项目已经启用 Zookeeper 作为注册中心，则无需增加任何额外配置。

如果未使用 Zookeeper 注册中心，则请参考为注册中心增加 Zookeeper 相关依赖。

2.2 启用 Zookeeper 配置中心

<dubbo:config-center address="zookeeper://127.0.0.1:2181"/>

或者

dubbo
 config-center
 address: zookeeper://127.0.0.1:2181

或者

dubbo.config-center.address=zookeeper://127.0.0.1:2181

或者

ConfigCenterConfig configCenter = new ConfigCenterConfig();
configCenter.setAddress("zookeeper://127.0.0.1:2181");

address 格式请参考 zookeeper 注册中心 - 启用配置

3 高级配置

如要开启认证鉴权，请参考 zookeeper 注册中心 - 启用认证鉴权

3.1 定制外部化配置 key

1. 启用外部化配置，并指定 key

dubbo
 config-center
 address: zookeeper://127.0.0.1:2181
 config-file: dubbo.properties

config-file - 外部化配置文件 key 值，默认 dubbo.properties。config-file 代表将 Dubbo 配置文件存储在远端注册中心时，文件在配置中心对应的 key 值，通常不建议修改此配置项。

Nacos

Mon, 01 Jan 0001 00:00:00 +0000

1 前置条件

了解 Dubbo 基本开发步骤
安装并启动 Nacos

当Dubbo使用3.0.0及以上版本时，需要使用Nacos 2.0.0及以上版本。请参考 nacos 注册中心了解 nacos 版本适配情况。

2 使用说明

2.1 增加 Maven 依赖

如果项目已经启用 Nacos 作为注册中心，则无需增加任何额外配置。

如果未启用 Nacos 注册中心，则请参考为注册中心增加 Nacos 依赖。

2.2 启用 Nacos 配置中心

<dubbo:config-center address="nacos://127.0.0.1:8848"/>

或者

dubbo
 config-center
 address: nacos://127.0.0.1:8848

或者

dubbo.config-center.address=nacos://127.0.0.1:8848

或者

ConfigCenterConfig configCenter = new ConfigCenterConfig();
configCenter.setAddress("nacos://127.0.0.1:8848");

address 格式请参考 Nacos 注册中心 - 启用配置

3 高级配置

如要开启认证鉴权，请参考 Nacos 注册中心 - 启用认证鉴权

3.1 外部化配置

3.1.1 全局外部化配置

1. 应用开启 config-center 配置

dubbo
 config-center
 address: nacos://127.0.0.1:2181
 config-file: dubbo.properties # optional

config-file - 全局外部化配置文件 key 值，默认 dubbo.properties。config-file 代表将 Dubbo 配置文件存储在远端注册中心时，文件在配置中心对应的 key 值，通常不建议修改此配置项。

Apollo

Mon, 01 Jan 0001 00:00:00 +0000

1 前置条件

了解 Dubbo 基本开发步骤
安装并启动 Apollo

2 使用说明

在此查看完整示例代码

2.1 增加 Maven 依赖

<dependency>
 <groupId>org.apache.dubbo</groupId>
 <artifactId>dubbo</artifactId>
 <version>3.0.9</version>
</dependency>
<dependency>
 <groupId>com.ctrip.framework.apollo</groupId>
 <artifactId>apollo-openapi</artifactId>
 <version>2.0.0</version>
</dependency>
<dependency>
 <groupId>com.ctrip.framework.apollo</groupId>
 <artifactId>apollo-client</artifactId>
 <version>2.0.0</version>
</dependency>

2.2 启用 Apollo 配置中心

<dubbo:config-center address="apollo://localhost:8080"/>

或者

dubbo
 config-center
 address: apollo://localhost:8080

或者

dubbo.config-center.address=apollo://localhost:8080

或者

ConfigCenterConfig configCenter = new ConfigCenterConfig();
configCenter.setAddress("apollo://localhost:8080");

3 高级配置

Apollo中的一个核心概念是命名空间 - namespace，和上面 Zookeeper、Nacos 的 namespace 概念不同，因此使用方式上也比较特殊些，建议充分了解 Apollo 自身的用法后再阅读以下文档内容。

但总的来说，对 Apollo 的适配而言：

group 特用于外部化配置的隔离，参见 3.1
namespace 特用于流量治理规则隔离，参见 3.2

3.1 外部化配置

<dubbo:config-center group="demo-provider" address="apollo://localhost:8080"/>

config-center 的 group 决定了 Apollo 读取外部化配置 dubbo.properties 文件的位置：

配置中心 on Apache Dubbo

配置中心

使用注册中心作为默认配置中心

Zookeeper

1 前置条件

2 使用说明

2.1 增加 Maven 依赖

2.2 启用 Zookeeper 配置中心

3 高级配置

3.1 定制外部化配置 key

Nacos

1 前置条件

2 使用说明

2.1 增加 Maven 依赖

2.2 启用 Nacos 配置中心

3 高级配置

3.1 外部化配置

3.1.1 全局外部化配置

Apollo

1 前置条件

2 使用说明

2.1 增加 Maven 依赖

2.2 启用 Apollo 配置中心

3 高级配置

3.1 外部化配置

更多配置中心扩展实现

Etcd

Consul