This is an automated email from the ASF dual-hosted git repository.
liujun pushed a commit to branch refactor/next-2
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/refactor/next-2 by this push:
new c29f66cf03 update traffic management doc (#2231)
c29f66cf03 is described below
commit c29f66cf0351f3e35835d65b69d852068eb638bc
Author: Ken Liu <[email protected]>
AuthorDate: Tue Feb 14 16:09:27 2023 +0800
update traffic management doc (#2231)
---
.github/actions/always-upload-cache | 2 +-
.../overview/tasks/traffic-management/accesslog.md | 4 ++--
.../overview/tasks/traffic-management/arguments.md | 10 +++++-----
.../overview/tasks/traffic-management/host.md | 9 ++++++---
.../overview/tasks/traffic-management/isolation.md | 8 +++++---
.../overview/tasks/traffic-management/mock.md | 4 +++-
.../overview/tasks/traffic-management/region.md | 4 ++--
.../overview/tasks/traffic-management/retry.md | 11 ++++++++---
.../overview/tasks/traffic-management/timeout.md | 4 ++--
.../overview/tasks/traffic-management/weight.md | 4 ++--
static/imgs/v3/tasks/accesslog/accesslog_admin.png | Bin 0 -> 522698 bytes
static/imgs/v3/tasks/arguments/arguments_admin.png | Bin 0 -> 527944 bytes
static/imgs/v3/tasks/gray/gray3.png | Bin 0 -> 2503165 bytes
static/imgs/v3/tasks/gray/gray_admin.png | Bin 0 -> 712598 bytes
static/imgs/v3/tasks/host/host_admin.png | Bin 0 -> 510987 bytes
static/imgs/v3/tasks/mock/mock2.png | Bin 5089314 -> 521227
bytes
static/imgs/v3/tasks/mock/mock_admin.png | Bin 0 -> 532048 bytes
static/imgs/v3/tasks/region/region_admin.png | Bin 0 -> 796731 bytes
static/imgs/v3/tasks/retry/retry4.png | Bin 0 -> 630657 bytes
static/imgs/v3/tasks/retry/retry_admin.png | Bin 0 -> 799896 bytes
static/imgs/v3/tasks/timeout/timeout_admin.png | Bin 0 -> 209863 bytes
static/imgs/v3/tasks/weight/weight_admin.png | Bin 0 -> 856736 bytes
22 files changed, 36 insertions(+), 24 deletions(-)
diff --git a/.github/actions/always-upload-cache
b/.github/actions/always-upload-cache
index af4dd99ec5..ae40d8b5ae 160000
--- a/.github/actions/always-upload-cache
+++ b/.github/actions/always-upload-cache
@@ -1 +1 @@
-Subproject commit af4dd99ec5b9c91a41d9c7de3a6b2f372427fcc9
+Subproject commit ae40d8b5aef19835431042468b08b756288b87a8
diff --git a/content/zh-cn/overview/tasks/traffic-management/accesslog.md
b/content/zh-cn/overview/tasks/traffic-management/accesslog.md
index 466ef5094d..55740f4747 100644
--- a/content/zh-cn/overview/tasks/traffic-management/accesslog.md
+++ b/content/zh-cn/overview/tasks/traffic-management/accesslog.md
@@ -24,10 +24,10 @@ Dubbo 通过 `accesslog` 标记识别访问日志的开启状态，我们可以
#### 操作步骤
1. 打开 Dubbo Admin 控制台
-2. 在左侧导航栏选择【流量管控】>【访问日志】
+2. 在左侧导航栏选择【服务治理】>【动态配置】
3. 点击 "创建"，输入应用名 `shop-user` 并勾选 "开启访问日志"（此时访问日志将和普通日志打印在一起）。
-![Admin 访问日志设置截图]()
+
再次访问登录页面，登录到 `User` 应用的任意一台机器，可以看到如下格式的访问日志。
diff --git a/content/zh-cn/overview/tasks/traffic-management/arguments.md
b/content/zh-cn/overview/tasks/traffic-management/arguments.md
index 941adb0038..0fdf6d375a 100644
--- a/content/zh-cn/overview/tasks/traffic-management/arguments.md
+++ b/content/zh-cn/overview/tasks/traffic-management/arguments.md
@@ -44,7 +44,7 @@ public interface DetailService {
2. 在左侧导航栏选择【服务治理】 > 【参数路由】
3. 点击 "创建" 按钮，输入。
-![Admin 参数路由设置截图]()
+
方法参数的索引从 `0` 开始，我们上面填入 `1` 表示根据第二个参数进行流量转发。
@@ -61,18 +61,18 @@ force: false
enabled: true
priority: 1
conditions:
- - method=getItem & arguments[1]=dubbo => orderVersion=v2
+ - method=getItem & arguments[1]=dubbo => detailVersion=v2
```
* `method=getItem & arguments[1]=dubbo` 表示流量规则匹配 `getItem` 方法调用的第二个参数，当参数值为
`dubbo` 时做进一步的地址子集筛选。
-* `orderVersion=v2` 将过滤出所有带有 `orderVersion=v2` 标识的 URL 地址子集（在示例部署中，我们所有 detail
v2 的实例都已经打上了 `orderVersion=v2` 标签）。
+* `detailVersion=v2` 将过滤出所有带有 `detailVersion=v2` 标识的 URL 地址子集（在示例部署中，我们所有
detail v2 的实例都已经打上了 `detailVersion=v2` 标签）。
```yaml
conditions:
- - method=getItem & arguments[1]=dubbo => orderVersion=v2
+ - method=getItem & arguments[1]=dubbo => detailVersion=v2
```
-`force: false` 表示如果没有 `type=vip` 的地址，则随机访问所有可用地址。
+`force: false` 表示如果没有 `detailVersion=v2` 的地址，则随机访问所有可用地址。
## 其他事项
本示例只是 Dubbo 条件路由的一种使用场景，除了根据方法名、参数匹配进行流量转发，条件路由还可以根据附加参数 Attachments、URL
中的数据等进行流量转发，同时匹配条件也支持范围、通配符等，比如：
diff --git a/content/zh-cn/overview/tasks/traffic-management/host.md
b/content/zh-cn/overview/tasks/traffic-management/host.md
index 1f3ac5f2a0..bbba52a205 100644
--- a/content/zh-cn/overview/tasks/traffic-management/host.md
+++ b/content/zh-cn/overview/tasks/traffic-management/host.md
@@ -32,12 +32,15 @@ $ kubectl get pods -n dubbo-demo
#### 操作步骤
1. 打开 Dubbo Admin 控制台
-2. 在左侧导航栏选择【流量管控】>【指定机器导流】
+2. 在左侧导航栏选择【服务治理】>【条件路由】
3. 点击 "创建"，输入服务 `org.apache.dubbo.samples.UserService` 。
-![Admin 指定机器导流配置截图]()
+
-打开机器日志，刷新页面多触发机器用户详情服务调用，可以看到只有规则中指定实例中的日志在持续更新。
+打开机器日志，刷新页面多触发机器用户详情服务调用，可以看到只有规则中指定的实例中在持续刷新以下日志：
+```text
+Received getInfo request......
+```
#### 规则详解
diff --git a/content/zh-cn/overview/tasks/traffic-management/isolation.md
b/content/zh-cn/overview/tasks/traffic-management/isolation.md
index 19eaa3c5d0..efeab08983 100644
--- a/content/zh-cn/overview/tasks/traffic-management/isolation.md
+++ b/content/zh-cn/overview/tasks/traffic-management/isolation.md
@@ -37,10 +37,10 @@ kubectl apply -f
https://raw.githubusercontent.com/apache/dubbo-samples/master/1
#### 操作步骤
1. 打开 Dubbo Admin 控制台
-2. 在左侧导航栏选择【流量管控】>【流量隔离】
+2. 在左侧导航栏选择【服务治理】>【标签路由】
3. 点击 "创建"，输入 `shop-detail` 和流量隔离条件保存即可；重复为 `shop-comment`、`shop-order`
创建相同的隔离规则。
-![Admin 灰度隔离环境设置截图]()
+
以上规则为每个应用隔离出了一套独立的灰度环境，所有带有 `env=gray`
的标签都属于灰度环境。等待一小会确保规则下发完成，接下来就可以验证灰度流量在隔离环境中运行。
@@ -48,7 +48,9 @@ kubectl apply -f
https://raw.githubusercontent.com/apache/dubbo-samples/master/1
-通过 `Login To Gray` 登录后，之后所有请求 Detail、Comment、Order、User 服务的流量都会自动带有
`dubbo.tag=gray` 的标识，Dubbo 标签路由组件会识别这个标识，并将流量路由到刚才圈定的灰度环境（即所有 `env=gray` 的实例）。
+通过 `Login To Gray` 登录后，之后所有请求 Detail、Comment、Order、User 服务的流量都会自动带有
`dubbo.tag=gray` 的标识，Dubbo 标签路由组件会识别这个标识，并将流量路由到刚才圈定的灰度环境（即所有 `env=gray`
的实例）。系统运行效果如下：
+
+
#### 规则详解
diff --git a/content/zh-cn/overview/tasks/traffic-management/mock.md
b/content/zh-cn/overview/tasks/traffic-management/mock.md
index 7428a04238..3a25329ebb 100644
--- a/content/zh-cn/overview/tasks/traffic-management/mock.md
+++ b/content/zh-cn/overview/tasks/traffic-management/mock.md
@@ -34,12 +34,14 @@ description: ""
2. 在左侧导航栏选择【流量管控】>【服务降级】
3. 点击 "创建"，输入服务 `org.apache.dubbo.samples.CommentService` 和降级规则。
-![Admin 服务降级规则配置截图]()
+
等待降级规则推送完成之后，刷新商品详情页面，发现商品评论信息已经变为我们预先设置的 "Mock Comment"，因为商品详情页的 Comment
服务调用已经在本地短路，并没有真正的发送到后端服务提供者机器上。
+再次刷新页面
+
#### 规则详解
**规则 key** ：`org.apache.dubbo.samples.CommentService`
diff --git a/content/zh-cn/overview/tasks/traffic-management/region.md
b/content/zh-cn/overview/tasks/traffic-management/region.md
index 28790399b8..3f03c7a359 100644
--- a/content/zh-cn/overview/tasks/traffic-management/region.md
+++ b/content/zh-cn/overview/tasks/traffic-management/region.md
@@ -38,10 +38,10 @@ Detail 应用和 Comment 应用都有双区域部署，其中 Detail v1 与 Comm
#### 操作步骤
1. 登录 Dubbo Admin 控制台
-2. 在左侧导航栏选择【流量管控】 > 【同区域优先】。
+2. 在左侧导航栏选择【服务治理】 > 【条件路由】。
3. 点击 "创建" 按钮，填入要启用同区域优先的服务如 `org.apache.dubbo.samples.CommentService` 与
`区域标识` 如 `region` 即可。
-![Admin 同区域优先设置截图]()
+
同区域优先开启后，此时再尝试刷新商品详情页面，可以看到 description 与 comment 始终保持 v1 或 v2 的同步。
diff --git a/content/zh-cn/overview/tasks/traffic-management/retry.md
b/content/zh-cn/overview/tasks/traffic-management/retry.md
index 9846178dcf..a83ee3c0c9 100644
--- a/content/zh-cn/overview/tasks/traffic-management/retry.md
+++ b/content/zh-cn/overview/tasks/traffic-management/retry.md
@@ -18,10 +18,15 @@ description: ""
-但有些时候，提供用户详情的 Dubbo 服务也会由于网络不稳定等各种原因变的不稳定，比如我们提供用户详情的 User
服务就很大概率会调用失败，导致用户无法看到账户的详细信息。商城为了获得带来更好的使用体验，用户信息的加载过程是异步的，因此用户信息加载失败并不会影响对整个商城页面的正常访问，但如果能始终展示完整的用户信息总能给使用者留下更好的印象。
+但有些时候，提供用户详情的 Dubbo 服务也会由于网络不稳定等各种原因变的不稳定，比如我们提供用户详情的 User
服务就很大概率会调用失败，导致用户无法看到账户的详细信息。
+用户账户详情查询失败后的系统界面如下：
+
+
+
+商城为了获得带来更好的使用体验，用户信息的加载过程是异步的，因此用户信息加载失败并不会影响对整个商城页面的正常访问，但如果能始终展示完整的用户信息总能给使用者留下更好的印象。
### 增加重试提高成功率
考虑到访问用户详情的过程是异步的（隐藏在页面加载背后），只要最终数据能加载出来，适当的增加等待时间并不是大的问题。因此，我们可以考虑通过对每次用户访问增加重试次数的方式，提高服务详情服务的整体访问成功率。
@@ -30,10 +35,10 @@ description: ""
#### 操作步骤
1. 打开 Dubbo Admin 控制台
-2. 在左侧导航栏选择【流量管控】>【服务重试】
+2. 在左侧导航栏选择【服务治理】>【动态配置】
3. 点击 "创建"，输入服务 `org.apache.dubbo.samples.UserService` 和失败重试次数如 `4` 即可。
-![Admin 重试次数设置截图]()
+
保存后，尝试多次刷新页面，发现用户详情数据总是能正常显示，虽然有时由于重试的缘故加载时间会明显变长。
diff --git a/content/zh-cn/overview/tasks/traffic-management/timeout.md
b/content/zh-cn/overview/tasks/traffic-management/timeout.md
index 2f3795dc8a..afe7f5a4ea 100644
--- a/content/zh-cn/overview/tasks/traffic-management/timeout.md
+++ b/content/zh-cn/overview/tasks/traffic-management/timeout.md
@@ -34,10 +34,10 @@ Dubbo 提供动态调整服务超时时间的能力，在无需重启应用的
#### 操作步骤
1. 打开 Dubbo Admin 控制台
-2. 在左侧导航栏选择【流量管控】>【超时时间】
+2. 在左侧导航栏选择【服务治理】>【动态配置】
3. 点击 "创建"，输入服务 `org.apache.dubbo.samples.UserService` 和新的超时时间如 `2000` 即可。
-![Admin 超时时间设置截图]()
+
保存后，再次点击 `Timeout Login`，此时在经过短暂的等待后系统可以正常登录。
diff --git a/content/zh-cn/overview/tasks/traffic-management/weight.md
b/content/zh-cn/overview/tasks/traffic-management/weight.md
index 059e7e8841..58562bc228 100644
--- a/content/zh-cn/overview/tasks/traffic-management/weight.md
+++ b/content/zh-cn/overview/tasks/traffic-management/weight.md
@@ -35,10 +35,10 @@ Dubbo 提供了基于权重的负载均衡算法，可以实现按比例的流
#### 操作步骤
1. 打开 Dubbo Admin 控制台
-2. 在左侧导航栏选择【流量管控】>【权重比例】
+2. 在左侧导航栏选择【服务治理】>【动态配置】
3. 点击 "创建"，输入要调整的 `org.apache.dubbo.samples.OrderService` 、目标实例匹配条件和权重值。
-![Admin 权重比例设置截图]()
+
再次疯狂点击 "Buy Now" 尝试多次创建订单，现在大概只有 20% 的机会看到 v2 版本的订单详情信息
diff --git a/static/imgs/v3/tasks/accesslog/accesslog_admin.png
b/static/imgs/v3/tasks/accesslog/accesslog_admin.png
new file mode 100644
index 0000000000..309bc7789b
Binary files /dev/null and b/static/imgs/v3/tasks/accesslog/accesslog_admin.png
differ
diff --git a/static/imgs/v3/tasks/arguments/arguments_admin.png
b/static/imgs/v3/tasks/arguments/arguments_admin.png
new file mode 100644
index 0000000000..fc8e143f09
Binary files /dev/null and b/static/imgs/v3/tasks/arguments/arguments_admin.png
differ
diff --git a/static/imgs/v3/tasks/gray/gray3.png
b/static/imgs/v3/tasks/gray/gray3.png
new file mode 100644
index 0000000000..0194502c35
Binary files /dev/null and b/static/imgs/v3/tasks/gray/gray3.png differ
diff --git a/static/imgs/v3/tasks/gray/gray_admin.png
b/static/imgs/v3/tasks/gray/gray_admin.png
new file mode 100644
index 0000000000..30ae8e72cb
Binary files /dev/null and b/static/imgs/v3/tasks/gray/gray_admin.png differ
diff --git a/static/imgs/v3/tasks/host/host_admin.png
b/static/imgs/v3/tasks/host/host_admin.png
new file mode 100644
index 0000000000..0ee1451c84
Binary files /dev/null and b/static/imgs/v3/tasks/host/host_admin.png differ
diff --git a/static/imgs/v3/tasks/mock/mock2.png
b/static/imgs/v3/tasks/mock/mock2.png
index c9d8bc5280..6ed10817dd 100644
Binary files a/static/imgs/v3/tasks/mock/mock2.png and
b/static/imgs/v3/tasks/mock/mock2.png differ
diff --git a/static/imgs/v3/tasks/mock/mock_admin.png
b/static/imgs/v3/tasks/mock/mock_admin.png
new file mode 100644
index 0000000000..6fd034d88e
Binary files /dev/null and b/static/imgs/v3/tasks/mock/mock_admin.png differ
diff --git a/static/imgs/v3/tasks/region/region_admin.png
b/static/imgs/v3/tasks/region/region_admin.png
new file mode 100644
index 0000000000..bf5e8f374f
Binary files /dev/null and b/static/imgs/v3/tasks/region/region_admin.png differ
diff --git a/static/imgs/v3/tasks/retry/retry4.png
b/static/imgs/v3/tasks/retry/retry4.png
new file mode 100644
index 0000000000..1080e34960
Binary files /dev/null and b/static/imgs/v3/tasks/retry/retry4.png differ
diff --git a/static/imgs/v3/tasks/retry/retry_admin.png
b/static/imgs/v3/tasks/retry/retry_admin.png
new file mode 100644
index 0000000000..91bec7705e
Binary files /dev/null and b/static/imgs/v3/tasks/retry/retry_admin.png differ
diff --git a/static/imgs/v3/tasks/timeout/timeout_admin.png
b/static/imgs/v3/tasks/timeout/timeout_admin.png
new file mode 100644
index 0000000000..ad02849838
Binary files /dev/null and b/static/imgs/v3/tasks/timeout/timeout_admin.png
differ
diff --git a/static/imgs/v3/tasks/weight/weight_admin.png
b/static/imgs/v3/tasks/weight/weight_admin.png
new file mode 100644
index 0000000000..cf52a18ab5
Binary files /dev/null and b/static/imgs/v3/tasks/weight/weight_admin.png differ
