From fa64951dbc2c405b59a3fed7892a43e3cf18469f Mon Sep 17 00:00:00 2001
From: lulu <1534972955@qq.com>
Date: Sat, 6 Jan 2024 21:21:01 +0800
Subject: [PATCH 1/6] refactor: modify the Chinese version of the discovery doc
---
docs/user-guide/discovery/discovery-mode.md | 328 +++++++--------
.../user-guide/discovery/discovery-mode.md | 379 +++++++++---------
.../discovery/add-selector-basic-zh.png | Bin 0 -> 459722 bytes
.../discovery/add-selector-local-zh.png | Bin 0 -> 401403 bytes
...add-selector-under-plugin-discovery-zh.png | Bin 0 -> 286967 bytes
.../plugin/discovery/add-selector-zh.png | Bin 0 -> 353928 bytes
.../plugin/discovery/after-import-zh.png | Bin 0 -> 454213 bytes
.../config-discovery-plugin-modal-zh.png | Bin 0 -> 345544 bytes
.../discovery/config-discovery-plugin-zh.png | Bin 0 -> 225243 bytes
.../plugin/discovery/config-import-zh.png | Bin 0 -> 511390 bytes
.../plugin/discovery/edit-zk-upstream-zh.png | Bin 0 -> 501713 bytes
.../plugin/discovery/etcd-selector-zh.png | Bin 0 -> 474059 bytes
.../plugin/discovery/eureka-selector-zh.png | Bin 0 -> 483631 bytes
.../plugin/discovery/local-selector-zh.png | Bin 0 -> 377368 bytes
.../plugin/discovery/nacos-selector-zh.png | Bin 0 -> 473927 bytes
.../img/shenyu/plugin/discovery/rule-en.png | Bin 0 -> 435865 bytes
.../img/shenyu/plugin/discovery/rule-zh.png | Bin 0 -> 470020 bytes
.../plugin/discovery/ws-selector-zh.png | Bin 0 -> 318801 bytes
.../plugin/discovery/zk-selector-zh.png | Bin 0 -> 491817 bytes
19 files changed, 345 insertions(+), 362 deletions(-)
create mode 100644 static/img/shenyu/plugin/discovery/add-selector-basic-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/add-selector-local-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/add-selector-under-plugin-discovery-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/add-selector-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/after-import-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/config-discovery-plugin-modal-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/config-discovery-plugin-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/config-import-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/edit-zk-upstream-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/etcd-selector-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/eureka-selector-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/local-selector-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/nacos-selector-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/rule-en.png
create mode 100644 static/img/shenyu/plugin/discovery/rule-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/ws-selector-zh.png
create mode 100644 static/img/shenyu/plugin/discovery/zk-selector-zh.png
diff --git a/docs/user-guide/discovery/discovery-mode.md b/docs/user-guide/discovery/discovery-mode.md
index 9064cac76a9..89085c19bc5 100644
--- a/docs/user-guide/discovery/discovery-mode.md
+++ b/docs/user-guide/discovery/discovery-mode.md
@@ -1,190 +1,157 @@
---
-title: Discovery
+title: Discovery模块
keywords: [ "Discovery" ]
-description: Discovery Modules
+description: Discovery模块
---
-# 1. Overview
+# 1. 概述
-## 1.1 Module Name
+## 1.1 模块名称
Discovery
-## 1.2 Design
+## 1.2 设计
-Design drawing
+设计图
-DataBase Design
+数据库设计
-## 1.3 Notes
+## 1.3 说明
+Discovery 模块赋予了 ShenYu 网关一种主动感知和响应被代理服务列表变化的能力。
+通过 Discovery 网关 admin 服务的主动监听，ShenYu 网关能够及时掌握被代理服务的变动情况。
+这一功能的设计具有灵活性，可以根据需要在**选择器级别**或**插件级别**进行配置。
+目前，已经引入了 Discovery 功能的插件包括 TCP 插件、Divide 插件、Websocket 插件和 gRPC 插件。
-The 'Discovery' gateway admin service actively listens to register to the gateway service. The shenyu gateway has the ability to actively discover the changes of the proxy service list
-'Discovery' can be at the selector level or the plugin level.
-The 'Discovery' plugin is currently introduced as a TCP ,Divide,Websocket,Grpc Plugin.
-### 1.3.1 Listener mode
+### 1.3.1 监听模式
-LOCAL , ZOOKEEPER , NACOS(To be supported) , ERURKA(To be supported) ....
+LOCAL, ZOOKEEPER, NACOS, EUREKA, ETCD
-LOCAL mode: relies heavily on manually maintaining the upstream list to push to the gateway
+- LOCAL 模式: 主要依靠手动维护 upstream 列表，并推送到网关；
+- ZOOKEEPER 模式: 监听 ZooKeeper 中指定节点下临时节点的变化来获取数据；
+- NACOS 模式：监听 Nacos 中指定服务名称下实例的变化来获取数据；
+- EUREKA 模式： 监听 Eureka 中指定服务名称下实例的变化来获取数据；
+- ETCD 模式：通过监听 etcd 中指定节点键值对的变化来获取数据。
-ZOOKEEPER mode: Listen for temporary node changes in the specified node in zk for data
-### 1.3.2 Scope of action
+### 1.3.2 作用范围
-Plugin-level: THIS APPLIES TO THE entire PLUGIN. All CHOICES MADE BY the PLUGIN will default to the current listening mode
-Selector level: This applies to the current selector. There are different selectors that use different listening modes under the current plugin
+- 插件级别：影响整个插件，所有该插件下的选择器都将默认采用当前的监听模式；
+- 选择器级别：适用于当前选择器，对于当前插件下的不同选择器，可以使用不同的监听模式。
-# 2. How to use
+# 2. 使用
-## 2.1 Plug-in level Configuration
+## 2.1 插件级别配置
-1. In the plugin that supports the Discovery module click 'Discovery configuration' to select the listening mode for the response
- Take Zookeeper as an example
+### 2.1.1 服务发现配置
- 
+- 在支持 Discovery 模块的插件中（当前只有 TCP 插件支持在admin控制台页面，进行插件级别 discovery 配置，其他插件见。。。）， 点击 `服务发现配置`， 在弹出的表单中，选择需要的监听模式，
+ 并填写服务发现名称、注册服务器URL、注册中心配置参数等：
-2. In the selector, click 'Add' on the new selector page and click 'DiscoveryConfig' to find the Type type to force the plugin-level listener that you just configured
- In this case, we need to listen to the 'ListenerNode' : /shenyu/discovery as an example
- 
+
- Note: In this Handler configuration, shenyu specifies that the upstream registration data is sent in the following json form
+
- ```json
- {
- "url": "127.0.0.1::6379", // upstream's url
- "protocol": "tcp", // upstream's protocol
- "status": 0, // upstream's (0, healthy, 1 unhealthy)
- "weight": 10 // Used when calculating load balancing
- }
- ```
-
- You can alias the handler if your service alias is different from the json format defined by shenyu
- In the above image, I need to change the status to healthy. The other is to save the original json-key form
-
-3. See plugin for details on how to configure selector properties
-
-## 2.2 Selector level configuration
-
-Similar to plug-in level configuration. Combine the '1', '2' steps above
-
-
-Note: When using selector levels. It has to be reconfigured each time
-
-If you choose the LOCAL mode, you don't need to log into a registry and manually maintain the upstream list
+### 2.1.2 在选择器中使用
+- 点击 `添加选择器`，在新增选择器页面中，我们发现 `类型` 强制选择刚才配置的插件级监听模式，表示所添加的选择器也将采用相同的配置。
+ 此时，仅需输入需要监听的 `监听节点` ：
-
+ 
-# 3. Configuration
+- 这里的 `转换处理` 是指, ShenYu 规定的 upstream 注册数据是以下 JSON 格式传输
-## 3.1 Registration Information Configuration
-
-### 3.1.1 Basic Configuration
+ ```json
+ {
+ "url": "127.0.0.1::6379", // upstream 的 url
+ "protocol": "tcp", // upstream 的 通信协议
+ "status": 0, // upstream 节点的状态 (0, healthy, 1 unhealthy)
+ "weight": 10 // 计算负载均衡时使用
+ }
+ ```
-
+- 如果您的服务别名与ShenYu定义的JSON格式不匹配，您可以在 `转换处理` 中进行别名映射。
+ 例如，如上图所示，如果您需要将"status"改为"healthy"，而保留其他键不变，
+ 进行如下操作：起一个新的别名，将"status"映射为"healthy"，
+ 同时保留原有JSON键的形式。
-- Type registered Type [LOCAL | ZOOKEEPER]
-- ListenerNode registers listeners like '/shenyu/discovery'
-- Handler handles aliasing of upstream registration information
-- ServerList registry link url
+- 进行选择器剩余的属性的配置，详情见具体插件对应的文档。
+## 2.2 选择器级别配置
-### 3.1.2 Detailed explanation of data
+- 在支持 Discovery 模块的插件中，点击 `添加选择器`，在 `服务发现` 标签页中，
+ 配置类型、监听节点、服务器URL列表、注册中心参数等字段内容，配置内容仅对当前选择器有效，每次新增选择器需要重新配置。
-- The `upstream` registration data is :
+
-```json
-{
- "protocol": "tcp",
- "url": "127.0.0.1:6379",
- "status": 0,
- "weight": 1,
- "props": "{}"
-}
-```
+- 对于Divide、Grpc、Websocket插件，添加选择器页面有 `导入后台服务发现配置` 功能，
+ 指的是，如果在服务接入 ShenYu 网关时配置了 shenyu-discovery 相关的属性，可以选择导入并沿用后台的配置，如下图我们首先点击 `导入后台服务发现配置` 查看后台配置:
-- If the registered data format is different from the default json format, you can set an alias in the "Conversion process"：
+
-```json
-{
- "${yourProtocol}": "tcp",
- "${yourUrl}": "127.0.0.1:6379",
- "${yourStatus}": 1,
- "${yourWeight}": 1,
- "${yourProps}": "{}"
-}
-```
+- 如果确认导入，点击后台配置弹出框中的 `导入` 按钮后，后台的服务发现属性将会自动填充进表单，
+ 此时仅需要再配置监听节点：
-## 3.2 Configuration in different modes
+
-### 3.1 LOCAL
+> __注意__：如果确认导入后台配置，后台的服务发现属性将会自动填充进表单，并沿用之前的discovery对象，
+此时，在表单中修改服务发现属性将无效，依然保持后台配置。
-Only the selector level is supported in LOCAL mode
-No need to specify a link registry configuration just manually maintain the upstream list
+- 若选择了 LOCAL 模式，则无需接入注册中心, 用户需要手动维护 upstream 列表。
-
-### 3.2 ZOOKEEPER
+## 3.1 不同模式下的配置
-ZOOKEEPER mode supports both the plugin level and the selector level
+### 3.1 LOCAL模式
+- LOCAL模式只支持**选择器级别**的配置。无需接入注册中心, 用户需要手动维护 upstream 列表。这里的列表是一个可编辑表格，
+ 点击表格每行的 `编辑` 按钮，可以对 upstream 的每个参数进行修改：
-SEE `shenyu-discovery-zookeeper#ZookeeperDiscoveryService#init`
+
-```json
-{
- "baseSleepTimeMilliseconds": "1000",
- "maxRetries": "3",
- "maxSleepTimeMilliseconds": "1000",
- "connectionTimeoutMilliseconds": "1000",
- "sessionTimeoutMilliseconds": "1000",
- "namespace": "",
- "digest": null
-}
-```
+### 3.2 ZooKeeper/Nacos/Eureka/Etcd模式
-- You can search for the dictionary name as "zookeeper" in `shenyu-admin` --> BasicConfig --> Dictionary,
- and modify the dictionary value corresponding to the default properties
- ( __Note__: The dictionary type and dictionary name cannot be modified)：
+- ZooKeeper/Nacos/Eureka/Etcd模式下，支持插件级别和选择器级别的服务发现配置。
+- 针对每个模式下的注册中心属性，以zookeeper为例，用户可以在`shenyu-admin` --> 基础配置 --> 字典管理 中，搜索字典名称为“zookeeper”，对默认属性对应的字典值进行修改编辑
+ （__注意__：不可修改字典类型和字典名称）。
+- 这些模式下，网关会动态地从注册中心获取服务实例信息，服务实例的新增、下线、修改等，将会实时显示在 upstrea 列表中。
-# 4.Using with Shenyu-client
-
+# 4.配合 Shenyu-client 使用
-## 4.1 Overview
+## 4.1 概括
-To use with shenyu-client, you need to depend on middleware such as zookeeper, nacos, etcd, eureka for automatic sensing of online and offline status.
-For local mode, you need to manually maintain the upstream list.
+配合shenyu-client使用 需要依赖
+使用中间件 zookeeper, nacos , etcd, eureka 模式 依赖admin 自动感知上下线
+使用local模式 需要 手动维护 upstream列表
-## 4.2 Examples
+## 4.2 示例
-For details on using shenyu-client, see the shenyu-client module.
+shenyu-client 使用详情见 shenyu-client 模块
+### 4.2.1 Local示例
-### 4.2.1 Local Example
+Local模式 不需要配置注册中心
-Local mode does not require configuration of the registry.
-
-1.If you choose to use shenyu-client to automatically register in Local mode and register the current list:
+1.如果选择使用shenyu-client自动注册为Local模式并且把当前列表注册上去
-2. If you do not use shenyu-client, you can configure it manually:
+2. 如果不使用shenyu-client 你可以自己手动配置
-Manually configure Selector
+手动自行添加
-Manually configure Rule
+手动配置Rule
-Test connection:
+测试连接
```text
curl http://localhost:9195/http/hello
@@ -192,23 +159,23 @@ curl http://localhost:9195/http/hello
hello! I'm Shenyu-Gateway System. Welcome!%
```
+### 4.2.2 Zookeeper示例
-### 4.2.2 Zookeeper Example
-
-Take Divide as an example.
+以 Divide为例
-Add dependencies:
+添加依赖
```xml
+
- org.apache.shenyu
- shenyu-discovery-zookeeper
- ${project.version}
+ org.apache.shenyu
+ shenyu-discovery-zookeeper
+ ${project.version}
- org.apache.shenyu
- shenyu-spring-boot-starter-client-http
+org.apache.shenyu
+shenyu-spring-boot-starter-client-http
```
@@ -227,14 +194,14 @@ shenyu:
sessionTimeoutMilliseconds: 8
```
-Start the shenyu-examples-http project.
+启动项目 shenyu-examples-http
-The above indicates successful registration.
+上述说明组册成功
-Test connection:
+测试连接
```text
curl http://localhost:9195/http/hello
@@ -242,41 +209,42 @@ curl http://localhost:9195/http/hello
hello! I'm Shenyu-Gateway System. Welcome!%
```
-### 4.2.3 Etcd Example
+### 4.2.3 Etcd示例
-Add dependencies:
+添加依赖
```xml
+
- org.apache.shenyu
- shenyu-discovery-etcd
- ${project.version}
+ org.apache.shenyu
+ shenyu-discovery-etcd
+ ${project.version}
- org.apache.shenyu
- shenyu-spring-boot-starter-client-http
+org.apache.shenyu
+shenyu-spring-boot-starter-client-http
```
```yaml
shenyu:
- discovery:
- enable: true
- type: etcd
- serverList: http://${your.etcd.host}:${your.etcd.port}
- registerPath: shenyu_discovery_demo_http_common
- props:
- etcdTimeout: 3000
- etcdTTL: 5
+ discovery:
+ enable: true
+ type: etcd
+ serverList: http://${your.etcd.host}:${your.etcd.port}
+ registerPath: shenyu_discovery_demo_http_common
+ props:
+ etcdTimeout: 3000
+ etcdTTL: 5
```
-Start shenyu-examples-http.
+启动shenyu-examples-http
-The above indicates successful registration.
+上述说明组册成功
-Test connection:
+测试连接
```text
curl http://localhost:9195/http/hello
@@ -284,39 +252,40 @@ curl http://localhost:9195/http/hello
hello! I'm Shenyu-Gateway System. Welcome!%
```
-### 4.2.4 Eureka Example
+### 4.2.4 Eureka示例
-Add dependencies:
+添加依赖
```xml
+
- org.apache.shenyu
- shenyu-discovery-eureka
- ${project.version}
+ org.apache.shenyu
+ shenyu-discovery-eureka
+ ${project.version}
- org.apache.shenyu
- shenyu-spring-boot-starter-client-http
+org.apache.shenyu
+shenyu-spring-boot-starter-client-http
```
```yaml
shenyu:
- discovery:
- enable: true
- type: eureka
- serverList: http://${your.eureka.host}:${your.eureka.port}/eureka
- registerPath: shenyu_discovery_demo_http_common
- props:
- eurekaClientRefreshInterval: 10
- eurekaClientRegistryFetchIntervalSeconds: 10
+ discovery:
+ enable: true
+ type: eureka
+ serverList: http://${your.eureka.host}:${your.eureka.port}/eureka
+ registerPath: shenyu_discovery_demo_http_common
+ props:
+ eurekaClientRefreshInterval: 10
+ eurekaClientRegistryFetchIntervalSeconds: 10
```
-The above indicates successful registration.
+上述说明组册成功
-The above indicates successful registration.
+测试连接
```text
curl http://localhost:9195/http/hello
@@ -324,25 +293,26 @@ curl http://localhost:9195/http/hello
hello! I'm Shenyu-Gateway System. Welcome!%
```
-### 4.2.4 Nacos Example
+### 4.2.4 Nacos示例
```xml
+
- org.apache.shenyu
- shenyu-discovery-nacos
- ${project.version}
+ org.apache.shenyu
+ shenyu-discovery-nacos
+ ${project.version}
- org.apache.shenyu
- shenyu-spring-boot-starter-client-http
+org.apache.shenyu
+shenyu-spring-boot-starter-client-http
```
-The above indicates successful registration.
+上述说明组册成功
-The above indicates successful registration.
+测试连接
```text
curl http://localhost:9195/http/hello
@@ -350,16 +320,18 @@ curl http://localhost:9195/http/hello
hello! I'm Shenyu-Gateway System. Welcome!%
```
+## 4.3 修改权重和状态
-## 4.3 Changing Weight and Status
+status : 0 健康 , 1 不健康
-status : 0 Healthy , 1 Unhealthy
-
-weight : Weight. For details, see the weight algorithm in the shenyu-loadbalancer module.
+weight : 权重 详情见 权重算法 shenyu-loadbalancer 模块
-## 4.4 Test report
+## 4.4 测试报告
+
+[测试报告](https://www.yuque.com/eureca/pgotw1/hkqkk5laubspgwl3#UojLR)
+
+
-[Test Report](https://www.yuque.com/eureca/pgotw1/hkqkk5laubspgwl3#UojLR)
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/user-guide/discovery/discovery-mode.md b/i18n/zh/docusaurus-plugin-content-docs/current/user-guide/discovery/discovery-mode.md
index 735c2b71436..0d1a29fe742 100644
--- a/i18n/zh/docusaurus-plugin-content-docs/current/user-guide/discovery/discovery-mode.md
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/user-guide/discovery/discovery-mode.md
@@ -1,183 +1,165 @@
---
-title: Discovery模块
+title: 服务发现模块
keywords: [ "Discovery" ]
-description: Discovery模块
+description: 服务发现模块模块
---
-# 1. 概述
+# 服务发现模块
-## 1.1 模块名称
+## 1. 概述
+
+### 1.1 模块名称
Discovery
-## 1.2 设计
+### 1.2 设计
-设计图
+- 模块设计图
-数据库设计
+
+
+- 数据库设计
+
-## 1.3 说明
-`Discovery`网关admin服务主动监听 注册到网管服务. 使得shenyu网关具备主动发现被代理服务列表的变化
-`Discovery` 可以针对 选择器级别, 也可以针对 插件级别.
-目前 引入 `Discovery` 插件为 TCP 插件.
+### 1.3 模块功能
+
+Discovery 模块赋予了 ShenYu 网关一种主动感知和响应被代理服务列表变化的能力。
+通过 Discovery 网关 admin 服务的主动监听，ShenYu 网关能够及时掌握被代理服务的变动情况。
+这一功能的设计具有灵活性，可以根据需要在**选择器级别**或**插件级别**进行配置。
+目前，已经引入了 Discovery 功能的插件包括 TCP 插件、Divide 插件、Websocket 插件和 gRPC 插件。
+
+
+### 1.4 监听模式
+
+LOCAL, ZOOKEEPER, NACOS, EUREKA, ETCD
+
+- LOCAL 模式: 主要依靠手动维护 upstream 列表，并推送到网关；
+- ZOOKEEPER 模式: 监听 ZooKeeper 中指定节点下临时节点的变化来获取数据；
+- NACOS 模式：监听 Nacos 中指定服务名称下实例的变化来获取数据；
+- EUREKA 模式： 监听 Eureka 中指定服务名称下实例的变化来获取数据；
+- ETCD 模式：通过监听 etcd 中指定节点键值对的变化来获取数据。
-### 1.3.1 监听模式
-LOCAL , ZOOKEEPER , NACOS , ERURKA , ETCD
+### 1.5 作用范围
-LOCAL 模式 : 主要依靠手动维护 upstream 列表 推送到网管
+- 插件级别：影响整个插件，所有该插件下的选择器都将默认采用当前的监听模式；
+- 选择器级别：适用于当前选择器，对于当前插件下的不同选择器，可以使用不同的监听模式。
-ZOOKEEPER 模式 : 监听 zk 下指定节点下的 临时节点变化来获取数据
+## 2. 使用
-### 1.3.2 作用范围
+### 2.1 插件级别配置
-插件级: 作用于整个插件,该插件下所以的选择都会默认使用当前监听模式
-选择器级别: 作用于当前选择器,当前插件下有不同选择器使用不同的监听模式
+#### 2.1.1 服务发现配置
-# 2. 使用
+- 在支持 Discovery 模块的插件中（当前只有 TCP 插件支持在admin控制台页面，进行插件级别 discovery 配置，其他插件可以通过 shenyu-client 进行插件级别 discovery 配置，见下文中的“配合Shenyu-client使用”）， 点击 `服务发现配置`， 在弹出的表单中，选择需要的监听模式，
+ 并填写服务发现名称、注册服务器URL、注册中心配置参数等：
-## 2.1 插件级别配置
-1. 在支持Discovery模块的插件中 点击 `Discovery configuration` 选择响应的监听模式
- 下图以`Zookeeper`为例
+
- 
+
-2. 在选择器中使用 点击 `Add` 在新增选择器页面点击 `DiscoveryConfig` 发现Type 类型强制选择刚才配置的插件级监听模块
- 此时 收入需要监听的 `ListenerNode` 我们以 : /shenyu/discovery 为例
+#### 2.1.2 在选择器中使用
+- 点击 `添加选择器`，在新增选择器页面中，我们发现 `类型` 强制选择刚才配置的插件级监听模式，表示所添加的选择器也将采用相同的配置。
+ 此时，仅需输入需要监听的 `监听节点` ：
- 
+ 
- 注意: 这里的 Handler 配置, shenyu 规定的upstream 注册数据是以下 json 形式发送
+- 这里的 `转换处理` 是指, ShenYu 规定的 upstream 注册数据是以下 JSON 格式传输
```json
{
"url": "127.0.0.1::6379", // upstream 的 url
- "protocol": "tcp", // upstream 的 通信协议
- "status": 0, // upstream 节点的状态 (0, healthy, 1 unhealthy)
- "weight": 10 // 计算负载均衡时使用
+ "protocol": "tcp", // upstream 的 通信协议
+ "status": 0, // upstream 节点的状态 (0, healthy, 1 unhealthy)
+ "weight": 10 // 计算负载均衡时使用
}
```
- 如果 你的服务 别名和shenyu 定义的 json 格式不同时候 可以在 handler 起别名
- 如上图 我需要吧status 改为 healthy. 其他为改 保存 原有 json-key 的形式
+- 如果您的服务别名与ShenYu定义的JSON格式不匹配，您可以在 `转换处理` 中进行别名映射。
+ 例如，如上图所示，如果您需要将"status"改为"healthy"，而保留其他键不变，
+ 进行如下操作：起一个新的别名，将"status"映射为"healthy"，
+ 同时保留原有JSON键的形式。
+- 进行选择器剩余的属性的配置，详情见具体插件对应的文档。
-3. 进行后续selector属性配置 详情见具体plugin
+### 2.2 选择器级别配置
-## 2.2 选择器级别配置
+- 在支持 Discovery 模块的插件中，点击 `添加选择器`，在 `服务发现` 标签页中，
+ 配置类型、监听节点、服务器URL列表、注册中心参数等字段内容，配置内容仅对当前选择器有效，每次新增选择器需要重新配置。
-类似于插件级别配置. 把 上述的 `1`,`2` 步骤合并在一起
-
+
-注意: 使用选择器级别时候. 每次都必须重新配置
+- 对于Divide、gRPC、Websocket插件，添加选择器页面有 `导入后台服务发现配置` 功能，
+ 指的是，如果服务接入 ShenYu 网关时配置了 shenyu-discovery 相关的属性（见配合shenyu-client使用），可以选择导入并沿用后台的配置，如下图我们首先点击 `导入后台服务发现配置` 查看后台配置:
-若选择了 LOCAL 模式 则无需接入注册中心, 手动维护upstream列表
+
-
+- 如果确认导入，点击后台配置弹出框中的 `导入` 按钮后，后台的服务发现属性将会自动填充进表单，
+ 此时仅需要再配置监听节点：
-# 3. 配置
+
-## 3.1 注册信息配置
+> __注意__：如果确认导入后台配置，后台的服务发现属性将会自动填充进表单，并沿用之前的discovery对象，
+此时，在表单中修改服务发现属性将无效，依然保持后台配置。
-### 3.1.1 基本配置
+- 若选择了 LOCAL 模式，则无需接入注册中心，用户需要手动维护 upstream 列表。
-
-- Type 注册类型 [LOCAL|ZOOKEEPER]
-- ListenerNode 注册的监听节点 如`/shenyu/discovery`
-- Handler 处理 upstream 注册信息的别名问题
-- ServerList 注册中心链接url
+## 3. 不同模式下的配置
-### 3.1.2 数据详解
+### 3.1 local模式
-- upstream 注册数据为:
+- local模式只支持**选择器级别**的配置。无需接入注册中心，用户需要手动维护 upstream 列表。这里的列表是一个可编辑表格，
+ 点击表格每行的 `编辑` 按钮，可以对 upstream 的每个参数进行修改：
-```json
-{
- "protocol": "tcp",
- "url": "127.0.0.1:6379",
- "status": 0,
- "weight": 1,
- "props": "{}"
-}
-```
-
-- 若注册的数据与默认的json格式不同时，可以在“转换处理”中设置别名：
-
-```json
-{
- "${yourProtocol}": "tcp",
- "${yourUrl}": "127.0.0.1:6379",
- "${yourStatus}": 1,
- "${yourWeight}": 1,
- "${yourProps}": "{}"
-}
-```
-
-## 3.2 不同模式下的配置
+
-### 3.1 LOCAL
+### 3.2 ZooKeeper/Nacos/Eureka/Etcd模式
-LOCAL模式下 只支持 选择器级别
-无需指定链接 注册中心配置 只需手动维护 upstream 列表
-
+- ZooKeeper/Nacos/Eureka/Etcd模式下，支持插件级别和选择器级别的服务发现配置。
+- 针对每个模式下的注册中心属性，以zookeeper为例，用户可以在`shenyu-admin` --> 基础配置 --> 字典管理 中，搜索字典名称为“zookeeper”，对默认属性对应的字典值进行修改编辑
+ （__注意__：不可修改字典类型和字典名称）。
+- 这些模式下，网关会动态地从注册中心获取服务实例信息，服务实例的新增、下线、修改等，将会实时显示在 upstream 列表中。
-### 3.2 ZOOKEEPER
-ZOOKEEPER模式下 支持 插件级别 和 选择器级别
-
-详情见 `shenyu-discovery-zookeeper#ZookeeperDiscoveryService#init`
+
-```json
-{
- "baseSleepTimeMilliseconds": "1000",
- "maxRetries": "3",
- "maxSleepTimeMilliseconds": "1000",
- "connectionTimeoutMilliseconds": "1000",
- "sessionTimeoutMilliseconds": "1000",
- "namespace": "",
- "digest": null
-}
-```
+## 4. 配合 Shenyu-client 使用
-- 用户可以在`shenyu-admin` --> 基础配置 --> 字典管理 中，搜索字典名称为“zookeeper”，对默认属性对应的字典值进行修改编辑
- （__注意__：不可修改字典类型和字典名称）：
+### 4.1 介绍
-
+- 与 shenyu-client 配合使用需要依赖对应模式的注册中心中间件：zookeeper，nacos，etcd，eureka，这些模式可以通过Shenyu Admin实现自动感知服务的上线和下线。
+- 另外，如果您使用了 local 模式，则需要手动维护upstream列表。
+- shenyu-client 使用详见 shenyu-client 模块。
-# 4.配合 Shenyu-client 使用
+### 4.2 Local 模式示例
-## 4.1 概括
+#### 4.2.1 使用shenyu-client
-配合shenyu-client使用 需要依赖
-使用中间件 zookeeper, nacos , etcd, eureka 模式 依赖admin 自动感知上下线
-使用local模式 需要 手动维护 upstream列表
+- shenyu-client 默认为 Local模式，无需进行特殊的 discovery 配置，便可以自动把当前服务注册上去；
+- 对于自动注册上来的服务，可以手动在页面的upstream列表进行添加、修改和删除：
-## 4.2 示例
+
-shenyu-client 使用详情见 shenyu-client 模块
+#### 4.2.2 不使用shenyu-client
-### 4.2.1 Local示例
-Local模式 不需要配置注册中心
+- 如果不使用shenyu-client，也可以手动在 `添加选择器` 的 `服务发现` 标签页上添加、修改、删除服务信息：
-1.如果选择使用shenyu-client自动注册为Local模式并且把当前列表注册上去
+
-
+- 配置选择器其他信息：
-2. 如果不使用shenyu-client 你可以自己手动配置
+
-
+- 配置规则：
-手动自行添加
-
-手动配置Rule
-
+
-测试连接
+- 测试连接
```text
curl http://localhost:9195/http/hello
@@ -185,18 +167,16 @@ curl http://localhost:9195/http/hello
hello! I'm Shenyu-Gateway System. Welcome!%
```
-### 4.2.2 Zookeeper示例
+### 4.2 Zookeeper模式示例
-以 Divide为例
-
-添加依赖
+（以 Divide 插件为例）
+- 添加依赖
```xml
-
- org.apache.shenyu
- shenyu-discovery-zookeeper
- ${project.version}
+ org.apache.shenyu
+ shenyu-discovery-zookeeper
+ ${project.version}
@@ -205,29 +185,32 @@ hello! I'm Shenyu-Gateway System. Welcome!%
```
+- application.yml 中添加如下配置
+
```yaml
shenyu:
- discovery:
- enable: true
- type: zookeeper
- serverList: ${your.zookeeper.ip}:{your.zookeeper.port}
- registerPath: /shenyu/discovery/demo_http_common
- props:
- baseSleepTimeMilliseconds: 1000
- maxRetries: 4
- maxSleepTimeMilliseconds: 5000
- connectionTimeoutMilliseconds: 60000
- sessionTimeoutMilliseconds: 8
+ discovery:
+ enable: true
+ type: zookeeper
+ serverList: ${your.zookeeper.ip}:{your.zookeeper.port}
+ registerPath: /shenyu/discovery/demo_http_common
+ props:
+ baseSleepTimeMilliseconds: 1000
+ maxRetries: 4
+ maxSleepTimeMilliseconds: 5000
+ connectionTimeoutMilliseconds: 60000
+ sessionTimeoutMilliseconds: 8
```
+- 启动服务 shenyu-examples-http
+- 服务注册成功，在选择器页面可以看到自动注册上来的服务实例列表：
-启动项目 shenyu-examples-http
+
-上述说明组册成功
-
+- 用户可以点击服务实例列表中的 `编辑`，对服务实例信息进行编辑（非Local模式下，URL由注册中心维护，不可手动编辑）：
-
+
-测试连接
+- 测试连接
```text
curl http://localhost:9195/http/hello
@@ -235,16 +218,15 @@ curl http://localhost:9195/http/hello
hello! I'm Shenyu-Gateway System. Welcome!%
```
-### 4.2.3 Etcd示例
+### 4.3 Etcd示例
-添加依赖
+- 添加依赖
```xml
-
- org.apache.shenyu
- shenyu-discovery-etcd
- ${project.version}
+ org.apache.shenyu
+ shenyu-discovery-etcd
+ ${project.version}
@@ -253,24 +235,26 @@ hello! I'm Shenyu-Gateway System. Welcome!%
```
+- application.yml 中添加如下配置
+
```yaml
shenyu:
- discovery:
- enable: true
- type: etcd
- serverList: http://${your.etcd.host}:${your.etcd.port}
- registerPath: shenyu_discovery_demo_http_common
- props:
- etcdTimeout: 3000
- etcdTTL: 5
+ discovery:
+ enable: true
+ protocol: http://
+ type: etcd
+ serverList: http://${your.etcd.host}:${your.etcd.port}
+ registerPath: /shenyu/test/http_common
+ props:
+ etcdTimeout: 3000
+ etcdTTL: 5
```
-启动shenyu-examples-http
+- 启动服务 shenyu-examples-http，同样地，在选择器页面可以看到自动注册上来的服务实例列表，并可进行编辑：
-上述说明组册成功
-
+
-测试连接
+- 测试连接
```text
curl http://localhost:9195/http/hello
@@ -278,16 +262,15 @@ curl http://localhost:9195/http/hello
hello! I'm Shenyu-Gateway System. Welcome!%
```
-### 4.2.4 Eureka示例
+### 4.4 Eureka示例
-添加依赖
+- 添加依赖
```xml
-
- org.apache.shenyu
- shenyu-discovery-eureka
- ${project.version}
+ org.apache.shenyu
+ shenyu-discovery-eureka
+ ${project.version}
@@ -295,23 +278,26 @@ hello! I'm Shenyu-Gateway System. Welcome!%
shenyu-spring-boot-starter-client-http
```
+- application.yml 中添加如下配置（此处的 `registerPath` 可以理解为需要监听的服务的名称）
```yaml
shenyu:
- discovery:
- enable: true
- type: eureka
- serverList: http://${your.eureka.host}:${your.eureka.port}/eureka
- registerPath: shenyu_discovery_demo_http_common
- props:
- eurekaClientRefreshInterval: 10
- eurekaClientRegistryFetchIntervalSeconds: 10
+ discovery:
+ enable: true
+ protocol: http://
+ type: eureka
+ serverList: http://${your.eureka.host}:${your.eureka.port}/eureka
+ registerPath: shenyu_discovery_demo_http_common
+ props:
+ eurekaClientRefreshInterval: 10
+ eurekaClientRegistryFetchIntervalSeconds: 10
```
-上述说明组册成功
-
+- 启动服务 shenyu-examples-http，同样地，在选择器页面可以看到自动注册上来的服务实例列表，并可进行编辑：
+
+
-测试连接
+- 测试连接
```text
curl http://localhost:9195/http/hello
@@ -319,14 +305,13 @@ curl http://localhost:9195/http/hello
hello! I'm Shenyu-Gateway System. Welcome!%
```
-### 4.2.4 Nacos示例
+### 4.5 Nacos示例
```xml
-
- org.apache.shenyu
- shenyu-discovery-nacos
- ${project.version}
+ org.apache.shenyu
+ shenyu-discovery-nacos
+ ${project.version}
@@ -334,11 +319,25 @@ hello! I'm Shenyu-Gateway System. Welcome!%
shenyu-spring-boot-starter-client-http
```
+- application.yml 中添加如下配置（此处的 `registerPath` 同样可以理解为需要监听的服务的名称）
-上述说明组册成功
-
+```yaml
+shenyu:
+ discovery:
+ enable: true
+ protocol: http://
+ type: nacos
+ serverList: ${your.nacos.host}:${your.nacos.port}
+ registerPath: shenyu_discovery_demo_http_common
+ props:
+ groupName: SHENYU_GROUP
+```
+
+- 启动服务 shenyu-examples-http，同样地，在选择器页面可以看到自动注册上来的服务实例列表，并可进行编辑：
+
+
-测试连接
+- 测试连接
```text
curl http://localhost:9195/http/hello
@@ -346,15 +345,27 @@ curl http://localhost:9195/http/hello
hello! I'm Shenyu-Gateway System. Welcome!%
```
-## 4.3 修改权重和状态
+> __注意__：通过shenyu-client配置服务发现，本质上是配置插件级别的服务发现，同一种服务发现模式下，
+实际上只有一个discovery对象（即：只能够配置同一套类型-服务器URL-服务发现参数），监听节点可以有多个。
+
+> __注意__：Divide插件和Grpc插件中，可以通过在application.yml文件中配置protocol来修改协议，Websocket
+插件的协议默认均为ws
+
+
+
+
+
+## 5. 注意事项
-status : 0 健康 , 1 不健康
+- local 模式下，可以在服务列表页面上手动对 upstream 的所有参数进行修改；
+- 非local模式下，可以对除URL、开始时间以外的参数进行手动修改；
+- 手动修改服务实例的状态（status：open/close），权重（weight），仅对当前插件生效；
+- 对于同一插件，后台通过shenyu-client配置discovery相关参数后，本质上是配置插件级别的服务发现，
+控制台页面上可以手动添加选择器以配置选择器级别的服务发现，但实际上只有一个discovery对象（即：只能够配置同一套类型-服务器URL-服务发现参数），监听节点可以有多个。
-weight : 权重 详情见 权重算法 shenyu-loadbalancer 模块
-
-## 4.4 测试报告
+## 6. 测试报告
[测试报告](https://www.yuque.com/eureca/pgotw1/hkqkk5laubspgwl3#UojLR)
diff --git a/static/img/shenyu/plugin/discovery/add-selector-basic-zh.png b/static/img/shenyu/plugin/discovery/add-selector-basic-zh.png
new file mode 100644
index 0000000000000000000000000000000000000000..dcc2367f2a9e8903af0575632d46bb58e0632a3d
GIT binary patch
literal 459722
zcmcG$1yoes_dkq?0wUdA(lLaRLw74kcZ0+b(j^KE4NA92i6Gq!Aw#Eh$AEMX-S42!
zFaGcQUF-im&sy(YGjlID&bepr{n`7o_c@EOm#T7@PspAiAt7NZ$V;muAz@%4Aw8->
zdyF_Uj#N#Hg!EM0R!Zunf|L}^OBaxpt-U1@l6+W#HmZ(B4^gK6r`Xt^$Y}EDP3Uwl
z-o@kSA#KW(;eJBO4ob#(y|eM;3hv`*RP(k5IJP2c@c!x`_!Dm!a=Tax_Lsatq#}eHACyLAK^pW3}q&
zlzpJ{c%~)EgCB_wR4UX{eLH<;9KmNyv-;p&yJY&0BsiQ_6bZ?w17GRM1Dam1K80X2
z!4Sd?MU!_pLrE*_3?-jdo-!=tlqp17OU)s_BTMK@uz2v8FMGPF9w2D_DTiOxT7#M5kn^|6GD;8m8}$)7!KlB#s=k8y^G<)!dm^N}+=I%GAr@yiby
zP(NI+!wWX9FTJXmdzPqp=T`GBXQbB!5S@o+*0zq4xxH2v&V0h&
zt+I3xNnM~v&Jb||qTI2ra2|&2L)NPb-_2Iv@~CM^)v71^Z2hWFwbxMXV9tbx(0Y@k
zM|4^v@1n(pgx;8N`bs#3y6jEy1~RiqCgD2uxI5j8Fk6VQ;)tHx%
z(Yuk6mvYS>%jPnBOCO{nh5yLHL4Wtw$sqQNHc~jvom;G?QHFT_ms)vlI$~g;0JZdc
zpeH~h5)ac`>2VA#{WaKwvlvJMqAG^p1`J`BEs_#he0d#d-%2m#+WLt^@+o5ozEs$0
z9qwMt)$*$YGPEML!S*K9wZr+$gP@IQ(32IW-IjqRa6xtjePiq^IF1X=^xpbM
zGAuHx53F#5yJTw1V$u&6R@kT4J6ShUrx#^W*VA}uF}q!ZW=!QrQ@F(sxXM;^=qJJ{
z6IOnVpXih~Jce|zA>=327I04PSpip8G<;*&VA#xj_2g09>Y`06Cyv@jw8{z$QuaD}
zG!hEjAukf>c*i&<(#7qUYu~0YjUDn(|7{P)L29IP%KiO)vFnTo0jyRd!1*Qh<=`|o
zY$6-0wO$ICk}KZ>gJV4KXLt@vvqDpb?OCF(uRH+;0?<%sX^`9BNyk3vgl<&Agp%GV
zn2;r7DoP0IAZxv^HhDPpwC01M3AGK9T&sf9V*`|=A8t;lC7GND$j9$JmU!ROJPQi>
zi7VCqv|N?~S34-|oSs&m052w&Zd0C!PST?LxdoPbG`rLUU0N)e1;7POFf3he=A(Z1
z!(4K&C|^nL`0%YSj9)Q@C@jCQKgUy%?#kBPkgg)hh~Sje&KciOt)dbMGm>x7nrt{bEfq%Qf$lnq7$d+wXmfVLkh
z{Y7**apTcq$7?ezXI5ugXG&-OLzME2^Ux_dx{ps4qMwPWKMhl2eU|WPBG&y=bX-Yn
zgFN-v*m(b#!MNo3$e8pShBt(7gvX)_4PW_uJ54E;sbRc|HShL?6Tr>jL@xLjc=Zw2
zDPL5|^Uh!4u?WUb$B)Mg_1g9t_L94~xna10P6XVtFWFDVw|vHi3dLUD$&Y6Xy__B^
ze@*I!>qdTpazb>186{hp{b*#wCb&wbifo2u#%~4{vmvDNvD}AJZjBuE9HW)+P9>F!
z{AxxeSBO=)Rq&esfKsZ6o&^UvM-7p-U5HlR1nqaM@1hP3r)aw*yS}@@Gs0Cvc4DKn
zn^PM>8wYM{TlN!zc}Jnq!yKFTLNTJ?=3xKSg*>IP>haZ$wT;B>y%C4e-SN?3*GZ*`
zv|{Z-kJqId)T6b->l^EvfQiL|0I9oCoH*KI+V`{=A!C^JJinTLy!;^kFi;}phvSFs
z$5~HFLufc`$=)rhocLfyi?@u{sYsHKO>*
zYst=1l2e0HLRBV`(|IKGf2xB3~#wILRmQlJS%9msnhav0@S#WeXNwx3Tyv?@FtG7~5Lt*XgG4;fD
z
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