使用 Nacos 作为注册中心实现自动服务发现
本示例演示 Nacos 作为注册中心实现自动服务发现,示例基于 Spring Boot 应用展开,可在此查看 完整示例代码
1 基本配置
1.1 增加依赖
增加 dubbo、nacos-client 依赖:
<dependencies><dependency><groupId>org.apache.dubbo</groupId><artifactId>dubbo</artifactId><version>3.3.0</version></dependency><dependency><groupId>com.alibaba.nacos</groupId><artifactId>nacos-client</artifactId><version>2.1.0</version></dependency>
</dependencies>
对于 Spring Boot 应用,可以使用如下 spring-boot-starter:
<dependency><groupId>org.apache.dubbo</groupId><artifactId>dubbo-spring-boot-starter</artifactId><version>3.3.0</version>
</dependency>
<dependency><groupId>org.apache.dubbo</groupId><artifactId>dubbo-nacos-spring-boot-starter</artifactId><version>3.3.0</version>
</dependency>
1.2 Nacos 版本
Nacos 版本映射关系:
Dubbo | 推荐 Nacos 版本 | Nacos 兼容范围 |
---|---|---|
3.3.0 | 2.2.3 | 2.x |
3.2.21 | 2.1.0 | 2.x |
3.1.11 | 2.0.9 | 2.x |
3.0.10 | 2.0.9 | 2.x |
2.7.21 | 1.x | 1.x |
2.6.0 | 1.x | 1.x |
1.3 配置并启用 Nacos
# application.yml (Spring Boot)
dubboregistryaddress: nacos://localhost:8848register-mode: instance # 新用户请设置此值,表示启用应用级服务发现,可选值 interface、instance、all,默认值为 all,未来版本将切换默认值为 instance
或
# dubbo.properties
dubbo.registry.address=nacos://localhost:8848
dubbo.registry.register-mode=instance
或
<dubbo:registry address="nacos://localhost:8848" register-mode="instance"/>
2 高级配置
2.1 认证
# application.yml (Spring Boot)
dubboregistryaddress: nacos://localhost:8848?username=nacos&password=nacosregister-mode: instance
或
# dubbo.properties
dubbo.registry.address: nacos://nacos:nacos@localhost:8848
# 新用户请设置此值,表示启用应用级服务发现,可选值 interface、instance、all,默认值为 all,未来版本将切换默认值为 instance
dubbo.registry.register-mode=instance
2.2 自定义命名空间
# application.yml (Spring Boot)
dubbo:registry:address: nacos://localhost:8848?namespace=5cbb70a5-xxx-xxx-xxx-d43479ae0932register-mode: instance # 新用户请设置此值,表示启用应用级服务发现,可选值 interface、instance、all
或者
# application.yml (Spring Boot)
dubbo:registry:address: nacos://localhost:8848register-mode: instance # 新用户请设置此值,表示启用应用级服务发现,可选值 interface、instance、allparameters.namespace: 5cbb70a5-xxx-xxx-xxx-d43479ae0932
2.3 自定义分组
# application.yml
dubbo:registry:address: nacos://localhost:8848register-mode: instance # 新用户请设置此值,表示启用应用级服务发现,可选值 interface、instance、allgroup: dubbo
如果不配置的话,group 是由 Nacos 默认指定。group 和 namespace 在 Nacos 中代表不同的隔离层次,通常来说 namespace 用来隔离不同的用户或环境,group 用来对同一环境内的数据做进一步归组。
2.4 注册接口级消费者
Dubbo 3.0.0 版本以后,增加了是否注册消费者的参数,如果需要将消费者注册到 nacos 注册中心上,需要将参数(register-consumer-url)设置为true,默认是false。
# application.yml
dubbo:registry:register-mode: instance # 新用户请设置此值,表示启用应用级服务发现,可选值 interface、instance、alladdress: nacos://localhost:8848?register-consumer-url=true
或者
# application.yml
dubbo:registry:address: nacos://localhost:8848register-mode: instance # 新用户请设置此值,表示启用应用级服务发现,可选值 interface、instance、allparameters.register-consumer-url: true
2.5 更多配置
参数名 | 中文描述 | 默认值 |
---|---|---|
username | 连接Nacos Server的用户名 | nacos |
paasword | 连接Nacos Server的密码 | nacos |
backup | 备用地址 | 空 |
namespace | 命名空间的ID | public |
group | 分组名称 | DEFAULT_GROUP |
register-consumer-url | 是否注册消费端 | false |
com.alibaba.nacos.naming.log.filename | 初始化日志文件名 | naming.log |
endpoint | 连接Nacos Server指定的连接点,可参考文档 | 空 |
endpointPort | 连接Nacos Server指定的连接点端口,可以参考文档 | 空 |
endpointQueryParams | endpoint查参数询 | 空 |
isUseCloudNamespaceParsing | 是否解析云环境中的namespace参数 | true |
isUseEndpointParsingRule | 是否开启endpoint 参数规则解析 | true |
namingLoadCacheAtStart | 启动时是否优先读取本地缓存 | true |
namingCacheRegistryDir | 指定缓存子目录,位置为 …/nacos/{SUB_DIR}/naming | 空 |
namingClientBeatThreadCount | 客户端心跳的线程池大小 | 机器的CPU数的一半 |
namingPollingThreadCount | 客户端定时轮询数据更新的线程池大小 | 机器的CPU数的一半 |
namingRequestDomainMaxRetryCount | client通过HTTP向Nacos Server请求的重试次数 | 3 |
namingPushEmptyProtection | 在服务没有有效(健康)实例时,是否开启保护,开启后则会使用旧的服务实例 | false |
push.receiver.udp.port | 客户端UDP的端口 | 空 |
在nacos-server@1.0.0
版本后,支持客户端通过上报一些包含特定的元数据的实例到服务端来控制实例的一些行为。
参数名 | 中文描述 | 默认值 |
---|---|---|
preserved.heart.beat.timeout | 该实例在不发送心跳后,从健康到不健康的时间(毫秒) | 15000 |
preserved.ip.delete.timeout | 该实例在不发送心跳后,被服务端下掉该实例的时间(毫秒) | 30000 |
preserved.heart.beat.interval | 该实例在客户端上报心跳的间隔时间(毫秒) | 5000 |
preserved.instance.id.generator | 该实例的id生成策略,值为snowflake 时,从0开始增加 | simple |
preserved.register.source | 注册实例注册时服务框架类型(例如Dubbo,Spring Cloud等) | 空 |
这些参数都可以类似 namespace
的方式通过通过参数扩展配置到 Nacos,如
dubbo.registry.parameters.preserved.heart.beat.timeout=5000
3 工作原理
在前面的一节中,我们讲解了应用级服务发现与接口级服务发现的区别,以下是两种模式在 Nacos 实现中的具体存储结构。
3.1 Dubbo2 注册数据
随后,重启您的 Dubbo 应用,Dubbo 的服务提供和消费信息在 Nacos 控制台中可以显示:
如图所示,服务名前缀为 providers:
的信息为服务提供者的元信息,consumers:
则代表服务消费者的元信息。点击“详情”可查看服务状态详情
3.2 Dubbo3 注册数据
应用级服务发现的 “服务名” 为应用名
Dubbo3 默认采用 “应用级服务发现 + 接口级服务发现” 的双注册模式,因此会发现应用级服务(应用名)和接口级服务(接口名)同时出现在 Nacos 控制台,可以通过配置
dubbo.registry.register-mode=instance/interface/all
来改变注册行为。