dubbo:registry

dubbo:registry element

The configuration of the registry center. The corresponding class is org.apache.dubbo.config.RegistryConfig. If you have multiple different registries, you can declare multiple <dubbo:registry> tags, and then reference specified registry with registry property in <dubbo:service> or <dubbo:reference> tag.

Attribute	Corresponding URL parameter	Type	Required	Default Value	Function	Description	Compatibility
id		string	False		Configuration association	Bean Id of the registry center, can be referenced in <dubbo:service registry="">or <dubbo:reference registry="">	Above 1.0.16
address	<host:port>	string	True		Service discovery	The address of the registry center. If the address has no port, default port 9999 will be adopted. Multiple addresses within the same cluster use `,` to seperate, such as `ip:port,ip:port`. Multiple registries within different cluster, please configure different `dubbo:registry` tag.	Above 1.0.16
protocol	<protocol>	string	False	dubbo	Service discovery	The protocol of the registry center. `dubbo`, `multicast`, `zookeeper`, `redis`, `consul(2.7.1)`, `sofa(2.7.2)`, `etcd(2.7.2)`, `nacos(2.7.2)` are available.	Above 2.0.0
port	<port>	int	False	9090	Service discovery	The default port of the registry. When the `address` has no port, this default port will be adopted.	Above 2.0.0
username	<username>	string	False		Service governance	The usename of the registry. Do not set it if the registry doesn’t need validation.	Above 2.0.0
password	<password>	string	False		Service governance	The password of the registry. Do not set it if the registry doesn’t need validation.	Above 2.0.0
transport	registry.transporter	string	False	netty	Performance optimize	mina, netty are available.	Above 2.0.0
timeout	registry.timeout	int	False	5000	Performance optimize	The timeout(ms) of the request to registry.	Above 2.0.0
session	registry.session	int	False	60000	Performance optimize	The session timeout(ms) of the registry. It’s used to check whether the providers are alive. It depends on the implement of the registry. For example, for HeartBeat implement, the timeout is the interval of two heart beats.	Above 2.1.0
file	registry.file	string	False		Service governance	The local file to cache the address list of registries and providers. When application restarts, it will restore the registries and providers. Please use different file for different registy.	Above 2.0.0
wait	registry.wait	int	False	0	Performance optimize	Stop wait for a notice completion time (ms)	Above 2.0.0
check	check	boolean	False	true	Service governance	Whether throwing exception while the registry isn’t existed.	Above 2.0.0
register	register	boolean	False	true	Service governance	whether registering to the registry center. If false, just subscribing, not registering.	Above 2.0.5
subscribe	subscribe	boolean	False	true	Service governance	whether subscribing from the registry center. If false, just registering, not subscribing.	Above 2.0.5
dynamic	dynamic	boolean	False	true	Service governance	Whether the service is registered dynamically. If false, services will be showed as `disable`, you need to enable it manually. And you also need to disable it when provider shut down.	Above 2.0.5
group	group	string	False	dubbo	Service governance	Service registration grouping, cross-group services will not affect each other, and can not be called each other, suitable for environmental isolation.	Above 2.0.5
simplified	simplified	boolean	False	false	Service governance	Registered with the registry URL whether to adopt the lean mode (compatible with low version)	Above 2.7.0
extra-keys	extraKeys	string	False		Service governance	In simplified = true, extraKeys allows you to outside the default arguments put additional key in the URL, format: “interface, key1, key2”.	Above 2.7.0

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.

Last modified January 22, 2021: Merge branch 'master' of https://github.com/apache/dubbo-website (f48eac9)