Configuration Center on Apache Dubbo

Config Center

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

The Config Center in Dubbo has two main responsibilities:

Externalized Configuration: Centralized storage for startup configurations (simplified as external storage of dubbo.properties).
Storage of traffic governance rules.

Please refer to specific extension implementations to learn how to enable the Config Center.

It is worth noting that the Dubbo dynamic configuration center defines two different levels of isolation options, namely namespace and group.

namespace - Configuration namespace, default value dubbo. The namespace is usually used for multi-tenant isolation, logically isolating different users, different environments, or completely unrelated sets of configurations, as opposed to physical isolation, where different namespaces still use the same physical cluster.
group - Configuration group, default value dubbo. The group is typically used to classify a set of configuration items of the same type/purpose, providing further isolation of configuration items under the namespace.

Refer to Configuration Instructions - Configuration Item Manual for more configuration items available in the config-center beyond namespace and group.

Zookeeper

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

1 Prerequisites

Understand Dubbo basic development steps
Install and start Zookeeper

2 Usage Instructions

View the complete sample code

2.1 Add Maven Dependencies

If the project has already enabled Zookeeper as the registry, no additional configurations are necessary.

If Zookeeper is not used as the registry, refer to Add Zookeeper related dependencies for the registry.

2.2 Enable Zookeeper Configuration Center

<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");

For the format of address, refer to zookeeper registry - enable configuration

Nacos

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

1 Prerequisites

Understand Basic Development Steps of Dubbo
Install and start Nacos

When Dubbo uses version 3.0.0 or above, Nacos version 2.0.0 or above is required. Please refer to nacos registry for Nacos version compatibility.

2 Instructions

2.1 Add Maven Dependency

If the project has already enabled Nacos as a registry, no additional configuration is required.

If Nacos registry is not enabled, please refer to Add Nacos dependency for registry.

2.2 Enable Nacos Configuration Center

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

Apollo

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

1 Preconditions

Understand the basic development steps of Dubbo
Install and start Apollo

2 Usage Instructions

View the complete example code

2.1 Add Maven Dependency

<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 Enable Apollo Configuration Center

<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 Advanced Configuration

A core concept in Apollo is the namespace, which is different from the namespace concepts of Zookeeper and Nacos. Therefore, the usage is somewhat special; it is recommended to fully understand Apollo’s usage before reading the following document content.

More Implementations of Configuration Center Extensions

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

The Dubbo framework also provides default implementations for configuration centers such as etcd and consul.

Etcd

The Etcd configuration center is maintained by the community ecosystem library, for more details see .

Add dependency:

<dependency>
 <groupId>org.apache.dubbo.extensions</groupId>
 <artifactId>dubbo-configcenter-etcd</artifactId>
 <version>3.3.0</version>
</dependency>

Adjust configuration:

dubbo
 config-center
 address: etcd://127.0.0.1:1111

Consul

The Consul configuration center is maintained by the community ecosystem library, for more details see .

Add dependency:

<dependency>
 <groupId>org.apache.dubbo.extensions</groupId>
 <artifactId>dubbo-configcenter-consul</artifactId>
 <version>3.3.0</version>
</dependency>

Adjust configuration: