You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@dubbo.apache.org by al...@apache.org on 2022/07/19 12:43:46 UTC

[dubbo-website] branch master updated: [fix] 注册中心参考手册——Nacos——使用说明 文档优化 #31 (#1253)

This is an automated email from the ASF dual-hosted git repository.

albumenj pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git


The following commit(s) were added to refs/heads/master by this push:
     new 6ddb6e5b76 [fix] 注册中心参考手册——Nacos——使用说明 文档优化 #31 (#1253)
6ddb6e5b76 is described below

commit 6ddb6e5b7630603df5ccebea5f207a90a1426bdc
Author: fanla2021 <57...@qq.com>
AuthorDate: Tue Jul 19 20:43:42 2022 +0800

    [fix] 注册中心参考手册——Nacos——使用说明 文档优化 #31 (#1253)
    
    * https://github.com/apache/dubbo-awesome/issues/31
    
    * https://github.com/apache/dubbo-awesome/issues/31
    Delete Dubbo 2.6.5 and modify the link address of Dubbo registry Nacos。
    
    * https://github.com/apache/dubbo-awesome/issues/31
    Update dubbo3.0 Nacos instructions。
    
    * Modify picture position
    
    # Conflicts:
    #       content/zh/docs3-building/java-sdk/reference-manual/registry/nacos/guide.md
    
    * add files
    
    * 解决图片显示问题和weight数字问题。
    
    * 更新最新内容
    
    * 更新最新内容
    
    * delete .idea目录
    
    * delete nacos注册中心guide.md
    
    * fix 优化nacos注册中心手册
    
    * delete metadata/nacos.md
    
    Co-authored-by: fanlian <fa...@chinaunicom.cn>
    Co-authored-by: wangyigeng <wa...@jd.com>
---
 .../reference-manual/registry/nacos/_index.md      | 78 +++++++++++++++++-----
 1 file changed, 60 insertions(+), 18 deletions(-)

diff --git a/content/zh/docs3-building/java-sdk/reference-manual/registry/nacos/_index.md b/content/zh/docs3-building/java-sdk/reference-manual/registry/nacos/_index.md
index e88c790b78..5497d46504 100644
--- a/content/zh/docs3-building/java-sdk/reference-manual/registry/nacos/_index.md
+++ b/content/zh/docs3-building/java-sdk/reference-manual/registry/nacos/_index.md
@@ -9,6 +9,7 @@ description: "Nacos 注册中心的基本使用和工作原理。"
 ## 1 前置条件
 * 了解 [Dubbo 基本开发步骤](../../../quick-start/spring-boot/)
 * 安装并启动 [Nacos 服务](https://nacos.io/zh-cn/docs/quick-start.html)
+>当Dubbo使用`3.0.0`及以上版本时，需要使用Nacos `2.0.0`及以上版本。
 
 ## 2 使用说明
 在此查看[完整示例代码](https://github.com/apache/dubbo-samples/tree/master/dubbo-samples-nacos/dubbo-samples-nacos-registry/)
@@ -36,8 +37,8 @@ description: "Nacos 注册中心的基本使用和工作原理。"
     -->
 </dependencies>
 ```
-
 增加 Dubbo 与 Nacos 依赖
+>Dubbo `3.0.0`及以上版本，dubbo-registry-nacos引入nacos-client`2.0.0`及以上版本
 
 ### 2.2 配置并启用 Nacos
 
@@ -77,12 +78,12 @@ dubbo
 dubbo.registry.address: nacos://nacos:nacos@localhost:8848
 ```
 
-### 3.1 自定义命名空间
+### 3.2 自定义命名空间
 
 ```yaml
 # application.yml (Spring Boot)
-dubbo
- registry
+dubbo:
+ registry:
    address: nacos://localhost:8848?namespace=5cbb70a5-xxx-xxx-xxx-d43479ae0932
 ```
 
@@ -90,34 +91,75 @@ dubbo
 
 ```yaml
 # application.yml (Spring Boot)
-dubbo
- registry
+dubbo:
+ registry:
    address: nacos://localhost:8848
    parameters.namespace: 5cbb70a5-xxx-xxx-xxx-d43479ae0932
 ```
 
-### 3.2 自定义分组
+### 3.3 自定义分组
 
 ```yaml
 # application.yml
-dubbo
- registry
+dubbo:
+ registry:
    address: nacos://localhost:8848
    group: dubbo
 ```
 
 > 如果不配置的话，group 是由 Nacos 默认指定。group 和 namespace 在 Nacos 中代表不同的隔离层次，通常来说 namespace 用来隔离不同的用户或环境，group 用来对同一环境内的数据做进一步归组。
 
-### 3.3 更多配置
-在nacos-server@`1.0.0`版本后，支持客户端通过上报一些包含特定的元数据的实例到服务端来控制实例的一些行为。
+### 3.4 注册接口级消费者
+Dubbo3.0.0版本以后，增加了是否注册消费者的参数，如果需要将消费者注册到nacos注册中心上，需要将参数(register-consumer-url)设置为true，默认是false。
+```yaml
+# application.yml
+dubbo:
+  registry:
+    address: nacos://localhost:8848?register-consumer-url=true
+```
+或者
+```yaml
+# application.yml
+dubbo:
+  registry:
+    address: nacos://localhost:8848
+    parameters.register-consumer-url: true
+    
+```
 
-   例如:
+### 3.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指定的连接点，可参考[文档](https://nacos.io/zh-cn/blog/address-server.html)|空
+endpointPort|连接Nacos Server指定的连接点端口，可以参考[文档](https://nacos.io/zh-cn/blog/address-server.html)|空
+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`   : 该实例在不发送心跳后，从健康到不健康的时间。（单位:毫秒）
-   `preserved.ip.delete.timeout`    : 该实例在不发送心跳后，被服务端下掉该实例的时间。（单位:毫秒）
-   `preserved.heart.beat.interval`  : 该实例在客户端上报心跳的间隔时间。（单位:毫秒）
-   `preserved.instance.id.generator`: 该实例的id生成策略，值为`snowflake`时，从0开始增加。
-   `preserved.register.source`      : 保留键，目前未使用。
+参数名 | 中文描述| 默认值
+---|---|---
+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，如
 
@@ -144,4 +186,4 @@ dubbo
 
 
 
-> Dubbo3 默认采用 "应用级服务发现 + 接口级服务发现" 的双注册模式，因此会发现应用级服务（应用名）和接口级服务（接口名）同时出现在 Nacos 控制台，可以通过配置 `dubbo.registry.register-mode=instance/interface/all` 来改变注册行为。
\ No newline at end of file
+> Dubbo3 默认采用 "应用级服务发现 + 接口级服务发现" 的双注册模式，因此会发现应用级服务（应用名）和接口级服务（接口名）同时出现在 Nacos 控制台，可以通过配置 `dubbo.registry.register-mode=instance/interface/all` 来改变注册行为。