You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@dubbo.apache.org by li...@apache.org on 2023/05/09 02:43:56 UTC
[dubbo-website] branch master updated: Initializer announcement (#2582)
This is an automated email from the ASF dual-hosted git repository.
liujun 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 21b062fcdb Initializer announcement (#2582)
21b062fcdb is described below
commit 21b062fcdbb2def518dd1ce2d701855a6d2875ad
Author: Ken Liu <ke...@gmail.com>
AuthorDate: Tue May 9 10:43:48 2023 +0800
Initializer announcement (#2582)
---
cn_config.toml | 10 +-
config.toml | 10 +-
.../how-to-proxy-dubbo-in-apache-apisix.md | 3 +
.../how-to-proxy-dubbo-in-apache-shenyu.md | 2 +
.../integration/how-to-proxy-dubbo-in-higress.md} | 10 +-
content/zh-cn/blog/news/dubbo-introduction.md | 22 +-
.../zh-cn/blog/proposals/heuristic-flow-control.md | 219 ++++++-----
content/zh-cn/overview/core-features/ecosystem.md | 24 +-
.../zh-cn/overview/core-features/extensibility.md | 40 +-
.../zh-cn/overview/core-features/load-balance.md | 29 +-
content/zh-cn/overview/core-features/more.md | 6 +-
.../zh-cn/overview/core-features/observability.md | 5 +-
content/zh-cn/overview/core-features/protocols.md | 31 +-
content/zh-cn/overview/core-features/security.md | 2 -
.../overview/core-features/service-definition.md | 4 +-
.../overview/core-features/service-discovery.md | 11 +-
.../zh-cn/overview/core-features/service-mesh.md | 2 +
.../zh-cn/overview/core-features/traffic/_index.md | 2 +-
.../core-features/traffic/circuit-breaking.md | 41 +++
.../overview/core-features/traffic/mesh-rule.md | 9 -
content/zh-cn/overview/home/_index.md | 42 ++-
content/zh-cn/overview/mannual/_index.md | 18 +-
.../golang-sdk/preface/design/aop_and_extension.md | 5 -
content/zh-cn/overview/mannual/java-sdk/_index.md | 7 +-
.../observability/_index.md | 15 +-
.../observability/doc.md | 12 -
.../observability/health-information.md | 12 -
.../observability/kubernetes-probes.md | 12 -
.../observability/logging.md | 5 -
.../observability/meter.md | 323 ++++------------
.../observability/tracing.md | 28 ++
.../performance/adaptive-concurrency-control.md | 43 +++
.../performance/concurrency-control.md | 5 +-
.../performance/loadbalance.md | 83 +----
.../java-sdk/concepts-and-architecture/triple.md | 33 --
.../overview/mannual/java-sdk/quick-start/api.md | 2 +
.../mannual/java-sdk/quick-start/spring-boot.md | 6 +-
.../mannual/java-sdk/quick-start/spring-xml.md | 6 +-
.../architecture}/_index.md | 5 +-
.../architecture}/code-architecture.md | 1 +
.../architecture/mesh.md.bak} | 0
.../architecture/overall-architecture.md.bak} | 6 -
.../architecture/service-discovery.md.bak} | 0
.../architecture}/service-invocation.md | 15 +-
.../reference-manual/config-center/_index.md | 1 +
.../reference-manual/config-center/apollo.md | 6 +-
.../reference-manual/config-center/nacos.md | 6 +-
.../reference-manual/config-center/zookeeper.md | 5 +-
.../reference-manual/metadata-center/_index.md | 1 +
.../reference-manual/metadata-center/nacos.md | 1 +
.../reference-manual/metadata-center/overview.md | 2 +-
.../reference-manual/metadata-center/redis.md | 5 +-
.../reference-manual/metadata-center/zookeeper.md | 5 +-
.../java-sdk/reference-manual/protocol/_index.md | 1 +
.../java-sdk/reference-manual/protocol/dubbo.md | 6 +-
.../java-sdk/reference-manual/protocol/grpc.md | 1 +
.../java-sdk/reference-manual/protocol/http.md | 1 +
.../java-sdk/reference-manual/protocol/rmi.md | 1 +
.../java-sdk/reference-manual/protocol/thrift.md | 1 +
.../reference-manual/protocol/triple/_index.md | 32 ++
.../protocol}/v3.2_rest_protocol_design.md | 1 +
.../java-sdk/reference-manual/registry/_index.md | 5 +-
.../reference-manual/registry/nacos/_index.md | 1 +
.../reference-manual/registry/overview/_index.md | 4 -
.../reference-manual/registry/redis/_index.md | 1 +
.../reference-manual/registry/zookeeper/_index.md | 1 +
.../reference-manual}/serialization/_index.md | 0
.../reference-manual}/serialization/avro.md | 1 +
.../reference-manual}/serialization/fastjson.md | 1 +
.../reference-manual}/serialization/fastjson2.md | 1 +
.../reference-manual}/serialization/fst.md | 1 +
.../reference-manual}/serialization/gson.md | 1 +
.../reference-manual}/serialization/hessian.md | 1 +
.../reference-manual}/serialization/kryo.md | 1 +
.../reference-manual}/serialization/msgpack.md | 1 +
.../reference-manual}/serialization/protobuf.md | 1 +
.../version/_index.md | 9 +-
content/zh-cn/overview/quickstart/_index.md | 4 +-
content/zh-cn/overview/quickstart/java/_index.md | 22 +-
content/zh-cn/overview/quickstart/java/api.md | 281 --------------
content/zh-cn/overview/quickstart/java/brief.md | 2 -
.../zh-cn/overview/quickstart/java/spring-boot.md | 4 +-
.../zh-cn/overview/quickstart/java/spring-xml.md | 395 --------------------
.../zh-cn/overview/reference/admin/architecture.md | 1 +
.../overview/reference/admin/documentation.md | 1 +
content/zh-cn/overview/reference/admin/mock.md | 1 +
content/zh-cn/overview/reference/admin/search.md | 1 +
content/zh-cn/overview/reference/admin/test.md | 1 +
.../zh-cn/overview/reference/proposals/_index.md | 2 +-
.../zh-cn/overview/reference/proposals/admin.md | 1 +
.../reference/proposals/heuristic-flow-control.md | 241 +++++++-----
.../zh-cn/overview/reference/protocols/_index.md | 7 +
.../protocol => reference/protocols}/http.md | 46 +--
content/zh-cn/overview/reference/protocols/tcp.md | 98 +++++
.../zh-cn/overview/reference/protocols/triple.md | 85 +++++
content/zh-cn/overview/tasks/develop/async.md | 4 +
.../overview/tasks/develop/service_reference.md | 8 +-
content/zh-cn/overview/tasks/develop/template.md | 51 ++-
content/zh-cn/overview/tasks/ecosystem/_index.md | 12 -
content/zh-cn/overview/tasks/ecosystem/gateway.md | 6 +-
.../zh-cn/overview/tasks/ecosystem/transaction.md | 5 +-
.../zh-cn/overview/tasks/extensibility/registry.md | 2 +
.../zh-cn/overview/tasks/observability/grafana.md | 2 +-
.../overview/tasks/observability/metrics-start.md | 94 -----
.../overview/tasks/observability/prometheus.md | 2 +-
.../tasks/observability/tracing/skywalking.md | 2 +-
.../overview/tasks/observability/tracing/zipkin.md | 4 +-
content/zh-cn/overview/tasks/protocols/dubbo.md | 9 +
content/zh-cn/overview/tasks/protocols/grpc.md | 4 +-
content/zh-cn/overview/tasks/protocols/triple.md | 9 +
content/zh-cn/overview/tasks/protocols/web.md | 1 +
content/zh-cn/overview/tasks/rate-limit/_index.md | 48 +++
.../ecosystem => tasks}/rate-limit/hystrix.md | 24 +-
.../overview/tasks/rate-limit/resilience4j.md | 11 +
.../rate-limit.md => rate-limit/sentinel.md} | 18 +-
.../overview/tasks/traffic-management/accesslog.md | 2 +-
.../overview/tasks/traffic-management/arguments.md | 4 +-
.../overview/tasks/traffic-management/host.md | 2 +-
.../overview/tasks/traffic-management/isolation.md | 4 +-
.../overview/tasks/traffic-management/mock.md | 6 +-
.../overview/tasks/traffic-management/region.md | 2 +-
.../overview/tasks/traffic-management/retry.md | 2 +-
.../overview/tasks/traffic-management/timeout.md | 2 +-
.../overview/tasks/traffic-management/weight.md | 2 +-
content/zh-cn/overview/what/advantages/_index.md | 2 +-
.../zh-cn/overview/what/advantages/performance.md | 42 ++-
.../zh-cn/overview/what/advantages/usability.md | 6 +-
content/zh-cn/overview/what/ecosystem/_index.md | 179 ---------
.../what/ecosystem/config-center/_index.md | 9 -
.../what/ecosystem/config-center/apollo.md | 119 ------
.../overview/what/ecosystem/config-center/nacos.md | 61 ---
.../what/ecosystem/config-center/zookeeper.md | 113 ------
.../overview/what/ecosystem/gateway/_index.md | 9 -
.../overview/what/ecosystem/gateway/apisix.md | 226 ------------
.../zh-cn/overview/what/ecosystem/gateway/kong.md | 9 -
.../zh-cn/overview/what/ecosystem/gateway/pixiu.md | 9 -
.../overview/what/ecosystem/gateway/shenyu.md | 410 ---------------------
.../overview/what/ecosystem/gateway/tengine.md | 9 -
.../what/ecosystem/metadata-center/_index.md | 9 -
.../what/ecosystem/metadata-center/nacos.md | 120 ------
.../what/ecosystem/metadata-center/redis.md | 9 -
.../what/ecosystem/metadata-center/zookeeper.md | 113 ------
.../overview/what/ecosystem/monitoring/_index.md | 9 -
.../overview/what/ecosystem/monitoring/grafana.md | 9 -
.../what/ecosystem/monitoring/micrometer.md | 9 -
.../what/ecosystem/monitoring/prometheus.md | 9 -
.../overview/what/ecosystem/protocol/_index.md | 9 -
.../overview/what/ecosystem/protocol/dubbo.md | 140 -------
.../zh-cn/overview/what/ecosystem/protocol/grpc.md | 51 ---
.../zh-cn/overview/what/ecosystem/protocol/rmi.md | 111 ------
.../overview/what/ecosystem/protocol/thrift.md | 63 ----
.../overview/what/ecosystem/protocol/triple.md | 404 --------------------
.../overview/what/ecosystem/rate-limit/_index.md | 9 -
.../overview/what/ecosystem/rate-limit/polaris.md | 9 -
.../overview/what/ecosystem/rate-limit/sentinel.md | 140 -------
.../overview/what/ecosystem/registry/_index.md | 9 -
.../overview/what/ecosystem/registry/consul.md | 9 -
.../zh-cn/overview/what/ecosystem/registry/etcd.md | 0
.../overview/what/ecosystem/registry/eureka.md | 9 -
.../overview/what/ecosystem/registry/nacos.md | 186 ----------
.../overview/what/ecosystem/registry/polaris.md | 9 -
.../zh-cn/overview/what/ecosystem/registry/sofa.md | 9 -
.../overview/what/ecosystem/registry/zookeeper.md | 133 -------
.../overview/what/ecosystem/service-mesh/_index.md | 9 -
.../overview/what/ecosystem/service-mesh/aeraki.md | 9 -
.../overview/what/ecosystem/service-mesh/istio.md | 9 -
.../overview/what/ecosystem/tracing/_index.md | 9 -
.../overview/what/ecosystem/tracing/micrometer.md | 9 -
.../what/ecosystem/tracing/opentelemetry.md | 9 -
.../overview/what/ecosystem/tracing/skywalking.md | 9 -
.../overview/what/ecosystem/tracing/zipkin.md | 9 -
.../overview/what/ecosystem/transaction/_index.md | 9 -
.../overview/what/ecosystem/transaction/seata.md | 217 -----------
content/zh-cn/overview/what/overview.md | 3 +
data/i18n/en/en.toml | 3 +
data/i18n/zh-cn/zh.toml | 3 +
i18n/en.toml | 3 +
i18n/zh-cn.toml | 3 +
layouts/blog/baseof.html | 4 +-
layouts/docs/baseof.html | 13 +-
layouts/partials/working_in_progress.html | 7 +
.../imgs/blog/2023/2/introduction/1-overview.png | Bin 1733246 -> 0 bytes
static/imgs/blog/2023/2/introduction/10-mesh.png | Bin 1023151 -> 0 bytes
.../blog/2023/2/introduction/11-initializer.png | Bin 121466 -> 944108 bytes
.../imgs/blog/2023/2/introduction/12-interface.png | Bin 105580 -> 0 bytes
static/imgs/blog/2023/2/introduction/13-impl.png | Bin 110372 -> 0 bytes
.../imgs/blog/2023/2/introduction/14-reference.png | Bin 166028 -> 0 bytes
static/imgs/blog/2023/2/introduction/15-deploy.png | Bin 1328259 -> 0 bytes
static/imgs/blog/2023/2/introduction/16-admin.png | Bin 145759 -> 0 bytes
.../imgs/blog/2023/2/introduction/17-grafana1.jpg | Bin 266963 -> 0 bytes
.../imgs/blog/2023/2/introduction/17-grafana1.png | Bin 2000297 -> 3012047 bytes
.../imgs/blog/2023/2/introduction/18-grafana2.jpg | Bin 281698 -> 0 bytes
.../imgs/blog/2023/2/introduction/18-grafana2.png | Bin 1392814 -> 0 bytes
static/imgs/blog/2023/2/introduction/19-gray.png | Bin 2086048 -> 0 bytes
static/imgs/blog/2023/2/introduction/2-arc.png | Bin 1371382 -> 0 bytes
static/imgs/blog/2023/2/introduction/20-region.png | Bin 1438835 -> 0 bytes
static/imgs/blog/2023/2/introduction/21-region.png | Bin 1490388 -> 0 bytes
static/imgs/blog/2023/2/introduction/3-usecase.png | Bin 1003248 -> 0 bytes
.../blog/2023/2/introduction/4-usecase-alibaba.png | Bin 2038624 -> 0 bytes
.../imgs/blog/2023/2/introduction/5-framework.png | Bin 1355034 -> 0 bytes
.../blog/2023/2/introduction/6-extensibility.png | Bin 1507827 -> 0 bytes
.../imgs/blog/2023/2/introduction/7-protocol.png | Bin 1282922 -> 0 bytes
.../blog/2023/2/introduction/8-extensibility.png | Bin 1751570 -> 0 bytes
.../imgs/blog/2023/2/introduction/9-ecosystem.png | Bin 1037028 -> 0 bytes
.../java-sdk/observability/micrometer-bridge.png | Bin 0 -> 1893669 bytes
static/imgs/v3/advantages/initializer.png | Bin 193196 -> 944108 bytes
.../circuit-breaking/consumer-circuit-breaking.png | Bin 0 -> 907980 bytes
.../circuit-breaking/provider-rate-limit.png | Bin 0 -> 292203 bytes
.../imgs/v3/feature/observability/provider-rt.png | Bin 825285 -> 0 bytes
.../v3/feature/observability/provider-stat.png | Bin 607468 -> 3012047 bytes
static/imgs/v3/performance/rpc-dubbo.png | Bin 0 -> 352769 bytes
static/imgs/v3/performance/rpc-triple.png | Bin 0 -> 421671 bytes
.../tasks/develop/initializer-choose-version.png | Bin 0 -> 126462 bytes
.../v3/tasks/develop/initializer-dependencies.png | Bin 0 -> 1230041 bytes
.../imgs/v3/tasks/develop/initializer-preview.png | Bin 0 -> 1627341 bytes
.../develop/initializer-project-architecture.png | Bin 0 -> 414537 bytes
.../v3/tasks/develop/initializer-project-info.png | Bin 0 -> 564045 bytes
static/js/script.js | 6 +-
218 files changed, 1204 insertions(+), 4736 deletions(-)
diff --git a/cn_config.toml b/cn_config.toml
index 0c38e38dc0..2692a49c8f 100644
--- a/cn_config.toml
+++ b/cn_config.toml
@@ -103,11 +103,11 @@ algolia_docsearch = true
offlineSearch = false
-#[[menu.main]]
-# name = "Initializer"
-# weight = 50
-# url = "https://dubbo.apache.org/"
-# post = "<i class='fas fa-external-link-alt'></i>"
+[[menu.main]]
+ name = "Initializer"
+ weight = 50
+ url = "https://start.dubbo.apache.org/bootstrap.html"
+ post = "<i class='fas fa-external-link-alt'></i>"
#[[menu.main]]
# name = "Admin"
# weight = 60
diff --git a/config.toml b/config.toml
index e6becdc3e2..52c3c7a9ee 100644
--- a/config.toml
+++ b/config.toml
@@ -97,11 +97,11 @@ algolia_docsearch = true
offlineSearch = false
-#[[menu.main]]
-# name = "Initializer"
-# weight = 50
-# url = "https://dubbo.apache.org/"
-# post = "<i class='fas fa-external-link-alt'></i>"
+[[menu.main]]
+ name = "Initializer"
+ weight = 50
+ url = "https://start.dubbo.apache.org/bootstrap.html"
+ post = "<i class='fas fa-external-link-alt'></i>"
#[[menu.main]]
# name = "Admin"
# weight = 60
diff --git a/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-apisix.md b/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-apisix.md
index a09b76111a..d624aba7ec 100644
--- a/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-apisix.md
+++ b/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-apisix.md
@@ -5,6 +5,9 @@ date: 2022-01-18
tags: ["网关", "生态", "Java"]
description: >
本文为大家介绍了如何借助 Apache APISIX 实现 Dubbo Service 的代理,通过引入 dubbo-proxy 插件便可为 Dubbo 框架的后端系统构建更简单更高效的流量链路
+aliases:
+ - /zh/overview/what/gateway/apisix/
+ - /zh/overview/what/gateway/higress/
---
## 背景
diff --git a/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-shenyu.md b/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-shenyu.md
index caad83619e..6061228697 100644
--- a/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-shenyu.md
+++ b/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-apache-shenyu.md
@@ -5,6 +5,8 @@ date: 2022-05-04
tags: ["网关", "生态", "Java"]
description: >
本文介绍了如何通过`Apache ShenYu`网关访问`Dubbo`服务,主要内容包括从简单示例到核心调用流程分析,并对设计原理进行了总结。
+aliases:
+ - /zh/overview/what/gateway/shenyu/
---

diff --git a/content/zh-cn/overview/what/ecosystem/gateway/higress.md b/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-higress.md
similarity index 97%
rename from content/zh-cn/overview/what/ecosystem/gateway/higress.md
rename to content/zh-cn/blog/integration/how-to-proxy-dubbo-in-higress.md
index 082c0de5cc..5cf17a63ce 100644
--- a/content/zh-cn/overview/what/ecosystem/gateway/higress.md
+++ b/content/zh-cn/blog/integration/how-to-proxy-dubbo-in-higress.md
@@ -1,11 +1,11 @@
---
aliases:
- /zh/overview/what/ecosystem/gateway/higress/
-description: ""
-linkTitle: Higress
-title: Higress
-type: docs
-weight: 30
+description: "使用 Higress 作为 Dubbo 网关"
+linkTitle: 如何通过 Higress 网关代理 Dubbo 服务
+title: 如何通过 Higress 网关代理 Dubbo 服务
+date: 2023-04-01
+tags: ["网关", "生态"]
---
# Higress 对接 Dubbo 服务
diff --git a/content/zh-cn/blog/news/dubbo-introduction.md b/content/zh-cn/blog/news/dubbo-introduction.md
index a9bf6ffa2e..b4eeef3663 100644
--- a/content/zh-cn/blog/news/dubbo-introduction.md
+++ b/content/zh-cn/blog/news/dubbo-introduction.md
@@ -42,22 +42,22 @@ Dubbo 设计用于解决阿里巴巴内部大规模 微服务集群实践难题
Dubbo 不是应用框架的替代者,它可以很好的工作在每种语言的主流编程框架之上,以 Java 为例,Dubbo 可以很好的与 Spring 协作,并在此基础上提供服务定义、微服务编程、服务发现、负载均衡、流量管控等能力。
### 提供灵活的通信协议切换能力
-
+
在通信方面,Dubbo 区别于其他 RPC 框架的是它不绑定特定协议,你可以在底层选用 HTTP./2、TCP、gRPC、REST、Hessian 等任意通信协议,同时享受统一的 API、以及对等的服务治理能力。
### 一切皆可扩展
-
+
Dubbo 的另一个优势在于其可扩展性设计,从流量管控、协议编码、诊断调优、再到服务治理,你都可以去扩展,满足企业级微服务开发与运维的所有诉求。
### 丰富的生态
-
+
基于扩展能力 Dubbo 官方提供了丰富的生态适配,涵盖了所有主流的开源微服务组件。
### 服务网格
-
+
对于服务网格架构,Dubbo也可以轻松接入原生 Istio 体系;
在数据面支持与 Envoy 部署的 Proxy 模式,也支持无 Envoy 的 Proxyless 模式,提供更灵活的数据面选择。
@@ -66,19 +66,21 @@ Dubbo 的另一个优势在于其可扩展性设计,从流量管控、协议
我们以 Java 微服务开发为例。
### 第一步
-
+
-使用官方脚手架快速创建项目模板,只需要选择依赖的版本、组件,点击 “获取代码” 即可
+使用 [官方脚手架](https://start.dubbo.apache.org/bootstrap.html) 快速创建项目模板,只需要选择依赖的版本、组件,点击 “获取代码” 即可
### 第二步
将模板项目导入 IDE 开发环境。
定义 Java 接口作为 Dubbo 服务。
-
+
开发 Dubbo 服务端,实现接口并完成业务逻辑编码,通过一条简单的注解配置完成服务发布。
-
+
开发Dubbo 客户端,通过注解声明 Dubbo 服务,然后就可以发起远程方法调用了。至此,开发工作完成。
+
+
### 第三步
进入部署环节,我们选择 Kubernetes 作为部署环境。
@@ -92,9 +94,7 @@ Dubbo 的另一个优势在于其可扩展性设计,从流量管控、协议
你可以在此了解Dubbo 集群的详细运行状态,包括每个应用对外服务和调用服务的情况,QpS、成功率等,还可以查看每个实例的资源健康状况。
-
-
-
+
### 第四步
进行流量管控。当应用已经平稳运行后,进一步控制流量的访问行为,包括实现金丝雀发布、全链路灰度、动态调整超时时间、调整权重、按比例流量分发、参数路由等。控制台提供了可视化的流量治理规则操作入口,在这里可以直接下发流量规则。
diff --git a/content/zh-cn/blog/proposals/heuristic-flow-control.md b/content/zh-cn/blog/proposals/heuristic-flow-control.md
index ed9ad981c7..c6ea3aead3 100644
--- a/content/zh-cn/blog/proposals/heuristic-flow-control.md
+++ b/content/zh-cn/blog/proposals/heuristic-flow-control.md
@@ -7,160 +7,215 @@ description: >
---
# 整体介绍
-本文所说的“柔性服务”主要是指consumer端的负载均衡和provider端的限流两个功能。在之前的dubbo版本中,负载均衡部分更多的考虑的是公平性原则,即consumer端尽可能平等的从provider中作出选择,在某些情况下表现并不够理想。而限流部分只提供了静态的限流方案,需要用户对provider端设置静态的最大并发值,然而该值的合理选取对用户来讲并不容易。我们针对这些存在的问题进行了改进。
-# 负载均衡
-在原本的dubbo版本中,有五种负载均衡的方案供选择,他们分别是"Random","ShortestResponse","RoundRobin","LeastActive"和"ConsistentHash"。其中除"ShortestResponse"和"LeastActive"外,其他的几种方案主要是考虑选择时的公平性和稳定性。对于"ShortestResponse"来说,其设计目的是从所有备选的provider中选择response时间最短的以提高系统整体的吞吐量。然而存在两个问题:1.在大多数的场景下,不同provider的response时长没有非常明显的区别,此时该算法会退化为随机选择。2.response的时间长短有时也并不能代表机器的吞吐能力。对于"LeastActive"来说,其认为应该将流量尽可能分配到当前并发处理任务较少的机器上。但是其同样存在和"ShortestResponse"类似的问题,即这并不能单独代表机器的吞吐能力。
-基于以上分析,我们提出了两种新的负载均衡算法。一种是同样基于公平性考虑的单纯"P2C"算法,另一种是基于自适应的方法"adaptive",其试图自适应的衡量provider端机器的吞吐能力,然后将流量尽可能分配到吞吐能力高的机器上,以提高系统整体的性能。
-## 效果介绍
+本文所说的柔性服务主要是指**consumer端的负载均衡**和**provider端的限流**两个功能。在之前的dubbo版本中,
+* 负载均衡部分更多的考虑的是公平性原则,即consumer端尽可能平等的从provider中作出选择,在某些情况下表现并不够理想。
+* 限流部分只提供了静态的限流方案,需要用户对provider端设置静态的最大并发值,然而该值的合理选取对用户来讲并不容易。
+
+我们针对这些存在的问题进行了改进。
+
+## 负载均衡
+### 使用介绍
+在原本的dubbo版本中,有五种负载均衡的方案供选择,他们分别是 `Random`、`ShortestResponse`、`RoundRobin`、`LeastActive` 和 `ConsistentHash`。其中除 `ShortestResponse` 和 `LeastActive` 外,其他的几种方案主要是考虑选择时的公平性和稳定性。
+
+对于 `ShortestResponse` 来说,其设计目的是从所有备选的 provider 中选择 response 时间最短的以提高系统整体的吞吐量。然而存在两个问题:
+1. 在大多数的场景下,不同provider的response时长没有非常明显的区别,此时该算法会退化为随机选择。
+2. response的时间长短有时也并不能代表机器的吞吐能力。对于 `LeastActive` 来说,其认为应该将流量尽可能分配到当前并发处理任务较少的机器上。但是其同样存在和 `ShortestResponse` 类似的问题,即这并不能单独代表机器的吞吐能力。
+
+基于以上分析,我们提出了两种新的负载均衡算法。一种是同样基于公平性考虑的单纯 `P2C` 算法,另一种是基于自适应的方法 `adaptive`,其试图自适应的衡量 provider 端机器的吞吐能力,然后将流量尽可能分配到吞吐能力高的机器上,以提高系统整体的性能。
+
+#### 总体效果
对于负载均衡部分的有效性实验在两个不同的情况下进行的,分别是提供端机器配置比较均衡和提供端机器配置差距较大的情况。
+

+

-## 使用方法
+
+#### 使用方法
使用方法与原本的负载均衡方法相同。只需要在consumer端将"loadbalance"设置为"p2c"或者"adaptive"即可。
-## 代码结构
+
+#### 代码结构
负载均衡部分的算法实现只需要在原本负载均衡框架内继承 LoadBalance接口即可。
-## 原理介绍
-### P2C算法
+
+### 原理介绍
+
+#### P2C算法
+
Power of Two Choice算法简单但是经典,主要思路如下:
-1.对于每次调用,从可用的provider列表中做两次随机选择,选出两个节点providerA和providerB。
-2.比较providerA和providerB两个节点,选择其“当前正在处理的连接数”较小的那个节点。
-### adaptive算法
+
+1. 对于每次调用,从可用的provider列表中做两次随机选择,选出两个节点providerA和providerB。
+2. 比较providerA和providerB两个节点,选择其“当前正在处理的连接数”较小的那个节点。
+
+#### adaptive算法
+
[代码的github地址](https://github.com/apache/dubbo/pull/10745)
-#### 相关指标
-1.cpuLoad
+
+##### 相关指标
+1. cpuLoad
。该指标在provider端机器获得,并通过invocation的attachment传递给consumer端。
-2.rt
+
+2. rt
rt为一次rpc调用所用的时间,单位为毫秒。
-3.timeout
+
+3. timeout
timeout为本次rpc调用超时剩余的时间,单位为毫秒。
-4.weight
+
+4. weight
weight是设置的服务权重。
-5.currentProviderTime
+
+5. currentProviderTime
provider端在计算cpuLoad时的时间,单位是毫秒
-6.currentTime
+
+6. currentTime
currentTime为最后一次计算load时的时间,初始化为currentProviderTime,单位是毫秒。
-7.multiple
+7. multiple

-8.lastLatency
+
+8. lastLatency

-11.inflight
+
+11. inflight
inflight为consumer端还未返回的请求的数量。

-12.load
+
+12. load
对于备选后端机器x来说,若距离上次被调用的时间大于2*timeout,则其load值为0。
-否则
+否则,
+

-#### 算法实现
+
+##### 算法实现
依然是基于P2C算法。
-1.从备选列表中做两次随机选择,得到providerA和providerB
-2.比较providerA和providerB的load值,选择较小的那个。
-# 自适应限流
+1. 从备选列表中做两次随机选择,得到providerA和providerB
+2. 比较providerA和providerB的load值,选择较小的那个。
+
+## 自适应限流
与负载均衡运行在consumer端不同的是,限流功能运行在provider端。其作用是限制provider端处理并发任务时的最大数量。从理论上讲,服务端机器的处理能力是存在上限的,对于一台服务端机器,当短时间内出现大量的请求调用时,会导致处理不及时的请求积压,使机器过载。在这种情况下可能导致两个问题:1.由于请求积压,最终所有的请求都必须等待较长时间才能被处理,从而使整个服务瘫痪。2.服务端机器长时间的过载可能有宕机的风险。因此,在可能存在过载风险时,拒绝掉一部分请求反而是更好的选择。在之前的dubbo版本中,限流是通过在provider端设置静态的最大并发值实现的。但是在服务数量多,拓扑复杂且处理能力会动态变化的局面下,该值难以通过计算静态设置。
基于以上原因,我们需要一种自适应的算法,其可以动态调整服务端机器的最大并发值,使其可以在保证机器不过载的前提下,尽可能多的处理接收到的请求。因此,我们参考brpc等其他框架的基础上,在dubbo的框架内实现了两种自适应限流算法,分别是基于启发式平滑的"HeuristicSmoothingFlowControl"和基于窗口的"AutoConcurrencyLimier"。
+
[代码的github地址](https://github.com/apache/dubbo/pull/10642)
-## 效果介绍
+
+### 使用介绍
+#### 总体效果
+
自适应限流部分的有效性实验我们在提供端机器配置尽可能大的情况下进行,并且为了凸显效果,在实验中我们将单次请求的复杂度提高,将超时时间尽可能设置的大,并且开启消费端的重试功能。

-## 使用方法
+
+#### 使用方法
要确保服务端存在多个节点,并且消费端开启重试策略的前提下,限流功能才能更好的发挥作用。
+
设置方法与静态的最大并发值设置类似,只需在provider端将"flowcontrol"设置为"autoConcurrencyLimier"或者"heuristicSmoothingFlowControl"即可。
-## 代码结构
-1.FlowControlFilter:在provider端的filter负责根据限流算法的结果来对provider端进行限流功能。
-2.FlowControl:根据dubbo的spi实现的限流算法的接口。限流的具体实现算法需要继承自该接口并可以通过dubbo的spi方式使用。
-3.CpuUsage:周期性获取cpu的相关指标
-4.HardwareMetricsCollector:获取硬件指标的相关方法
-5.ServerMetricsCollector:基于滑动窗口的获取限流需要的指标的相关方法。比如qps等。
-6.AutoConcurrencyLimier:自适应限流的具体实现算法。
-7.HeuristicSmoothingFlowControl:自适应限流的具体实现方法。
-## 原理介绍
-### HeuristicSmoothingFlowControl
-#### 相关指标
-1.alpha
+
+#### 代码结构
+1. FlowControlFilter:在provider端的filter负责根据限流算法的结果来对provider端进行限流功能。
+2. FlowControl:根据dubbo的spi实现的限流算法的接口。限流的具体实现算法需要继承自该接口并可以通过dubbo的spi方式使用。
+3. CpuUsage:周期性获取cpu的相关指标
+4. HardwareMetricsCollector:获取硬件指标的相关方法
+5. ServerMetricsCollector:基于滑动窗口的获取限流需要的指标的相关方法。比如qps等。
+6. AutoConcurrencyLimier:自适应限流的具体实现算法。
+7. HeuristicSmoothingFlowControl:自适应限流的具体实现方法。
+
+### 原理介绍
+#### HeuristicSmoothingFlowControl
+##### 相关指标
+1. alpha
alpha为可接受的延时的上升幅度,默认为0.3
-2.minLatency
+
+2. minLatency
在一个时间窗口内的最小的Latency值。
-3.noLoadLatency
+
+3. noLoadLatency
noLoadLatency是单纯处理任务的延时,不包括排队时间。这是服务端机器的固有属性,但是并不是一成不变的。在HeuristicSmoothingFlowControl算法中,我们根据机器CPU的使用率来确定机器当前的noLoadLatency。当机器的CPU使用率较低时,我们认为minLatency便是noLoadLatency。当CPU使用率适中时,我们平滑的用minLatency来更新noLoadLatency的值。当CPU使用率较高时,noLoadLatency的值不再改变。
-4.maxQPS
+
+4. maxQPS
一个时间窗口周期内的QPS的最大值。
-5.avgLatency
+
+5. avgLatency
一个时间窗口周期内的Latency的平均值,单位为毫秒。
-6.maxConcurrency
+
+6. maxConcurrency
计算得到的当前服务提供端的最大并发值。

-#### 算法实现
+
+##### 算法实现
当服务端收到一个请求时,首先判断CPU的使用率是否超过50%。如果没有超过50%,则接受这个请求进行处理。如果超过50%,说明当前的负载较高,便从HeuristicSmoothingFlowControl算法中获得当前的maxConcurrency值。如果当前正在处理的请求数量超过了maxConcurrency,则拒绝该请求。
-### AutoConcurrencyLimier
-#### 相关指标
-1.MaxExploreRatio
+#### AutoConcurrencyLimier
+##### 相关指标
+1. MaxExploreRatio
默认设置为0.3
-2.MinExploreRatio
+2. MinExploreRatio
默认设置为0.06
-3.SampleWindowSizeMs
+3. SampleWindowSizeMs
采样窗口的时长。默认为1000毫秒。
-4.MinSampleCount
+4. MinSampleCount
采样窗口的最小请求数量。默认为40。
-5.MaxSampleCount
+5. MaxSampleCount
采样窗口的最大请求数量。默认为500。
-6.emaFactor
+6. emaFactor
平滑处理参数。默认为0.1。
-7.exploreRatio
+7. exploreRatio
探索率。初始设置为MaxExploreRatio。
若avgLatency<=noLoadLatency*(1.0 + MinExploreRatio)或者qps>=maxQPS*(1.0 + MinExploreRatio)
则exploreRatio=min(MaxExploreRatio,exploreRatio+0.02)
否则
exploreRatio=max(MinExploreRatio,exploreRatio-0.02)
-8.maxQPS
+8. maxQPS
窗口周期内QPS的最大值。

-12.remeasureStartUs
+12. remeasureStartUs
下一次重置窗口的开始时间。

-13.startSampleTimeUs
+13. startSampleTimeUs
开始采样的时间。单位为微秒。
-14.sampleCount
+14. sampleCount
当前采样窗口内请求的数量。
-15.totalSampleUs
+15. totalSampleUs
采样窗口内所有请求的latency的和。单位为微秒。
-16.totalReqCount
+16. totalReqCount
采样窗口时间内所有请求的数量和。注意区别sampleCount。
-17.samplingTimeUs
+17. samplingTimeUs
采样当前请求的时间戳。单位为微秒。
-18.latency
+18. latency
当前请求的latency。
-19.qps
+19. qps
在该时间窗口内的qps值。

-20.avgLatency
+20. avgLatency
窗口内的平均latency。

-21.maxConcurrency
+21. maxConcurrency
上一个窗口计算得到当前周期的最大并发值。
-22.nextMaxConcurrency
+22. nextMaxConcurrency
当前窗口计算出的下一个周期的最大并发值。
 内的详细说明
-Dubbo 社区和众多优秀的开源项目一起围绕 Dubbo 建立了丰富的微服务生态支持,这让开发者从选型 Dubbo 作为开发框架的第一天,就无需担心后续的服务治理诉求,Dubbo 对每一个常见问题均提供了生产级的解决方案。
+| 功能 | 组件列表 | 组件列表 | 组件列表 | 组件列表 | 组件列表 |
+| --- | --- | --- | --- | --- | --- |
+| 服务发现 | [Zookeeper](../../mannual/java-sdk/reference-manual/registry/zookeeper) | [Nacos](../../mannual/java-sdk/reference-manual/registry/nacos) | [Kubernetes Service](/) | DNS【开发中】 | <a href="https://github.com/apache/dubbo-spi-extensions/tree/master/dubbo-registry-extensions" target="_blank">更多</a> |
+| 动态配置 | [Zookeeper](../../mannual/java-sdk/reference-manual/config-center/zookeeper) | [Nacos](../../mannual/java-sdk/reference-manual/config-center/nacos) | [Apollo](../../mannual/java-sdk/reference-manual/config-center/apollo) | Kubernetes【开发中】| <a href="https://github.com/apache/dubbo-spi-extensions/tree/master/dubbo-configcenter-extensions" target="_blank">更多</a> |
+| 元数据管理 | [Zookeeper](../../mannual/java-sdk/reference-manual/metadata-center/zookeeper) | [Nacos](../../mannual/java-sdk/reference-manual/metadata-center/nacos) | [Redis](../../mannual/java-sdk/reference-manual/metadata-center/redis) | Kubernetes【开发中】 | <a href="https://github.com/apache/dubbo-spi-extensions/tree/master/dubbo-metadata-report-extensions" target="_blank">更多</a> |
+| RPC 协议 | [HTTP/2 (Triple)](../../reference/protocols/triple) | [TCP](../../reference/protocols/tcp) | [HTTP/REST【Alpha】](../../reference/protocols/http) | [gRPC](../../reference/protocols/triple) | [更多](../../reference/protocols/) |
+| 可视化观测平台 | [Admin](../../tasks/observability/admin/) | [Grafana](../../tasks/observability/grafana/) | [Prometheus](../../tasks/observability/prometheus/) | - | - |
+| 全链路追踪 | [Zipkin](../../tasks/observability/tracing/zipkin/) | [Skywalking](../../tasks/observability/tracing/skywalking/) | <a href="https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-spring-boot3-tracing#2-adding-micrometer-tracing-bridge-to-your-project" target="_blank">OpenTelemetry</a> | - | - |
+| 限流降级 | [Sentinel](../../tasks/rate-limit/sentinel) | [Resilience4j](../../tasks/rate-limit/resilience4j) | [Hystrix](../../tasks/rate-limit/hystrix) | - | - |
+| 分布式事务 | [Seata](../../tasks/ecosystem/transaction/) | - | - | - | - |
+| 网关 | [Higress]({{< relref "../../../../blog/integration/how-to-proxy-dubbo-in-higress" >}}) | [APISIX](../../tasks/ecosystem/gateway/) | [Shenyu]({{< relref "../../../../blog/integration/how-to-proxy-dubbo-in-apache-shenyu" >}}) | [Envoy](https://www.envoyproxy.io/docs/envoy/latest/configuration/listeners/network_filters/dubbo_proxy_filter) | - |
+| 服务网格 | Istio【开发中】 | <a href="https://www.aeraki.net/" target="_blank">Aeraka</a> | OpenSergo【开发中】 | Proxyless【Alpha】 | 更多 |
-基于 Dubbo 灵活的可扩展性,Dubbo 微服务集群不会绑定任何特定组件实现、不绑定单一通信协议。
+## 微服务生态示例架构
+
+{{< mse >}}
{{< blocks/section color="white" height="auto" >}}
<div class="msemap-section">
@@ -28,6 +42,4 @@ Dubbo 社区和众多优秀的开源项目一起围绕 Dubbo 建立了丰富的
</div>
{{< /blocks/section >}}
-<!--  -->
-可通过 [微服务生态](../../what/ecosystem) ,了解更多 Dubbo 生态能力和使用方式。
diff --git a/content/zh-cn/overview/core-features/extensibility.md b/content/zh-cn/overview/core-features/extensibility.md
index 1198b217f0..dd13e4cda2 100644
--- a/content/zh-cn/overview/core-features/extensibility.md
+++ b/content/zh-cn/overview/core-features/extensibility.md
@@ -30,22 +30,13 @@ Dubbo 扩展能力使得 Dubbo 项目很方便的切分成一个一个的子模
* **服务治理扩展**。注册中心、配置中心、元数据中心、分布式事务、全链路追踪、监控系统等
* **诊断与调优扩展**。流量统计、线程池策略、日志、QoS 运维命令、健康检查、配置加载等
-可参考这篇文档了解更多 [扩展点定义](/)
-## 扩展示例
+## 基于扩展点的微服务生态
+众多的扩展点与抽象,是 Dubbo 与众多微服务生态组件对接、实现微服务治理能力的基础。
-以下示例演示了如何扩展 Dubbo 来解决实际问题,可以跟随示例学习。
-
-* [自定义负载均衡策略](/)
-* [自定义注册中心](/)
-* [自定义拦截器](/)
-
-## 微服务生态
-通过扩展对接微服务生态的示例。
-
-* [全链路追踪](/)
-* [数据一致性](/)
-* [限流降级](/)
+* [全链路追踪](../../tasks/observability/tracing/)
+* [数据一致性](../../tasks/ecosystem/transaction/)
+* [限流降级](../../core-features/traffic/circuit-breaking/)
Dubbo 的各语言 sdk 实现都是采用的 "微内核+插件" 的设计模式,几乎所有流程中的核心节点都被定义为扩展点,官方发布的组件也是以扩展点的实现形式发布,因此 Dubbo 可以平等的对待所有官方与第三方组件扩展。
* 扩展适配能力是实现 Dubbo 微服务生态的关键,Dubbo 生态组件如全链路追踪、注册中心实现等的适配都是基于 Filter、Registry、DynamicConfiguration 等扩展点实现。
@@ -82,7 +73,7 @@ Filter 流量拦截器是 Dubbo 服务调用之上的 AOP 设计模式,Filter
### Router
Router 路由器是 Dubbo 中流量管控的关键组件,它将符合一定条件的流量转发到特定分组的地址子集,是 Dubbo 流量管控中一些关键能力如按比例流量转发、流量隔离等的基础。每次服务调用请求都会流经一组路由器 (路由链),每个路由器根据预先设定好的规则、全量地址列表以及当前请求上下文计算出一个地址子集,再传给下一个路由器,重复这一过程直到最后得出一个有效的地址子集。
-Dubbo 官方发布版本预置了丰富的流量管控规则与 router 实现,如 [流量管控](/) 一文中阐述的,用户通过下发规则即可实现各种模式的流量管控。如果有其他流量管控诉求,可以通过提供自定义的 router 扩展实现。
+Dubbo 官方发布版本预置了丰富的流量管控规则与 router 实现,如 [流量管控](../traffic/) 一文中阐述的,用户通过下发规则即可实现各种模式的流量管控。如果有其他流量管控诉求,可以通过提供自定义的 router 扩展实现。
### Load Balance
在 Dubbo 中,Load Balance 负载均衡工作在 router 之后,对于每次服务调用,负载均衡负责在 router 链输出的地址子集中选择一台机器实例进行访问,保证一段时间内的调用都均匀的分布在地址子集的所有机器上。
@@ -98,7 +89,7 @@ Dubbo 官方提供了加权随机、加权轮询、一致性哈希、最小活
在具体实现或者部署上,注册中心、配置中心和元数据中心可以是同一组件,比如 Zookeeper 可同时作为注册、配置和元数据中心,Nacos 也是如此。因此,三个中心只是从架构职责上的划分,你甚至可以用同一个 Zookeeper 集群来承担所有三个职责,只需要在应用里将他们设置为同一个集群地址就可以了。
-> 在云原生部署架构下,随着 Kubernetes、Service Mesh 架构的流行,微服务基础设施呈现下沉趋势,注册、配置和元数据中心的职责正被 Kubernetes、Istio 等组件取代,具体可参见 [服务网格](/) 一节的描述。
+> 在云原生部署架构下,随着 Kubernetes、Service Mesh 架构的流行,微服务基础设施呈现下沉趋势,注册、配置和元数据中心的职责正被 Kubernetes、Istio 等组件取代,具体可参见 [服务网格](../service-mesh/) 一节的描述。
### Registry
注册中心是 Dubbo 实现服务发现能力的基础,Dubbo 官方支持 Zookeeper、Nacos、Etcd、Consul、Eureka 等注册中心。
@@ -115,10 +106,17 @@ Dubbo 官方支持 Zookeeper、Nacos、Etcd、Redis、Apollo 等配置中心实
Dubbo 官方支持 Zookeeper、Nacos、Etcd、Redis 等元数据中心实现。
-## 更多扩展
+## 自定义扩展示例
+
+以下示例演示了如何扩展 Dubbo 来解决实际问题,可以跟随示例学习。
+
+* [自定义 RPC 协议](../../tasks/extensibility/protocol/)
+* [自定义流量路由规则](../../tasks/extensibility/router/)
+* [自定义注册中心](../../tasks/extensibility/registry/)
+* [自定义拦截器](../../tasks/extensibility/filter/)
+
+## 更多扩展点
本文列出了 Dubbo 常用的一些扩展点,但还有大量的扩展点可供灵活定制,并且不同语言 sdk 的扩展定义和配置方式上也存在差异,以下是 Dubbo SDK 的扩展点手册。
-* [Java 扩展点手册](/)
-* [Go 扩展点手册](/)
-* [Rust 扩展点手册](/)
-* [Node.js 扩展点手册](/)
+* [Java 扩展点手册](../../mannual/java-sdk/reference-manual/spi/description/)
+* [Go 扩展点手册](../../mannual/golang-sdk/preface/design/aop_and_extension/)
diff --git a/content/zh-cn/overview/core-features/load-balance.md b/content/zh-cn/overview/core-features/load-balance.md
index ef01b25d93..4f0687643f 100644
--- a/content/zh-cn/overview/core-features/load-balance.md
+++ b/content/zh-cn/overview/core-features/load-balance.md
@@ -19,11 +19,13 @@ weight: 3
| 算法 | 特性 | 备注 |
| :-------------------------- | :---------------------- | :---------------------------------------------- |
-| Weighted Random LoadBalance | 加权随机 | 默认算法,默认权重相同 |
+| Weighted Random LoadBalance | 加权随机 | 默认算法,默认权重相同 |
| RoundRobin LoadBalance | 加权轮询 | 借鉴于 Nginx 的平滑加权轮询算法,默认权重相同, |
-| LeastActive LoadBalance | 最少活跃优先 + 加权随机 | 背后是能者多劳的思想 |
-| Shortest-Response LoadBalance | 最短响应优先 + 加权随机 | 更加关注响应速度 |
-| ConsistentHash LoadBalance | 一致性哈希 | 确定的入参,确定的提供者,适用于有状态请求 |
+| LeastActive LoadBalance | 最少活跃优先 + 加权随机 | 背后是能者多劳的思想 |
+| Shortest-Response LoadBalance | 最短响应优先 + 加权随机 | 更加关注响应速度 |
+| ConsistentHash LoadBalance | 一致性哈希 | 确定的入参,确定的提供者,适用于有状态请求 |
+| P2C LoadBalance | Power of Two Choice | 随机选择两个节点后,继续选择“连接数”较小的那个节点。 |
+| Adaptive LoadBalance | 自适应负载均衡 | 在 P2C 算法基础上,选择二者中 load 最小的那个节点 |
### Weighted Random
@@ -74,6 +76,19 @@ weight: 3
* 缺省只对第一个参数 Hash,如果要修改,请配置 `<dubbo:parameter key="hash.arguments" value="0,1" />`
* 缺省用 160 份虚拟节点,如果要修改,请配置 `<dubbo:parameter key="hash.nodes" value="320" />`
+### P2C Load Balance
+Power of Two Choice 算法简单但是经典,主要思路如下:
+
+1. 对于每次调用,从可用的provider列表中做两次随机选择,选出两个节点providerA和providerB。
+2. 比较providerA和providerB两个节点,选择其“当前正在处理的连接数”较小的那个节点。
+
+以下是 [Dubbo P2C 算法实现提案](../../reference/proposals/heuristic-flow-control/#p2c算法)
+
+### Adaptive Load Balance
+Adaptive 即自适应负载均衡,是一种能根据后端实例负载自动调整流量分布的算法实现,它总是尝试将请求转发到负载最小的节点。
+
+以下是 [Dubbo Adaptive 算法实现提案](../../reference/proposals/heuristic-flow-control/#adaptive算法)
+
## 配置方式
Dubbo 支持在服务提供者一侧配置默认的负载均衡策略,这样所有的消费者都将默认使用提供者指定的负载均衡策略,消费者可以自己配置要使用的负载均衡策略,如果都没有任何配置,
则默认使用随机负载均衡策略。
@@ -82,10 +97,8 @@ Dubbo 支持在服务提供者一侧配置默认的负载均衡策略,这样
具体配置方式参加以下多语言实现
-* [Java](/)
-* [Golang](/)
-* [Rust](/)
-* [Node.js](/)
+* [Java](../../mannual/java-sdk/advanced-features-and-usage/performance/loadbalance/#使用方式)
+* [Golang](../../mannual/golang-sdk/)
## 自定义扩展
负载均衡策略支持自定义扩展实现,具体请参见 [Dubbo 可扩展性](../extensibility)
diff --git a/content/zh-cn/overview/core-features/more.md b/content/zh-cn/overview/core-features/more.md
index c3a37aa191..b1bb6cfc01 100644
--- a/content/zh-cn/overview/core-features/more.md
+++ b/content/zh-cn/overview/core-features/more.md
@@ -12,10 +12,8 @@ weight: 11
作为一款与应用开发紧密相关的微服务框架,同时旨在为微服务集群提供企业级服务治理能力,Dubbo 还提供了很多高级功能,涵盖服务调用行为控制、服务诊断与调优、服务治理等。
多种语言 sdk 在功能实现、配置方式上会略有差异,具体功能列表和使用方式可参考如下文档:
-* [Java](/)
-* [Golang](/)
-* [Rust](/)
-* [Node.js](/)
+* [Java](../../mannual/java-sdk/advanced-features-and-usage/)
+* [Golang](../../mannual/golang-sdk/tutorial/)
## 控制服务调用行为
* 服务版本
diff --git a/content/zh-cn/overview/core-features/observability.md b/content/zh-cn/overview/core-features/observability.md
index 1d751cc180..c61cfe430c 100644
--- a/content/zh-cn/overview/core-features/observability.md
+++ b/content/zh-cn/overview/core-features/observability.md
@@ -37,8 +37,6 @@ Dubbo 运行时统计了包括 qps、rt、调用总数、成功数、失败数
可以通过 Grafana 可视化的查看 Metrics 指标

-
-
* [使用 Grafana 可视化展示 Metrics 指标](../../tasks/observability/grafana/)
* [如何从 Prometheus 查询特定 Metrics 指标](../../tasks/observability/prometheus/)
@@ -48,10 +46,11 @@ Dubbo 运行时统计了包括 qps、rt、调用总数、成功数、失败数

-只需要简单的一行配置即可切换链路跟踪的后端实现,并且,你可以随时通过 Dubbo Admin 等治理平台动态调整 Dubbo 的链路追踪采样率,对于问题排查都非常有价值。
+> 未来我们计划支持通过 Dubbo Admin 等治理平台动态调整 Dubbo 的链路追踪采样率。
* [基于 Skywalking 实现全链路追踪](../../tasks/observability/tracing/skywalking/)
* [基于 Zipkin 实现全链路追踪](../../tasks/observability/tracing/zipkin/)
+* [通过链路追踪关联日志系统](../../mannual/java-sdk/advanced-features-and-usage/observability/tracing#关联日志)
## Logging
访问日志可以帮助分析系统的流量情况,在有些场景下,开启访问日志对于排查问题也非常有帮助。
diff --git a/content/zh-cn/overview/core-features/protocols.md b/content/zh-cn/overview/core-features/protocols.md
index 110e7dec8c..9ea8d86242 100644
--- a/content/zh-cn/overview/core-features/protocols.md
+++ b/content/zh-cn/overview/core-features/protocols.md
@@ -12,8 +12,6 @@ type: docs
weight: 5
---
-
-
Dubbo 框架提供了自定义的高性能 RPC 通信协议:基于 HTTP/2 的 Triple 协议 和 基于 TCP 的 Dubbo2 协议。除此之外,Dubbo 框架支持任意第三方通信协议,如官方支持的 gRPC、Thrift、REST、JsonRPC、Hessian2 等,更多协议可以通过自定义扩展实现。这对于微服务实践中经常要处理的多协议通信场景非常有用。
**Dubbo 框架不绑定任何通信协议,在实现上 Dubbo 对多协议的支持也非常灵活,它可以让你在一个应用内发布多个使用不同协议的服务,并且支持用同一个 port 端口对外发布所有协议。**
@@ -26,12 +24,15 @@ Dubbo 框架提供了自定义的高性能 RPC 通信协议:基于 HTTP/2 的
* 让协议迁移变的更简单。通过多协议、注册中心的协调,可以快速满足公司内协议迁移的需求。比如如从自研协议升级到 Dubbo 协议,Dubbo 协议自身升级,从 Dubbo 协议迁移到 gRPC,从 HTTP 迁移到 Dubbo 协议等。
## HTTP/2 (Triple)
-Triple 协议是 Dubbo3 发布的面向云原生时代的通信协议,它基于 HTTP/2 并且完全兼容 gRPC 协议,原生支持 Streaming 通信语义,自 Triple 协议开始,Dubbo 还支持基于 Protobuf 的服务定义与数据传输。Triple 具备更好的网关、代理穿透性,因此非常适合于跨网关、代理通信的部署架构,如服务网格等。
+Triple 协议是 Dubbo3 发布的面向云原生时代的通信协议,它基于 HTTP/2 并且完全兼容 gRPC 协议,原生支持 Streaming 通信语义,Triple 可同时运行在 HTTP/1 和 HTTP/2 传输协议之上,让你可以直接使用 curl、浏览器访问后端 Dubbo 服务。
+
+自 Triple 协议开始,Dubbo 还支持基于 Protocol Buffers 的服务定义与数据传输,但 Triple 实现并不绑定 IDL,比如你可以直接使用 Java Interface 定义和发布 Triple 服务。Triple 具备更好的网关、代理穿透性,因此非常适合于跨网关、代理通信的部署架构,如服务网格等。
Triple 协议的核心特性如下:
* 支持 TLS 加密、Plaintext 明文数据传输
* 支持反压与限流
* 支持 Streaming 流式通信
+* 同时支持 HTTP/1 和 HTTP/2 传输协议
在编程与通信模型上,Triple 协议支持如下模式:
* 消费端异步请求(Client Side Asynchronous Request-Response)
@@ -41,13 +42,16 @@ Triple 协议的核心特性如下:
* 双向流式通信(Bidirectional Streaming)
开发实践
-* [Triple 协议使用](/) 请参见具体语言 sdk 文档
-* [Triple 协议规范](/)
+* Triple 协议使用请参见 [Triple 协议开发任务](../../tasks/protocols/triple/) 或 [java sdk 示例文档](../../mannual/java-sdk/reference-manual/protocol/triple/)
+* [Triple 设计思路与协议规范](../../reference/protocols/triple/)
## Dubbo2
Dubbo2 协议是基于 TCP 传输层协议之上构建的一套 RPC 通信协议,由于其紧凑、灵活、高性能的特点,在 Dubbo2 时代取得了非常广泛的应用,是企业构建高性能、大规模微服务集群的关键通信方案。在云原生时代,我们更推荐使用通用性、穿透性更好的 Triple 协议。
-[Dubbo2 协议规范](/)
+Dubbo2 协议也内置 HTTP 支持,因此你可以使用 curl 在开发阶段快速验证或调试服务。
+
+* [Dubbo2 协议开发任务](../../tasks/protocols/dubbo/)
+* [Dubbo2 设计思路与协议规范](../../reference/protocols/tcp/)
## gRPC
你可以用 Dubbo 开发和治理微服务,然后设置使用 gRPC 协议进行底层通信。但为什么要这么做那,与直接使用 gRPC 框架对比有什么优势?简单的答案是,这是使用 gRPC 进行微服务开发的常用模式,具体请往下看。
@@ -56,13 +60,13 @@ gRPC 是谷歌开源的基于 HTTP/2 的通信协议,如同我们在 [产品
在 Dubbo 体系下使用 gRPC 协议 (gRPC over Dubbo Framework) 是一个非常高效和轻量的选择,它让你既能使用原生的 gRPC 协议通信,又避免了基于 gRPC 进行二次定制与开发的复杂度 (二次开发与定制 gRPC,是很多企业规模化实践后证实不可避免的环节,Dubbo 框架替开发者完成了这一步,让开发者可以直接以最简单的方式使用 gRPC)。
-[gRPC over Dubbo 示例](/)
+[gRPC over Dubbo 示例](../../tasks/protocols/grpc/)
## REST
微服务领域常用的一种通信模式是 HTTP + JSON,包括 Spring Cloud、Microprofile 等一些主流的微服务框架都默认使用的这种通信模式,Dubbo 同样提供了对基于 HTTP 的编程、通信模式的支持。
-* [HTTP over Dubbo 示例](/)
-* [Dubbo 与 Spring Cloud 体系互通](/)
+* [HTTP over Dubbo 示例](../../tasks/protocols/web/)
+* [Dubbo 与 Spring Cloud 体系互通](../../tasks/protocols/springcloud/)
## 其他通信协议
除了以上介绍的几种协议之外,你还可以将以下协议运行在 Dubbo 之上。对 Dubbo 而言,只需要修改一行简单的配置,就可以切换底层服务的通信协议,其他外围 API 和治理能力不受影响。
@@ -76,10 +80,9 @@ gRPC 是谷歌开源的基于 HTTP/2 的通信协议,如同我们在 [产品
## 配置方式
以上协议的配置和使用方式,包括如何配置 `单端口多协议` 支持等,请参照以下 sdk 示例文档:
-* [Java](/)
-* [Golang](/)
-* [Rust](/)
-* [Node.js](/)
+* [Java](../../mannual/java-sdk/reference-manual/protocol/)
+* [Golang](../../mannual/golang-sdk/tutorial/develop/protocol/)
+* [Rust](../../mannual/rust-sdk/)
## 自定义扩展
-除了以上官方版本支持的通信协议,Dubbo 支持扩展新协议支持,具体请参见 [Dubbo 可扩展性](../extensibility)
+除了以上官方版本支持的通信协议,Dubbo 支持扩展新协议支持,具体请参见 [【任务】-【可扩展性】-【protocol】](../../tasks/extensibility/protocol/)
diff --git a/content/zh-cn/overview/core-features/security.md b/content/zh-cn/overview/core-features/security.md
index d7ed4dc213..dbc8052372 100644
--- a/content/zh-cn/overview/core-features/security.md
+++ b/content/zh-cn/overview/core-features/security.md
@@ -12,8 +12,6 @@ type: docs
weight: 8
---
-
-
Dubbo 提供了构建安全微服务通信体系 (零信任体系) 的完善机制,这包括:
* 避免通信过程中的中间人攻击,Dubbo 提供了身份认证 (Authentication) 和基于 TLS 的通信链路加密能力
* 控制服务间的访问鉴权 (Authorization),Dubbo 提供了 mTLS 和权限检查机制
diff --git a/content/zh-cn/overview/core-features/service-definition.md b/content/zh-cn/overview/core-features/service-definition.md
index 214e8b3caa..9de24816ae 100644
--- a/content/zh-cn/overview/core-features/service-definition.md
+++ b/content/zh-cn/overview/core-features/service-definition.md
@@ -19,7 +19,7 @@ Dubbo 解决企业微服务从开发、部署到治理运维的一系列挑战
接下来以 Java 体系 Spring Boot 项目为例讲解 Dubbo 应用开发的基本步骤,整个过程非常直观简单,其他语言开发过程类似。
### 创建项目
-[Dubbo 微服务项目脚手架](/)(支持浏览器页面、命令行和 IDE)可用于快速创建微服务项目,只需要告诉脚手架期望包含的功能或组件,脚手架最终可以帮助开发者生成具有必要依赖的微服务工程。
+<a href="https://start.dubbo.apache.org/bootstrap.html" target="_blank">Dubbo 微服务项目脚手架</a>(支持浏览器页面、命令行和 IDE)可用于快速创建微服务项目,只需要告诉脚手架期望包含的功能或组件,脚手架最终可以帮助开发者生成具有必要依赖的微服务工程。更多脚手架使用方式的讲解,请参见任务模块的 [通过模板生成项目脚手架](../../tasks/develop/template/)

@@ -97,7 +97,7 @@ Dubbo 原生服务可打包部署到 Docker 容器、Kubernetes、服务网格
关于不同环境的部署示例,可参考:
* [部署 Dubbo 服务到 Docker 容器](../../tasks/deploy/deploy-on-docker)
-* [部署 Dubbo 服务到 Kubernetes](../../tasks/deploy/deploy-on-k8s-containerd)
+* [部署 Dubbo 服务到 Kubernetes](../../tasks/deploy/deploy-on-k8s-docker)
## 治理
对于服务治理,绝大多数应用只需要增加以下配置即可,Dubbo 应用将具备地址发现和负载均衡能力。
diff --git a/content/zh-cn/overview/core-features/service-discovery.md b/content/zh-cn/overview/core-features/service-discovery.md
index 57fae18f30..a5f904a24f 100644
--- a/content/zh-cn/overview/core-features/service-discovery.md
+++ b/content/zh-cn/overview/core-features/service-discovery.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/service-discovery/
+ - /zh-cn/overview/mannual/java-sdk/concepts-and-architecture/service-discovery/
description: 服务发现
feature:
description: |
@@ -13,7 +14,6 @@ weight: 2
---
-
Dubbo 提供的是一种 Client-Based 的服务发现机制,依赖第三方注册中心组件来协调服务发现过程,支持常用的注册中心如 Nacos、Consul、Zookeeper 等。
以下是 Dubbo 服务发现机制的基本工作原理图:
@@ -62,12 +62,11 @@ Dubbo 提供的是一种 Client-Based 的服务发现机制,依赖第三方注
## 配置方式
Dubbo 服务发现扩展了多种注册中心组件支持,如 Nacos、Zookeeper、Consul、Redis、kubernetes 等,可以通过配置切换不通实现,同时还支持鉴权、命名空间隔离等配置。具体配置方式请查看 SDK 文档
-* [Java](/)
-* [Golang](/)
-* [Rust](/)
-* [Node.js](/)
+* [Java](../../mannual/java-sdk/reference-manual/registry)
+* [Golang](../../mannual/golang-sdk/tutorial/develop/registry)
+* [Rust](../../mannual/rust-sdk/)
-Dubbo 还支持一个应用内配置多注册中心的情形如双注册、双订阅等,这对于实现不同集群地址数据互通、集群迁移等场景非常有用处,[最佳实践](/) 任务里有关于这部分的示例说明。
+Dubbo 还支持一个应用内配置多注册中心的情形如双注册、双订阅等,这对于实现不同集群地址数据互通、集群迁移等场景非常有用处,我们将在未来文档中添加 `最佳实践` 对这部分内容进行示例说明。
## 自定义扩展
注册中心适配支持自定义扩展实现,具体请参见 [Dubbo 可扩展性](../extensibility)
diff --git a/content/zh-cn/overview/core-features/service-mesh.md b/content/zh-cn/overview/core-features/service-mesh.md
index 829901516e..d92e94b4a1 100644
--- a/content/zh-cn/overview/core-features/service-mesh.md
+++ b/content/zh-cn/overview/core-features/service-mesh.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/service-mesh/
+ - /zh-cn/overview/mannual/java-sdk/concepts-and-architecture/mesh/
description: 服务网格
feature:
description: |
@@ -10,6 +11,7 @@ linkTitle: 服务网格
title: 服务网格
type: docs
weight: 9
+working-in-progress: true
---
diff --git a/content/zh-cn/overview/core-features/traffic/_index.md b/content/zh-cn/overview/core-features/traffic/_index.md
index c23e40dc64..492852a63a 100755
--- a/content/zh-cn/overview/core-features/traffic/_index.md
+++ b/content/zh-cn/overview/core-features/traffic/_index.md
@@ -268,7 +268,7 @@ Dubbo 还提供了 `dubboctl` 命令行工具,前提也是需要有 Dubbo Admi
以上介绍的都是 Dubbo 体系内的流量治理规则,如果您对服务网格架构感兴趣,则可以将 Dubbo 服务接入服务网格体系,这样,您就可以使用服务网格提供的流量治理能力,如 Istio 体系的 VirtualService 等。
-具体请参见 [使用服务网格规则](./mesh-rule)。
+具体请参见 [Dubbo 中的服务网格架构](../service-mesh)。
## 跟随示例学习
我们搭建了一个 [线上商城系统](../../tasks/traffic-management/) 供您学习流量规则的具体使用。
diff --git a/content/zh-cn/overview/core-features/traffic/circuit-breaking.md b/content/zh-cn/overview/core-features/traffic/circuit-breaking.md
new file mode 100644
index 0000000000..4b1444cd99
--- /dev/null
+++ b/content/zh-cn/overview/core-features/traffic/circuit-breaking.md
@@ -0,0 +1,41 @@
+---
+description: ""
+linkTitle: 限流 & 熔断
+title: 限流 & 熔断
+type: docs
+weight: 5
+---
+
+由于微服务分布式的特点,如何构建稳定的微服务集群是一个很大的挑战,其中有两项非常关键的点值得关注
+* 流量控制 (Rate Limiting)
+* 熔断降级 (Circuit Breaking)
+
+## 流量控制
+**流量控制更多的是站在 Dubbo 服务提供者视角来保证服务稳定性**,通过明确的为 Dubbo 服务设置请求上限阈值,确保服务所处理的请求数始终在一个合理范围之内,从而确保系统整体的稳定性。
+
+
+
+根据服务的具体部署情况,服务所能处理的流量上限是一定的,当对服务的请求数量保持在合理的范围时,系统运行正常;而当请求数量严重超过服务处理能力时,如大促期间的流量洪峰等场景,就可能造成服务提供者端的资源过度消耗、负载过高,进而出现响应延迟、请求无应答、系统假死等情况。
+
+流量控制解决的问题和工作方式比较容易理解,而其使用的难点就是如何确定服务所能处理的流量最大值?
+* 一种模式是由用户预先设定一个固定的限流值,如 Dubbo 通过集成 Sentinel 等产品实现的限流能力即是这种模式
+ * [Dubbo Sentinel 流量控制](../../../tasks/rate-limit/sentinel/)
+* 另一种方式是 Dubbo 框架自动根据系统或集群负载情况执行限流,相比用户预先设置限流值更加灵活方便,Dubbo 目前内置了自适应限流模式,具体可参见:
+ * [Java 自适应限流使用方式](../../../mannual/java-sdk/advanced-features-and-usage/performance/adaptive-concurrency-control/)
+ * [Go 自适应限流使用方式](../../../reference/proposals/heuristic-flow-control/)
+ * [自适应限流设计原理](../../../reference/proposals/heuristic-flow-control/)
+
+## 熔断降级
+**熔断降级则是更多的从 Dubbo 服务消费者视角来保障系统稳定性的重要手段**。一个服务往往需要调用更多的下游 Dubbo 服务来完成业务逻辑,这时下游服务的稳定性就会影响当前服务甚至整个系统的稳定性,熔断(Circuit Breaking)即是面向不稳定服务场景设计的,它能最大限度避免下游服务不稳定对上游服务带来的影响。
+
+而相比于熔断后直接返回调用失败信息,配合服务降级能力,我们可以继续调用预先设置好的服务降级逻辑,以降级逻辑的结果作为最终调用结果,以更优雅的返回给服务调用方。
+
+
+
+如上图所示,Dubbo Consumer 依赖的下游的三个 Dubbo 服务,当 Service 3 出现不稳定的情况时(如响应时间变长、错误率增加等),从而 Consumer 调用 Service 3 的线程等资源就会产生堆积,如果此时我们不在 Consumer 侧做任何限制,则 Service 1 与 Service 2 的调用都会受到稳定性影响。通过熔断 Service 3 我们就能保证整个 Dubbo Consumer 服务的稳定性,不拖垮整个 Consumer 服务,熔断 Service 3 的方式可以有很多种实现,包括线程数、信号量、错误率等。
+
+Dubbo 通过集成业界主流的框架实现了服务熔断降级能力
+
+* [Sentinel](../../../tasks/rate-limit/sentinel/)
+* [Hystrix](../../../tasks/rate-limit/hystrix/)
+* [Resilience4J](../../../tasks/rate-limit/resilience4j/)
diff --git a/content/zh-cn/overview/core-features/traffic/mesh-rule.md b/content/zh-cn/overview/core-features/traffic/mesh-rule.md
deleted file mode 100644
index 0d12c29546..0000000000
--- a/content/zh-cn/overview/core-features/traffic/mesh-rule.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/core-features/traffic/mesh-rule/
-description: ""
-linkTitle: 服务网格
-title: 基于服务网格的路由规则
-type: docs
-weight: 5
----
diff --git a/content/zh-cn/overview/home/_index.md b/content/zh-cn/overview/home/_index.md
index 448df08c1d..b247ff3189 100644
--- a/content/zh-cn/overview/home/_index.md
+++ b/content/zh-cn/overview/home/_index.md
@@ -17,14 +17,38 @@ content:
- '[Rust 微服务开发](../quickstart/rust/)'
- '[Node.js 微服务开发](https://github.com/apache/dubbo-js)'
name: 尝试使用 Dubbo 开发微服务
- - description: ""
+ - name: "跟随示例学习 Dubbo"
+ description: ""
+ links:
+ - "[开发服务](../tasks/develop/)"
+ - "[部署服务](../tasks/deploy/)"
+ - "[流量管控](../tasks/traffic-management/)"
+ - "[观测服务](../tasks/observability/)"
+ - "[通信协议](../tasks/protocols/)"
+ - "[常见问题诊断](../tasks/troubleshoot/)"
+ - name: "生产环境的 Dubbo 微服务生态"
+ description: ""
+ links:
+ - "[服务发现&配置&元数据中心](/zh-cn/overview/mannual/java-sdk/reference-manual/registry/)"
+ - "[HTTP 网关](../tasks/ecosystem/gateway/)"
+ - "[保证数据一致性](../tasks/ecosystem/transaction/)"
+ - "[Tracing 全链路追踪](../tasks/observability/tracing/)"
+ - "[自定义扩展](../tasks/extensibility/)"
+ - name: "SDK 参考手册"
+ description: ""
links:
- - '[Java 参考手册](../mannual/java-sdk/)'
- - '[Golang 参考手册](../mannual/golang-sdk/)'
- - '[Rust 参考手册](../mannual/rust-sdk/)'
- - '[Node 参考手册](../mannual/)'
- name: SDK 参考手册
-description: Apache Dubbo 是一款支持多语言的、易用的 web 和 rpc 框架,同时为构建企业级微服务提供服务发现、流量治理、可观测、认证鉴权等能力、工具与最佳实践。
+ - "[Java 参考手册](../mannual/java-sdk/)"
+ - "[Golang 参考手册](../mannual/golang-sdk/)"
+ - "[Rust 参考手册](../mannual/rust-sdk//)"
+ - "[Node 参考手册](https://github.com/apache/dubbo-js)"
+ - name: "关心 Dubbo3"
+ description: ""
+ links:
+ - "[Dubbo3 概述](../what/overview/)"
+ - "[gRPC & HTTP/2 通信协议](../reference/protocols/triple/)"
+ - "[应用级服务发现](../core-features/service-discovery/)"
+ - "[平滑迁移](../../docs3-v2/java-sdk/upgrades-and-compatibility/2.x-to-3.x-compatibility-guide)"
+description: "Apache Dubbo 是一款支持多语言的、易用的 web 和 rpc 框架,同时为构建企业级微服务提供服务发现、流量治理、可观测、认证鉴权等能力、工具与最佳实践。"
hide_feedback: true
hide_summary: true
linkTitle: 主页
@@ -40,9 +64,7 @@ type: docs
weight: 1
---
-
-Apache Dubbo 是一款易用的、提供高性能通信和服务治理能力的微服务开发框架,Dubbo 提供多种语言实现,请通过以下链接跳转到对应语言示例。
-<br/>
+请跟随以下内容,快速了解 Apache Dubbo 的功能、特点与最佳实践吧!
<br/>
<br/>
diff --git a/content/zh-cn/overview/mannual/_index.md b/content/zh-cn/overview/mannual/_index.md
index 91b74f2847..3b6de50651 100755
--- a/content/zh-cn/overview/mannual/_index.md
+++ b/content/zh-cn/overview/mannual/_index.md
@@ -16,15 +16,9 @@ type: docs
weight: 6
---
-
-
-
-
-
-
> 本文档基于 Dubbo3 编写,由于 Dubbo3 完全兼容 2.7 版本用法,因此文档中的通用功能(除 3.x 版本特有功能外)同样适用于 2.7 版本用户。
>
-> 点此可查看[老版本文档](/zh-cn/docsv2.7)
+> 点此可查看 <a href="/zh-cn/docsv2.7" target="_blank">老版本文档</a>
>
@@ -32,7 +26,7 @@ weight: 6
<div class="td-content list-page">
<div class="lead"></div><header class="article-meta">
</header><div class="row">
- <div class="col-sm col-md-6 mb-4 mb-md-0">
+ <div class="col-sm col-md-6 mb-4">
<div class="h-100 card shadow" href="#">
<div class="card-body">
<h4 class="card-title">
@@ -42,7 +36,7 @@ weight: 6
</div>
</div>
</div>
- <div class="col-sm col-md-6 mb-4 mb-md-0">
+ <div class="col-sm col-md-6 mb-4">
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
@@ -52,7 +46,7 @@ weight: 6
</div>
</div>
</div>
- <div class="col-sm col-md-6 mb-4 mb-md-0">
+ <div class="col-sm col-md-6 mb-4">
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
@@ -62,7 +56,7 @@ weight: 6
</div>
</div>
</div>
- <div class="col-sm col-md-6 mb-4 mb-md-0">
+ <div class="col-sm col-md-6 mb-4">
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
@@ -72,7 +66,7 @@ weight: 6
</div>
</div>
</div>
- <div class="col-sm col-md-6 mb-4 mb-md-0">
+ <div class="col-sm col-md-6 mb-4">
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
diff --git a/content/zh-cn/overview/mannual/golang-sdk/preface/design/aop_and_extension.md b/content/zh-cn/overview/mannual/golang-sdk/preface/design/aop_and_extension.md
index e100f92e3f..936ad6b315 100644
--- a/content/zh-cn/overview/mannual/golang-sdk/preface/design/aop_and_extension.md
+++ b/content/zh-cn/overview/mannual/golang-sdk/preface/design/aop_and_extension.md
@@ -8,11 +8,6 @@ title: AOP 与可扩展机制
type: docs
---
-
-
-
-
-
## 1. extension 模块与 init 方法
### 1.1 接口与实现
diff --git a/content/zh-cn/overview/mannual/java-sdk/_index.md b/content/zh-cn/overview/mannual/java-sdk/_index.md
index 350a2b9f06..3d8c8d8b90 100755
--- a/content/zh-cn/overview/mannual/java-sdk/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/_index.md
@@ -17,6 +17,9 @@ content:
- 升级与兼容性:
- description: 3.0 迁移指南
name: '[3.0 迁移指南](upgrades-and-compatibility/)'
+ - 历史版本文档:
+ - description: 历史版本文档
+ name: '[2.x 及早期版本文档](/zh-cn/docsv2.7/)'
description: Java SDK 手册
hide_feedback: true
hide_summary: true
@@ -28,8 +31,4 @@ weight: 1
---
-
-
-
-
{{% docs/content_box %}}
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/_index.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/_index.md
index 82e03d696b..39655bf053 100755
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/_index.md
@@ -14,16 +14,13 @@ weight: 2
-### 什么是可观测性
+## 什么是可观测性
可观测性是从外部观察正在运行的系统的内部状态的能力。它由日志记录、指标和跟踪三大支柱组成。
-### Dubbo可观测性
+## Dubbo 可观测性
为了深入观察Dubbo内部的运行状况,Dubbo可观测性包括许多附加功能,帮助您在将应用程序推向生产时监视和管理应用程序。您可以选择使用HTTP端点或JMX来管理和监视应用程序。审计、运行状况和度量收集也可以自动应用于应用程序。
-### 可观测性
-- [指标埋点](./meter/)
-- [链路追踪](./tracing/)
-- [日志管理](./logging/)
-- [健康检查](./health-information/)
-- [K8S探测器](./kubernetes-probes/)
-- [文档案例](./doc/)
\ No newline at end of file
+## Dubbo Java 可观测性实现
+- [如何开启指标采集](./meter/)
+- [如何开启链路追踪](./tracing/)
+- [日志管理](./logging/)
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/doc.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/doc.md
deleted file mode 100644
index 5353c31100..0000000000
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/doc.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-aliases:
- - /zh/docs3-v2/java-sdk/advanced-features-and-usage/observability/doc/
- - /zh-cn/docs3-v2/java-sdk/advanced-features-and-usage/observability/doc/
-description: 文档案例
-hide_summary: true
-linkTitle: 文档案例
-no_list: true
-title: 文档案例
-type: docs
-weight: 6
----
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/health-information.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/health-information.md
deleted file mode 100644
index 168b890128..0000000000
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/health-information.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-aliases:
- - /zh/docs3-v2/java-sdk/advanced-features-and-usage/observability/health-information/
- - /zh-cn/docs3-v2/java-sdk/advanced-features-and-usage/observability/health-information/
-description: 健康检查
-hide_summary: true
-linkTitle: 健康检查
-no_list: true
-title: 健康检查
-type: docs
-weight: 4
----
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/kubernetes-probes.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/kubernetes-probes.md
deleted file mode 100644
index aff342c533..0000000000
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/kubernetes-probes.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-aliases:
- - /zh/docs3-v2/java-sdk/advanced-features-and-usage/observability/kubernetes-probes/
- - /zh-cn/docs3-v2/java-sdk/advanced-features-and-usage/observability/kubernetes-probes/
-description: K8S探测器
-hide_summary: true
-linkTitle: K8S探测器
-no_list: true
-title: K8S探测器
-type: docs
-weight: 5
----
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/logging.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/logging.md
index 6e9d4bb7ba..a8aa882545 100644
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/logging.md
+++ b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/logging.md
@@ -11,11 +11,6 @@ type: docs
weight: 3
---
-
-
-
-
-
在 Dubbo 框架内所有的日志输出都是通过 LoggerFactory 这个静态工厂类来获得 Logger 的对象实体,并且抽离了一个 LoggerAdapter 用于对接第三方日志框架,所以就有了JDKLoggerAdapter, Log4jLoggerAdapter, SLF4JLoggerAdapter等一些实现子类,分别对接了不同 Log 第三方实现。既然 Dubbo 能够支持这么多log实现,那么这些实现在 Dubbo 中优先级是在呢么样的呢?这里的优先级是指未配置指定的 logger 提供方的情况下,由 Dubbo 框架自己选择。优先级如下:
| 第三方日志框架 | 优先级 |
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/meter.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/meter.md
index dbf582d4a1..f3047b745d 100644
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/meter.md
+++ b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/meter.md
@@ -2,39 +2,52 @@
aliases:
- /zh/docs3-v2/java-sdk/advanced-features-and-usage/observability/meter/
- /zh-cn/docs3-v2/java-sdk/advanced-features-and-usage/observability/meter/
-description: 指标埋点
+description: "开启 Metrics 指标埋点"
hide_summary: true
-linkTitle: 指标埋点
+linkTitle: Metrics
no_list: true
-title: 指标埋点
+title: Metrics
type: docs
weight: 1
---
+## 概述
+Dubbo Metrics 的总体设计请参考 [可观测性 Metrics Proposal](/zh-cn/overview/reference/proposals/metrics/)。
+以下是 Dubbo Java 相关的具体实现与使用方式讲解。
+## 使用方式
+要为 Dubbo 进程开启指标采集,需要在项目中引入相关依赖并增加配置。以 Spring Boot 项目为例,增加以下 spring-boot-starter 依赖到项目中,即会自动开启指标采集。
-# 概述
+```xml
+<!-- https://mvnrepository.com/artifact/org.apache.dubbo/dubbo-metrics-prometheus -->
+<dependency>
+ <groupId>org.apache.dubbo</groupId>
+ <artifactId>dubbo-spring-boot-observability-starter</artifactId>
+ <version>3.2.0</version>
+</dependency>
+```
-## 1. 指标接入说明
+* 完整示例请参见 <a href="https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-metrics-spring-boot" target="_blank">dubbo-samples-metrics-spring-boot</a>
+* 完整配置参数请参见 [Metrics 配置项手册](../../../reference-manual/config/properties/)
-## 2. 指标体系设计
- Dubbo的指标体系,总共涉及三块,指标收集、本地聚合、指标推送
- 指标收集:将Dubbo内部需要监控的指标推送至统一的Collector中进行存储
- 本地聚合:指标收集获取的均为基础指标,而一些分位数指标则需通过本地聚合计算得出
- 指标推送:收集和聚合后的指标通过一定的方式推送至第三方服务器,目前只涉及Prometheus
-## 3. 结构设计
+## 实现原理解析
+
+### 代码结构与工作流程
- 移除原来与 Metrics 相关的类
- 创建新模块 dubbo-metrics/dubbo-metrics-api、dubbo-metrics/dubbo-metrics-prometheus,MetricsConfig 作为该模块的配置类
- 使用micrometer,在Collector中使用基本类型代表指标,如Long、Double等,并在dubbo-metrics-api中引入micrometer,由micrometer对内部指标进行转换
-## 4. 数据流转
- 
+以下是 Dubbo 实现中的关键组件及数据流转过程
+
+
-## 5. 目标
- 指标接口将提供一个 MetricsService,该 Service 不仅提供柔性服务所的接口级数据,也提供所有指标的查询方式,其中方法级指标的查询的接口可按如下方式声明
+### 指标上报接口
+根据上图架构,指标接口是 Dubbo 对外暴露指标数据的出口,以下是指标接口的具体定义:
+
+> 另外,该 Service 还作为一些 [智能自适应流量调度算法](/zh-cn/overview/reference/proposals/heuristic-flow-control/) 的数据来源
```java
public interface MetricsService {
@@ -98,12 +111,13 @@ public class MetricsEntity {
}
```
-# 指标收集
-## 1. 嵌入位置
- Dubbo 架构图如下
- 
+### 指标采集埋点
+
+Dubbo 是通过扩展 Filter SPI 扩展点实现对请求调用指标进行拦截的,目前在消费端和提供端分别增加了 Filter 扩展实现
+* MetricsFilter 提供端请求指标埋点
+* MetricsClusterFilter 消费端请求指标埋点
-在 provider 中添加一层 MetricsFilter 重写 invoke 方法嵌入调用链路用于收集指标,用 try-catch-finally 处理,核心代码如下
+以下是 MetricsFilter 的实现源码,注意 try-catch-finally 处理。
```java
@Activate(group = PROVIDER, order = -1)
@@ -131,9 +145,9 @@ public class MetricsFilter implements Filter, ScopeModelAware {
```
+### 指标统计单位
+以下五个属性是指标统计的基本单位(应用、服务、方法的组合),也是源代码 MetricsCollector 中 Map 数据结构的 key
-## 2. 指标标识
- 用以下五个属性作为隔离级别区分标识不同方法,也是各个 ConcurrentHashMap 的 key
```java
public class MethodMetric {
private String applicationName;
@@ -144,8 +158,9 @@ public class MethodMetric {
}
```
-## 3. 基础指标
- 指标通过 common 模块下的 MetricsCollector 存储所有指标数据
+### 基础指标
+
+dubbo-common 模块下的 MetricsCollector 负责存储所有指标数据
```java
public class DefaultMetricsCollector implements MetricsCollector {
@@ -168,188 +183,31 @@ public class DefaultMetricsCollector implements MetricsCollector {
}
```
-# 本地聚合
-本地聚合指将一些简单的指标通过计算获取各分位数指标的过程
-## 1. 参数设计
- 收集指标时,默认只收集基础指标,而一些单机聚合指标则需要开启服务柔性或者本地聚合后另起线程计算。此处若开启服务柔性,则本地聚合默认开启
+### 本地指标聚合
-### 1.1 本地聚合开启方式
-```xml
-<dubbo:metrics>
- <dubbo:aggregation enable="true" />
-</dubbo:metrics>
-```
+本地聚合指将一些简单的指标通过计算获取各分位数指标的过程。
-### 1.2 指标聚合参数
-```xml
-<dubbo:metrics>
- <dubbo:aggregation enable="true" bucket-num="5" time-window-seconds="10"/>
-</dubbo:metrics>
-```
+#### 开启本地聚合
-## 2. 具体指标
+收集指标时,默认只收集基础指标,而一些单机聚合指标则需要开启服务柔性或者本地聚合后另起线程计算。
-四个需要监控的关键指标。他们称之为“四个黄金信号”:延迟(Latency),流量(Traffic),错误(Errors)和饱和度(Saturation)。
-在Dubbo中主要包含如下监控指标:
+```properties
+dubbo.metrics.enable=true
+```
-| | 基础设施 | 业务监控 |
-| :------- | :----------------------------------------------------------- |:-----------------------------|
-| 延迟类 | IO 等待; 网络延迟; | 接口、服务的平均耗时、TP90、TP99、TP999 等 |
-| 流量类 | 网络和磁盘 IO; | 服务层面的 QPS、 |
-| 错误类 | 宕机; 磁盘(坏盘或文件系统错误); 进程或端口挂掉; 网络丢包; | 错误日志;业务状态码、错误码走势; |
-| 饱和度类 | 系统资源利用率: CPU、内存、磁盘、网络等; 饱和度:等待线程数,队列积压长度; | 这里主要包含JVM、线程池等|
+另外,还可以设置一些更多的指标
+```properties
+dubbo.metrics.aggregation.enable=true
+dubbo.metrics.aggregation.bucket-num=5
+dubbo.metrics.aggregation.time-window-seconds=10
+```
-- qps: 基于滑动窗口获取动态qps
-- rt: 基于滑动窗口获取动态rt
-- 失败请求数: 基于滑动窗口获取最近时间内的失败请求数
-- 成功请求数: 基于滑动窗口获取最近时间内的成功请求数
-- 处理中请求数: 前后增加Filter简单统计
-- 具体指标依赖滑动窗口,额外使用 AggregateMetricsCollector 收集
+#### 具体指标
+[具体指标](/zh-cn/overview/reference/metrics/standard_metrics/) 请参考 Dubbo Metrics 总体设计文档。
-输出到普罗米修斯的相关指标可以参考的内容如下:
-```
-# HELP jvm_gc_live_data_size_bytes Size of long-lived heap memory pool after reclamation
-# TYPE jvm_gc_live_data_size_bytes gauge
-jvm_gc_live_data_size_bytes 1.6086528E7
-# HELP requests_succeed_aggregate Aggregated Succeed Requests
-# TYPE requests_succeed_aggregate gauge
-requests_succeed_aggregate{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 39.0
-# HELP jvm_buffer_memory_used_bytes An estimate of the memory that the Java virtual machine is using for this buffer pool
-# TYPE jvm_buffer_memory_used_bytes gauge
-jvm_buffer_memory_used_bytes{id="direct",} 1.679975E7
-jvm_buffer_memory_used_bytes{id="mapped",} 0.0
-# HELP jvm_gc_memory_allocated_bytes_total Incremented for an increase in the size of the (young) heap memory pool after one GC to before the next
-# TYPE jvm_gc_memory_allocated_bytes_total counter
-jvm_gc_memory_allocated_bytes_total 2.9884416E9
-# HELP requests_total_aggregate Aggregated Total Requests
-# TYPE requests_total_aggregate gauge
-requests_total_aggregate{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 39.0
-# HELP system_load_average_1m The sum of the number of runnable entities queued to available processors and the number of runnable entities running on the available processors averaged over a period of time
-# TYPE system_load_average_1m gauge
-system_load_average_1m 0.0
-# HELP system_cpu_usage The "recent cpu usage" for the whole system
-# TYPE system_cpu_usage gauge
-system_cpu_usage 0.015802269043760128
-# HELP jvm_threads_peak_threads The peak live thread count since the Java virtual machine started or peak was reset
-# TYPE jvm_threads_peak_threads gauge
-jvm_threads_peak_threads 40.0
-# HELP requests_processing Processing Requests
-# TYPE requests_processing gauge
-requests_processing{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 0.0
-# HELP jvm_memory_max_bytes The maximum amount of memory in bytes that can be used for memory management
-# TYPE jvm_memory_max_bytes gauge
-jvm_memory_max_bytes{area="nonheap",id="CodeHeap 'profiled nmethods'",} 1.22912768E8
-jvm_memory_max_bytes{area="heap",id="G1 Survivor Space",} -1.0
-jvm_memory_max_bytes{area="heap",id="G1 Old Gen",} 9.52107008E8
-jvm_memory_max_bytes{area="nonheap",id="Metaspace",} -1.0
-jvm_memory_max_bytes{area="heap",id="G1 Eden Space",} -1.0
-jvm_memory_max_bytes{area="nonheap",id="CodeHeap 'non-nmethods'",} 5828608.0
-jvm_memory_max_bytes{area="nonheap",id="Compressed Class Space",} 1.073741824E9
-jvm_memory_max_bytes{area="nonheap",id="CodeHeap 'non-profiled nmethods'",} 1.22916864E8
-# HELP jvm_threads_states_threads The current number of threads having BLOCKED state
-# TYPE jvm_threads_states_threads gauge
-jvm_threads_states_threads{state="blocked",} 0.0
-jvm_threads_states_threads{state="runnable",} 10.0
-jvm_threads_states_threads{state="waiting",} 16.0
-jvm_threads_states_threads{state="timed-waiting",} 13.0
-jvm_threads_states_threads{state="new",} 0.0
-jvm_threads_states_threads{state="terminated",} 0.0
-# HELP jvm_buffer_total_capacity_bytes An estimate of the total capacity of the buffers in this pool
-# TYPE jvm_buffer_total_capacity_bytes gauge
-jvm_buffer_total_capacity_bytes{id="direct",} 1.6799749E7
-jvm_buffer_total_capacity_bytes{id="mapped",} 0.0
-# HELP rt_p99 Response Time P99
-# TYPE rt_p99 gauge
-rt_p99{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 1.0
-# HELP jvm_memory_used_bytes The amount of used memory
-# TYPE jvm_memory_used_bytes gauge
-jvm_memory_used_bytes{area="heap",id="G1 Survivor Space",} 1048576.0
-jvm_memory_used_bytes{area="nonheap",id="CodeHeap 'profiled nmethods'",} 1.462464E7
-jvm_memory_used_bytes{area="heap",id="G1 Old Gen",} 1.6098728E7
-jvm_memory_used_bytes{area="nonheap",id="Metaspace",} 4.0126952E7
-jvm_memory_used_bytes{area="heap",id="G1 Eden Space",} 8.2837504E7
-jvm_memory_used_bytes{area="nonheap",id="CodeHeap 'non-nmethods'",} 1372032.0
-jvm_memory_used_bytes{area="nonheap",id="Compressed Class Space",} 4519248.0
-jvm_memory_used_bytes{area="nonheap",id="CodeHeap 'non-profiled nmethods'",} 5697408.0
-# HELP qps Query Per Seconds
-# TYPE qps gauge
-qps{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 0.3333333333333333
-# HELP rt_min Min Response Time
-# TYPE rt_min gauge
-rt_min{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 0.0
-# HELP jvm_buffer_count_buffers An estimate of the number of buffers in the pool
-# TYPE jvm_buffer_count_buffers gauge
-jvm_buffer_count_buffers{id="mapped",} 0.0
-jvm_buffer_count_buffers{id="direct",} 10.0
-# HELP system_cpu_count The number of processors available to the Java virtual machine
-# TYPE system_cpu_count gauge
-system_cpu_count 2.0
-# HELP jvm_classes_loaded_classes The number of classes that are currently loaded in the Java virtual machine
-# TYPE jvm_classes_loaded_classes gauge
-jvm_classes_loaded_classes 7325.0
-# HELP rt_total Total Response Time
-# TYPE rt_total gauge
-rt_total{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 2783.0
-# HELP rt_last Last Response Time
-# TYPE rt_last gauge
-rt_last{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 0.0
-# HELP jvm_gc_memory_promoted_bytes_total Count of positive increases in the size of the old generation memory pool before GC to after GC
-# TYPE jvm_gc_memory_promoted_bytes_total counter
-jvm_gc_memory_promoted_bytes_total 1.4450952E7
-# HELP jvm_gc_pause_seconds Time spent in GC pause
-# TYPE jvm_gc_pause_seconds summary
-jvm_gc_pause_seconds_count{action="end of minor GC",cause="Metadata GC Threshold",} 2.0
-jvm_gc_pause_seconds_sum{action="end of minor GC",cause="Metadata GC Threshold",} 0.026
-jvm_gc_pause_seconds_count{action="end of minor GC",cause="G1 Evacuation Pause",} 37.0
-jvm_gc_pause_seconds_sum{action="end of minor GC",cause="G1 Evacuation Pause",} 0.156
-# HELP jvm_gc_pause_seconds_max Time spent in GC pause
-# TYPE jvm_gc_pause_seconds_max gauge
-jvm_gc_pause_seconds_max{action="end of minor GC",cause="Metadata GC Threshold",} 0.0
-jvm_gc_pause_seconds_max{action="end of minor GC",cause="G1 Evacuation Pause",} 0.0
-# HELP rt_p95 Response Time P95
-# TYPE rt_p95 gauge
-rt_p95{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 0.0
-# HELP requests_total Total Requests
-# TYPE requests_total gauge
-requests_total{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 27738.0
-# HELP process_cpu_usage The "recent cpu usage" for the Java Virtual Machine process
-# TYPE process_cpu_usage gauge
-process_cpu_usage 8.103727714748784E-4
-# HELP rt_max Max Response Time
-# TYPE rt_max gauge
-rt_max{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 4.0
-# HELP jvm_gc_max_data_size_bytes Max size of long-lived heap memory pool
-# TYPE jvm_gc_max_data_size_bytes gauge
-jvm_gc_max_data_size_bytes 9.52107008E8
-# HELP jvm_threads_live_threads The current number of live threads including both daemon and non-daemon threads
-# TYPE jvm_threads_live_threads gauge
-jvm_threads_live_threads 39.0
-# HELP jvm_threads_daemon_threads The current number of live daemon threads
-# TYPE jvm_threads_daemon_threads gauge
-jvm_threads_daemon_threads 36.0
-# HELP jvm_classes_unloaded_classes_total The total number of classes unloaded since the Java virtual machine has started execution
-# TYPE jvm_classes_unloaded_classes_total counter
-jvm_classes_unloaded_classes_total 0.0
-# HELP jvm_memory_committed_bytes The amount of memory in bytes that is committed for the Java virtual machine to use
-# TYPE jvm_memory_committed_bytes gauge
-jvm_memory_committed_bytes{area="nonheap",id="CodeHeap 'profiled nmethods'",} 1.4680064E7
-jvm_memory_committed_bytes{area="heap",id="G1 Survivor Space",} 1048576.0
-jvm_memory_committed_bytes{area="heap",id="G1 Old Gen",} 5.24288E7
-jvm_memory_committed_bytes{area="nonheap",id="Metaspace",} 4.1623552E7
-jvm_memory_committed_bytes{area="heap",id="G1 Eden Space",} 9.0177536E7
-jvm_memory_committed_bytes{area="nonheap",id="CodeHeap 'non-nmethods'",} 2555904.0
-jvm_memory_committed_bytes{area="nonheap",id="Compressed Class Space",} 5111808.0
-jvm_memory_committed_bytes{area="nonheap",id="CodeHeap 'non-profiled nmethods'",} 5701632.0
-# HELP requests_succeed Succeed Requests
-# TYPE requests_succeed gauge
-requests_succeed{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 27738.0
-# HELP rt_avg Average Response Time
-# TYPE rt_avg gauge
-rt_avg{application_name="metrics-provider",group="",hostname="iZ8lgm9icspkthZ",interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService",ip="172.28.236.104",method="sayHello",version="",} 0.0
-```
+#### 聚合收集器实现
-## 聚合收集器
```java
public class AggregateMetricsCollector implements MetricsCollector, MetricsListener {
private int bucketNum;
@@ -393,7 +251,7 @@ private void registerListener() {
}
```
-## 3. 指标聚合
+### 指标聚合原理
滑动窗口
假设我们初始有6个bucket,每个窗口时间设置为2分钟
每次写入指标数据时,会将数据分别写入6个bucket内,每隔两分钟移动一个bucket并且清除原来bucket内的数据
@@ -457,70 +315,17 @@ public class TimeWindowQuantile {
}
```
-# 指标推送
-指标推送只有用户在设置了<dubbo:metrics />配置且配置protocol参数后才开启,若只开启指标聚合,则默认不推送指标。
-## 1. Promehteus Pull ServiceDiscovery
- 使用dubbo-admin等类似的中间层,启动时根据配置将本机 IP、Port、MetricsURL 推送地址信息至dubbo-admin(或任意中间层)的方式,暴露HTTP ServiceDiscovery供prometheus读取,配置方式如<dubbo:metrics protocol="prometheus" mode="pull" address="${dubbo-admin.address}" port="20888" url="/metrics"/>,其中在pull模式下address为可选参数,若不填则需用户手动在Prometheus配置文件中配置地址
-
-```java
-private void exportHttpServer() {
- boolean exporterEnabled = url.getParameter(PROMETHEUS_EXPORTER_ENABLED_KEY, false);
- if (exporterEnabled) {
- int port = url.getParameter(PROMETHEUS_EXPORTER_METRICS_PORT_KEY, PROMETHEUS_DEFAULT_METRICS_PORT);
- String path = url.getParameter(PROMETHEUS_EXPORTER_METRICS_PATH_KEY, PROMETHEUS_DEFAULT_METRICS_PATH);
- if (!path.startsWith("/")) {
- path = "/" + path;
- }
+### 指标推送
- try {
- prometheusExporterHttpServer = HttpServer.create(new InetSocketAddress(port), 0);
- prometheusExporterHttpServer.createContext(path, httpExchange -> {
- String response = prometheusRegistry.scrape();
- httpExchange.sendResponseHeaders(200, response.getBytes().length);
- try (OutputStream os = httpExchange.getResponseBody()) {
- os.write(response.getBytes());
- }
- });
-
- httpServerThread = new Thread(prometheusExporterHttpServer::start);
- httpServerThread.start();
- } catch (IOException e) {
- throw new RuntimeException(e);
- }
- }
-}
-```
+指标推送只有用户在设置了 `dubbo.metrics.protocol=prometheus` 参数后才开启,若只开启指标聚合,则默认不推送指标。
-## 2. Prometheus Push Pushgateway
-用户直接在Dubbo配置文件中配置Prometheus Pushgateway的地址即可,如<dubbo:metrics protocol="prometheus" mode="push" address="${prometheus.pushgateway-url}" interval="5" />,其中interval代表推送间隔
+#### Prometheus Pull Service Discovery
-```java
+目前 Dubbo Admin 内置了 prometheus http_sd service discovery 实例地址发现机制,Admin 默认会使用 `qos 端口`、 `/metrics` 作为这样 Admin 就能够将所有示例地址汇聚后以标准 http_sd 的方式同步给 Prometheus Server。
-private void schedulePushJob() {
- boolean pushEnabled = url.getParameter(PROMETHEUS_PUSHGATEWAY_ENABLED_KEY, false);
- if (pushEnabled) {
- String baseUrl = url.getParameter(PROMETHEUS_PUSHGATEWAY_BASE_URL_KEY);
- String job = url.getParameter(PROMETHEUS_PUSHGATEWAY_JOB_KEY, PROMETHEUS_DEFAULT_JOB_NAME);
- int pushInterval = url.getParameter(PROMETHEUS_PUSHGATEWAY_PUSH_INTERVAL_KEY, PROMETHEUS_DEFAULT_PUSH_INTERVAL);
- String username = url.getParameter(PROMETHEUS_PUSHGATEWAY_USERNAME_KEY);
- String password = url.getParameter(PROMETHEUS_PUSHGATEWAY_PASSWORD_KEY);
-
- NamedThreadFactory threadFactory = new NamedThreadFactory("prometheus-push-job", true);
- pushJobExecutor = Executors.newScheduledThreadPool(1, threadFactory);
- PushGateway pushGateway = new PushGateway(baseUrl);
- if (!StringUtils.isBlank(username)) {
- pushGateway.setConnectionFactory(new BasicAuthHttpConnectionFactory(username, password));
- }
+具体配置方式如下
- pushJobExecutor.scheduleWithFixedDelay(() -> push(pushGateway, job), pushInterval, pushInterval, TimeUnit.SECONDS);
- }
-}
-protected void push(PushGateway pushGateway, String job) {
- try {
- pushGateway.pushAdd(prometheusRegistry.getPrometheusRegistry(), job);
- } catch (IOException e) {
- logger.error("Error occurred when pushing metrics to prometheus: ", e);
- }
-}
-```
\ No newline at end of file
+其中,address、port、url 均是可选项,如不配置则 Admin 使用默认约定值。
+
+> 用户直接在Dubbo配置文件中配置Prometheus Pushgateway的地址即可,如<dubbo:metrics protocol="prometheus" mode="push" address="${prometheus.pushgateway-url}" interval="5" />,其中interval代表推送间隔
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/tracing.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/tracing.md
index b1a651d18d..3f9b07077f 100644
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/tracing.md
+++ b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/observability/tracing.md
@@ -10,3 +10,31 @@ title: 链路追踪
type: docs
weight: 2
---
+
+## 概述
+Dubbo 内置了全链路追踪能力,你可以通过引入 spring-boot-starter 或者相关依赖开启链路跟踪能力,通过将跟踪数据导出到一些主流实现如 Zipkin、Skywalking、Jaeger 等后端系统,可以实现全链路跟踪数据的分析与可视化展示。
+
+Dubbo 目前借助 Micrometer Observation 完成 Tracing 的所有埋点工作,依赖 Micrometer 提供的各种 Bridge 适配,我们可以实现将 Tracing 导入各种后端系统,具体工作原理如下。
+
+
+
+## 使用方式
+
+以 Dubbo Spring Boot 应用为例,通过加入如下依赖即可开启链路追踪,并使用 zipkin exporter bridge 将链路追踪数据导入 Zipkin 后端系统。
+
+```xml
+<dependency>
+ <groupId>org.apache.dubbo</groupId>
+ <artifactId>dubbo-spring-boot-tracing-otel-zipkin-starter</artifactId>
+ <version>3.2.1-SNAPSHOT</version>
+</dependency>
+```
+
+更多完整示例请参见:
+* [使用 Zipkin 实现 Dubbo 全链路追踪](/zh-cn/overview/tasks/observability/tracing/zipkin/)
+* [使用 Skywalking 实现 Dubbo 全链路追踪](/zh-cn/overview/tasks/observability/tracing/skywalking/)
+
+## 关联日志
+
+Dubbo Tracing 还实现了与日志系统的自动关联,即将 tracing-id、span-id 等信息自动置入日志 MDC 上下文,你只需要设置日志输出格式中包含类似 `%X{traceId:-},%X{spanId:-}]`,即可实现业务日志与 tracing 系统的自动关联,具体可参见 [Tracing 日志上下文配置示例](https://github.com/apache/dubbo-samples/blob/master/4-governance/dubbo-samples-spring-boot-tracing/dubbo-samples-spring-boot-tracing-provider/src/main/resources/application.yml#L46)。
+
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/adaptive-concurrency-control.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/adaptive-concurrency-control.md
new file mode 100644
index 0000000000..d7785ad713
--- /dev/null
+++ b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/adaptive-concurrency-control.md
@@ -0,0 +1,43 @@
+---
+description: 自适应限流
+linkTitle: 自适应限流
+title: 自适应限流
+type: docs
+weight: 28
+---
+
+自适应限流的设计与实现思路请参考 [Dubbo 自适应限流功能](../../../../../reference/proposals/heuristic-flow-control/)。
+
+## 使用方式
+
+设置方法与静态的最大并发值设置类似,只需在服务端设置 flowcontrol 参数即可,可选值有以下两种:
+* heuristicSmoothingFlowControl。当服务端收到一个请求时,首先判断CPU的使用率是否超过50%。如果没有超过50%,则接受这个请求进行处理。如果超过50%,说明当前的负载较高,便从 HeuristicSmoothingFlowControl 算法中获得当前的 maxConcurrency 值。如果当前正在处理的请求数量超过了 maxConcurrency,则拒绝该请求。
+* autoConcurrencyLimier。与 HeuristicSmoothingFlowControl 的最大区别是,AutoConcurrencyLimier 是基于窗口的,每当窗口内积累了一定量的采样数据时,才利用窗口内的数据来更新得到 maxConcurrency,其次,利用exploreRatio来对剩余的容量进行探索。
+
+> 在确保服务端存在多个节点,并且消费端开启重试策略的前提下,限流功能才能更好的发挥作用。
+
+### 示例一:使用 heuristicSmoothingFlowControl 自适应限流算法
+
+```properties
+dubbo.provider.flowcontrol=heuristicSmoothingFlowControl
+```
+
+```xml
+<dubbo:provider flowcontrol="heuristicSmoothingFlowControl" />
+```
+
+### 示例二:使用 autoConcurrencyLimiter 自适应限流算法
+```properties
+dubbo.provider.flowcontrol=autoConcurrencyLimiter
+```
+
+```xml
+<dubbo:provider flowcontrol="autoConcurrencyLimiter" />
+```
+
+### 示例三:设置服务粒度的 heuristicSmoothingFlowControl 自适应限流
+
+```xml
+<dubbo:service interface="com.foo.BarService" flowcontrol="heuristicSmoothingFlowControl" />
+```
+
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/concurrency-control.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/concurrency-control.md
index 556fa3c988..ecb6926064 100644
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/concurrency-control.md
+++ b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/concurrency-control.md
@@ -10,9 +10,6 @@ weight: 28
---
-
-
-
## 功能说明
多种并发控制功能,帮助用户管理其应用程序和服务。
@@ -25,6 +22,8 @@ weight: 28
确保服务在高峰使用时间保持可靠和稳定。
+这种方式要求用户准确的预先评估系统能处理的并发数,而准确的评估系统处理能力并不是一件容易的事情,因此 Dubbo 还提供了自适应限流模式,根据系统负载自动识别系统健康程度并进行限流保护,可以在此 [查看使用文档](../adaptive-concurrency-control)。
+
## 使用方式
### 样例一
diff --git a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/loadbalance.md b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/loadbalance.md
index 70cca51fb1..ddaa0945b8 100644
--- a/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/loadbalance.md
+++ b/content/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/loadbalance.md
@@ -9,83 +9,26 @@ type: docs
weight: 3
---
-
-
-
-
## 功能说明
-在集群负载均衡时,Dubbo 提供了多种均衡策略,缺省为 `random` 随机调用。
-
-具体实现上,Dubbo 提供的是客户端负载均衡,即由 Consumer 通过负载均衡算法得出需要将请求提交到哪个 Provider 实例。
-
-可以自行扩展负载均衡策略,参见:[负载均衡扩展](../../../reference-manual/spi/description/load-balance)
+* [Dubbo 负载均衡算法说明](/zh-cn/overview/core-features/load-balance/)
+* 如果要扩展更多负载均衡策略,参见 [Java SPI 负载均衡扩展](../../../reference-manual/spi/description/load-balance)
-### 负载均衡策略
目前 Dubbo 内置了如下负载均衡算法,用户可直接配置使用:
-| 算法 | 特性 | 备注 |
-| :-------------------------- | :---------------------- | :---------------------------------------------- |
-| RandomLoadBalance | 加权随机 | 默认算法,默认权重相同 |
-| RoundRobinLoadBalance | 加权轮询 | 借鉴于 Nginx 的平滑加权轮询算法,默认权重相同, |
-| LeastActiveLoadBalance | 最少活跃优先 + 加权随机 | 背后是能者多劳的思想 |
-| ShortestResponseLoadBalance | 最短响应优先 + 加权随机 | 更加关注响应速度 |
-| ConsistentHashLoadBalance | 一致性 Hash | 确定的入参,确定的提供者,适用于有状态请求 |
-
-
-
-### Random
-
-* **加权随机**,按权重设置随机概率。
-* 在一个截面上碰撞的概率高,但调用量越大分布越均匀,而且按概率使用权重后也比较均匀,有利于动态调整提供者权重。
-* 缺点:存在慢的提供者累积请求的问题,比如:第二台机器很慢,但没挂,当请求调到第二台时就卡在那,久而久之,所有请求都卡在调到第二台上。
-
-### RoundRobin
-* **加权轮询**,按公约后的权重设置轮询比率,循环调用节点
-* 缺点:同样存在慢的提供者累积请求的问题。
-
-加权轮询过程过程中,如果某节点权重过大,会存在某段时间内调用过于集中的问题。
-例如 ABC 三节点有如下权重:`{A: 3, B: 2, C: 1}`
-那么按照最原始的轮询算法,调用过程将变成:`A A A B B C`
-
-对此,Dubbo 借鉴 Nginx 的平滑加权轮询算法,对此做了优化,调用过程可抽象成下表:
-
-| 轮前加和权重 | 本轮胜者 | 合计权重 | 轮后权重(胜者减去合计权重) |
-| :------------------ | :------- | :------- | :--------------------------- |
-| 起始轮 | \ | \ | `A(0), B(0), C(0)` |
-| `A(3), B(2), C(1)` | A | 6 | `A(-3), B(2), C(1)` |
-| `A(0), B(4), C(2)` | B | 6 | `A(0), B(-2), C(2)` |
-| `A(3), B(0), C(3)` | A | 6 | `A(-3), B(0), C(3)` |
-| `A(0), B(2), C(4)` | C | 6 | `A(0), B(2), C(-2)` |
-| `A(3), B(4), C(-1)` | B | 6 | `A(3), B(-2), C(-1)` |
-| `A(6), B(0), C(0)` | A | 6 | `A(0), B(0), C(0)` |
-
-我们发现经过合计权重(3+2+1)轮次后,循环又回到了起点,整个过程中节点流量是平滑的,且哪怕在很短的时间周期内,概率都是按期望分布的。
-
-如果用户有加权轮询的需求,可放心使用该算法。
-
-### LeastActive
-* **加权最少活跃调用优先**,活跃数越低,越优先调用,相同活跃数的进行加权随机。活跃数指调用前后计数差(针对特定提供者:请求发送数 - 响应返回数),表示特定提供者的任务堆积量,活跃数越低,代表该提供者处理能力越强。
-* 使慢的提供者收到更少请求,因为越慢的提供者的调用前后计数差会越大;相对的,处理能力越强的节点,处理更多的请求。
-
-### ShortestResponse
-* **加权最短响应优先**,在最近一个滑动窗口中,响应时间越短,越优先调用。相同响应时间的进行加权随机。
-* 使得响应时间越快的提供者,处理更多的请求。
-* 缺点:可能会造成流量过于集中于高性能节点的问题。
-
-这里的响应时间 = 某个提供者在窗口时间内的平均响应时间,窗口时间默认是 30s。
-
-
-### ConsistentHash
-* **一致性 Hash**,相同参数的请求总是发到同一提供者。
-* 当某一台提供者挂时,原本发往该提供者的请求,基于虚拟节点,平摊到其它提供者,不会引起剧烈变动。
-* 算法参见:[Consistent Hashing | WIKIPEDIA](http://en.wikipedia.org/wiki/Consistent_hashing)
-* 缺省只对第一个参数 Hash,如果要修改,请配置 `<dubbo:parameter key="hash.arguments" value="0,1" />`
-* 缺省用 160 份虚拟节点,如果要修改,请配置 `<dubbo:parameter key="hash.nodes" value="320" />`
-
-## 使用场景
+| 算法 | 特性 | 备注 | 配置值 |
+| :-------------------------- | :---------------------- | :---------------------------------------------- | :---------------------------------------------- |
+| Weighted Random LoadBalance | 加权随机 | 默认算法,默认权重相同 | random (默认) |
+| RoundRobin LoadBalance | 加权轮询 | 借鉴于 Nginx 的平滑加权轮询算法,默认权重相同, | roundrobin |
+| LeastActive LoadBalance | 最少活跃优先 + 加权随机 | 背后是能者多劳的思想 | leastactive |
+| Shortest-Response LoadBalance | 最短响应优先 + 加权随机 | 更加关注响应速度 | shortestresponse |
+| ConsistentHash LoadBalance | 一致性哈希 | 确定的入参,确定的提供者,适用于有状态请求 | consistenthash |
+| P2C LoadBalance | Power of Two Choice | 随机选择两个节点后,继续选择“连接数”较小的那个节点。 | p2c |
+| Adaptive LoadBalance | 自适应负载均衡 | 在 P2C 算法基础上,选择二者中 load 最小的那个节点 | adaptive |
## 使用方式
+> 只需要调整 `loadbalance` 相应取值即可,每种负载均衡策略取值请参见文档最上方表格。
+
### 服务端服务级别
```xml
diff --git a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/triple.md b/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/triple.md
deleted file mode 100644
index 99f61cc26b..0000000000
--- a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/triple.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-aliases:
- - /zh/docs3-v2/java-sdk/concepts-and-architecture/triple/
- - /zh-cn/docs3-v2/java-sdk/concepts-and-architecture/triple/
-description: 本文将介绍 Dubbo 的 Triple 协议。
-linkTitle: Triple 协议
-title: Triple 协议
-type: docs
-weight: 6
----
-
-
-
-
-
-### 协议说明
-Triple 是 Dubbo3 提出的基于 HTTP2 的开放协议,旨在解决 Dubbo2 私有协议带来的互通性问题。相比于原有 Dubbo2 协议,Triple 有以下优势:
-
-1. 原生和 gRPC 协议互通。打通 gRPC 生态,降低从 gRPC 至 Dubbo 的迁移成本。
-2. 增强多语言生态。避免因 CPP/C#/RUST 等语言的 Dubbo SDK 能力不足导致业务难以选型适配的问题。
-3. 网关友好。网关无需参与序列化,方便用户从传统的 HTTP 转泛化 Dubbo 调用网关升级至开源或云厂商的 Ingress 方案。
-4. 完善的异步和流式支持。带来从底层协议到上层业务的性能提升,易于构建全链路异步以及严格保证消息顺序的流式服务。
-
-**目前 Java 和 Go 的 Dubbo SDK 已全面支持 Triple 协议。** 在阿里巴巴,Triple 协议广泛用于跨环境、跨语言、跨生态互通,已有数十万容器生产级使用。
-
-### 支持方式
-Java SDK 支持 [IDL 生成 Stub](/zh-cn/overview/mannual/java-sdk/quick-start/idl)
-和 [Java Interface](/zh-cn/overview/mannual/java-sdk/quick-start/idl) 两种方式,多语言、生态互通、流式需求推荐使用 IDL 方式,现有服务平滑升级推荐使用
-Interface 方式。
-
-- Dubbo2 老用户如何从现有协议升级至 Triple(TBD)
-- 新用户或业务参考 [Dubbo3 Triple Quick Start](/zh-cn/overview/mannual/java-sdk/quick-start/idl/)
-- 深入了解 Triple 协议: [Dubbo3 Triple 协议设计与原理](https://github.com/apache/dubbo-awesome/blob/master/proposals/D0-triple.md)
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/java-sdk/quick-start/api.md b/content/zh-cn/overview/mannual/java-sdk/quick-start/api.md
index 0673cbb497..955470c5f4 100644
--- a/content/zh-cn/overview/mannual/java-sdk/quick-start/api.md
+++ b/content/zh-cn/overview/mannual/java-sdk/quick-start/api.md
@@ -2,6 +2,8 @@
aliases:
- /zh/docs3-v2/java-sdk/quick-start/api/
- /zh-cn/docs3-v2/java-sdk/quick-start/api/
+ - /zh/overview/quickstart/java/api/
+ - /zh-cn/overview/quickstart/java/api/
description: 本文将基于 Dubbo Samples 示例演示如何通过 Dubbo API 快速开发微服务应用。
linkTitle: 基于 Dubbo API 开发微服务应用
title: 2 - 基于 Dubbo API 开发微服务应用
diff --git a/content/zh-cn/overview/mannual/java-sdk/quick-start/spring-boot.md b/content/zh-cn/overview/mannual/java-sdk/quick-start/spring-boot.md
index cf0ee00e7f..fb81b4509c 100644
--- a/content/zh-cn/overview/mannual/java-sdk/quick-start/spring-boot.md
+++ b/content/zh-cn/overview/mannual/java-sdk/quick-start/spring-boot.md
@@ -3,8 +3,8 @@ aliases:
- /zh/docs3-v2/java-sdk/quick-start/spring-boot/
- /zh-cn/docs3-v2/java-sdk/quick-start/spring-boot/
description: 本文将基于 Dubbo Samples 示例演示如何通过 Dubbo x Spring Boot 快速开发微服务应用。
-linkTitle: Dubbo x Spring Boot 开发微服务应用
-title: 3 - Dubbo x Spring Boot 开发微服务应用
+linkTitle: 基于 Spring Boot Starter 开发微服务应用
+title: 3 - 基于 Spring Boot Starter 开发微服务应用
type: docs
weight: 3
---
@@ -16,7 +16,7 @@ weight: 3
## 目标
-从零上手开发基于 Dubbo x Spring Boot 的微服务开发,了解 Dubbo x Spring Boot 配置方式。
+从零上手开发基于 dubbo-spring-boot-starter 开发微服务,了解 Dubbo x Spring Boot 配置方式。
## 难度
diff --git a/content/zh-cn/overview/mannual/java-sdk/quick-start/spring-xml.md b/content/zh-cn/overview/mannual/java-sdk/quick-start/spring-xml.md
index cecd5c94dc..ab7c132057 100644
--- a/content/zh-cn/overview/mannual/java-sdk/quick-start/spring-xml.md
+++ b/content/zh-cn/overview/mannual/java-sdk/quick-start/spring-xml.md
@@ -2,9 +2,11 @@
aliases:
- /zh/docs3-v2/java-sdk/quick-start/spring-xml/
- /zh-cn/docs3-v2/java-sdk/quick-start/spring-xml/
+ - /zh/overview/quickstart/java/spring-xml/
+ - /zh-cn/overview/quickstart/java/spring-xml/
description: 本文将基于 Dubbo Samples 示例演示如何通过 Dubbo x Spring XML 快速开发微服务应用。
-linkTitle: Dubbo x Spring XML 开发微服务应用
-title: 4 - Dubbo x Spring XML 开发微服务应用
+linkTitle: 基于 Spring XML 开发微服务应用
+title: 4 - 基于 Spring XML 开发微服务应用
type: docs
weight: 4
---
diff --git a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/_index.md
similarity index 62%
rename from content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/_index.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/_index.md
index df9372395a..9c27e5b673 100755
--- a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/_index.md
@@ -2,9 +2,10 @@
aliases:
- /zh/docs3-v2/java-sdk/concepts-and-architecture/
- /zh-cn/docs3-v2/java-sdk/concepts-and-architecture/
+ - /zh-cn/overview/mannual/java-sdk/concepts-and-architecture/
description: 概念和架构
-linkTitle: 概念和架构
-title: 概念和架构
+linkTitle: 源码架构
+title: 源码架构
type: docs
weight: 2
---
diff --git a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/code-architecture.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/code-architecture.md
similarity index 98%
rename from content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/code-architecture.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/code-architecture.md
index 64cb6d60a8..42935d0889 100644
--- a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/code-architecture.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/code-architecture.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/concepts-and-architecture/code-architecture/
- /zh-cn/docs3-v2/java-sdk/concepts-and-architecture/code-architecture/
+ - /zh-cn/overview/mannual/java-sdk/concepts-and-architecture/code-architecture/
description: 本文将介绍 Dubbo 代码架构。
linkTitle: 代码架构
title: 代码架构
diff --git a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/mesh.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/mesh.md.bak
similarity index 100%
rename from content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/mesh.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/mesh.md.bak
diff --git a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/overall-architecture.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/overall-architecture.md.bak
similarity index 99%
rename from content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/overall-architecture.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/overall-architecture.md.bak
index 40d3cfad07..04457022e8 100644
--- a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/overall-architecture.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/overall-architecture.md.bak
@@ -9,12 +9,6 @@ type: docs
weight: 1
---
-
-
-
-
-
-

##### 节点角色说明
diff --git a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/service-discovery.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/service-discovery.md.bak
similarity index 100%
rename from content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/service-discovery.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/service-discovery.md.bak
diff --git a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/service-invocation.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/service-invocation.md
similarity index 90%
rename from content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/service-invocation.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/service-invocation.md
index 11d70d0804..587d451ab8 100644
--- a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/service-invocation.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/architecture/service-invocation.md
@@ -2,7 +2,8 @@
aliases:
- /zh/docs3-v2/java-sdk/concepts-and-architecture/service-invocation/
- /zh-cn/docs3-v2/java-sdk/concepts-and-architecture/service-invocation/
-description: 本文将介绍如何在 Dubbo 3 中自定义调用链路上核心的扩展点以满足您的需求。
+ - /zh-cn/overview/mannual/java-sdk/concepts-and-architecture/service-invocation/
+description: 本文将介绍如何在 Dubbo Java 实现中自定义调用链路上核心的扩展点以满足您的需求。
linkTitle: 服务调用
title: 服务调用扩展点
type: docs
@@ -10,10 +11,6 @@ weight: 4
---
-
-
-
-

如上图所示,从服务调用的角度来看,Dubbo 在链路中提供了丰富的扩展点,覆盖了负载均衡方式、选址前后的拦截器、服务端处理拦截器等。
@@ -89,7 +86,7 @@ public interface ClusterFilter extends BaseFilter {
@Activate(group = CommonConstants.PROVIDER)
```
-具体调用拦截扩展方式请[参考](../../reference-manual/spi/description/filter/)
+具体调用拦截扩展方式请[参考](/zh-cn/overview/mannual/java-sdk/reference-manual/spi/description/filter/)
## Router(路由选址)
@@ -128,7 +125,7 @@ public interface Router extends Comparable<Router> {
}
```
-具体路由选址扩展方式请[参考](../../reference-manual/spi/description/router/)
+具体路由选址扩展方式请[参考](/zh-cn/overview/mannual/java-sdk/reference-manual/spi/description/router/)
## Cluster(集群规则)
@@ -145,7 +142,7 @@ public abstract class AbstractClusterInvoker<T> implements ClusterInvoker<T> {
```
-具体集群规则扩展方式请[参考](../../reference-manual/spi/description/cluster/)
+具体集群规则扩展方式请[参考](/zh-cn/overview/mannual/java-sdk/reference-manual/spi/description/cluster/)
## LoadBalance(负载均衡)
@@ -160,4 +157,4 @@ public interface LoadBalance {
}
```
-具体调用拦截扩展方式请[参考](../../reference-manual/spi/description/load-balance/)
\ No newline at end of file
+具体调用拦截扩展方式请[参考](/zh-cn/overview/mannual/java-sdk/reference-manual/spi/description/filter/)
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/_index.md
index 290dd94c36..f6acc2c9d2 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/_index.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/config-center/
- /zh-cn/docs3-v2/java-sdk/reference-manual/config-center/
+ - /zh-cn/overview/what/ecosystem/config-center/
description: Dubbo 配置中心的基本使用和工作原理
linkTitle: 配置中心
title: 配置中心
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/apollo.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/apollo.md
index 2a7d390f2d..f9854fc7c2 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/apollo.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/apollo.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/config-center/apollo/
- /zh-cn/docs3-v2/java-sdk/reference-manual/config-center/apollo/
+ - /zh-cn/overview/what/ecosystem/config-center/apollo/
description: Apollo 配置中心的基本使用和工作原理。
linkTitle: Apollo
title: Apollo
@@ -9,11 +10,6 @@ type: docs
weight: 4
---
-
-
-
-
-
## 1 前置条件
* 了解 [Dubbo 基本开发步骤](../../../quick-start/spring-boot/)
* 安装并启动 [Apollo](https://www.apolloconfig.com/#/zh/README)
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/nacos.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/nacos.md
index 69d595d6a5..792813e582 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/nacos.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/nacos.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/config-center/nacos/
- /zh-cn/docs3-v2/java-sdk/reference-manual/config-center/nacos/
+ - /zh-cn/overview/what/ecosystem/config-center/nacos/
description: Nacos 配置中心的基本使用和工作原理。
linkTitle: Nacos
title: Nacos
@@ -9,11 +10,6 @@ type: docs
weight: 3
---
-
-
-
-
-
## 1 前置条件
* 了解 [Dubbo 基本开发步骤](../../../quick-start/spring-boot/)
* 安装并启动 [Nacos](https://nacos.io/zh-cn/docs/quick-start.html)
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/zookeeper.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/zookeeper.md
index b103e94ebb..0920310bb6 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/zookeeper.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/config-center/zookeeper.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/config-center/zookeeper/
- /zh-cn/docs3-v2/java-sdk/reference-manual/config-center/zookeeper/
+ - /zh-cn/overview/what/ecosystem/config-center/zookeeper/
description: Zookeeper 配置中心的基本使用和工作原理。
linkTitle: Zookeeper
title: Zookeeper
@@ -10,10 +11,6 @@ weight: 2
---
-
-
-
-
## 1 前置条件
* 了解 [Dubbo 基本开发步骤](../../../quick-start/spring-boot/)
* 安装并启动 [Zookeeper](https://zookeeper.apache.org/)
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/_index.md
index f85950ffd9..c7bf5722ce 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/_index.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/metadata-center/
- /zh-cn/docs3-v2/java-sdk/reference-manual/metadata-center/
+ - /zh-cn/overview/what/ecosystem/metadata-center/
description: Dubbo 元数据中心基本使用与工作原理
linkTitle: 元数据中心
title: 元数据中心
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/nacos.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/nacos.md
index 19f59c09a8..d15ff6bb2e 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/nacos.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/nacos.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/metadata-center/nacos/
- /zh-cn/docs3-v2/java-sdk/reference-manual/metadata-center/nacos/
+ - /zh-cn/overview/what/ecosystem/metadata-center/nacos/
description: Nacos 元数据中心基本使用与工作原理
linkTitle: Nacos
title: Nacos
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/overview.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/overview.md
index c236761098..b535081a0f 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/overview.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/overview.md
@@ -25,7 +25,7 @@ weight: 1
关于如何配置开启元数据中心请参考具体实现文档。
## 1 地址发现元数据
-Dubbo3 中引入了 [应用级服务发现机制](/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/service-discovery/#应用级服务发现简介) 用来解决异构微服务体系互通与大规模集群实践的性能问题,应用级服务发现将全面取代 2.x 是时代的接口级服务发现。
+Dubbo3 中引入了 [应用级服务发现机制](/zh-cn/overview/core-features/service-discovery/#面向百万实例集群的服务发现机制) 用来解决异构微服务体系互通与大规模集群实践的性能问题,应用级服务发现将全面取代 2.x 是时代的接口级服务发现。
同时为了保持 Dubbo 面向服务/接口的易用性、服务治理的灵活性,Dubbo 围绕应用级服务发现构建了一套元数据机制,即 `接口 - 应用映射关系` 与 `接口配置元数据`。
### 1.1 接口 - 应用映射关系
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/redis.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/redis.md
index 92559c154a..0561833abc 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/redis.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/redis.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/metadata-center/redis/
- /zh-cn/docs3-v2/java-sdk/reference-manual/metadata-center/redis/
+ - /zh-cn/overview/what/ecosystem/metadata-center/redis/
description: Redis 元数据中心基本使用与工作原理
linkTitle: Redis
title: Redis
@@ -9,8 +10,4 @@ type: docs
weight: 4
---
-
-
-
-
暂未支持
\ No newline at end of file
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/zookeeper.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/zookeeper.md
index d37829ff6f..83b36348c6 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/zookeeper.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/metadata-center/zookeeper.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/metadata-center/zookeeper/
- /zh-cn/docs3-v2/java-sdk/reference-manual/metadata-center/zookeeper/
+ - /zh-cn/overview/what/ecosystem/metadata-center/zookeeper/
description: Zookeeper 元数据中心基本使用与工作原理
linkTitle: Zookeeper
title: Zookeeper
@@ -10,10 +11,6 @@ weight: 3
---
-
-
-
-
## 1 预备工作
- 了解 [Dubbo 基本开发步骤](/zh-cn/overview/mannual/java-sdk/quick-start/spring-boot/)
- 安装并启动 [Zookeeper](https://zookeeper.apache.org/)
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/_index.md
index 9460ad92f0..ba40804fc9 100755
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/_index.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/protocol/
- /zh-cn/docs3-v2/java-sdk/reference-manual/protocol/
+ - /zh/overview/what/ecosystem/protocol/
description: Dubbo RPC 协议指南
linkTitle: RPC 协议
title: RPC 协议
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/dubbo.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/dubbo.md
index e08b496294..50eeeb5d9d 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/dubbo.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/dubbo.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/protocol/dubbo/
- /zh-cn/docs3-v2/java-sdk/reference-manual/protocol/dubbo/
+ - /zh/overview/what/ecosystem/protocol/dubbo/
description: Dubbo协议
linkTitle: Dubbo协议
title: Dubbo协议
@@ -9,11 +10,6 @@ type: docs
weight: 2
---
-
-
-
-
-
## 特性说明
Dubbo 缺省协议采用单一长连接和 NIO 异步通讯,适合于小数据量大并发的服务调用,以及服务消费者机器数远大于服务提供者机器数的情况。
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/grpc.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/grpc.md
index c3f0879308..ac39524fc1 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/grpc.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/grpc.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/protocol/grpc/
- /zh-cn/docs3-v2/java-sdk/reference-manual/protocol/grpc/
+ - /zh/overview/what/ecosystem/protocol/grpc/
description: gRPC协议
linkTitle: gRPC协议
title: gRPC协议
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/http.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/http.md
index 90c32a855e..c771580cc8 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/http.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/http.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/protocol/http/
- /zh-cn/docs3-v2/java-sdk/reference-manual/protocol/http/
+ - /zh/overview/what/ecosystem/protocol/http/
description: HTTP协议
linkTitle: HTTP协议
title: HTTP协议
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/rmi.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/rmi.md
index 4f2e1c6e43..d2a2ac0312 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/rmi.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/rmi.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/protocol/rmi/
- /zh-cn/docs3-v2/java-sdk/reference-manual/protocol/rmi/
+ - /zh/overview/what/ecosystem/protocol/rmi/
description: Rmi协议
linkTitle: Rmi协议
title: Rmi协议
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/thrift.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/thrift.md
index 394dbb48ae..66cc089324 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/thrift.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/thrift.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/protocol/thrift/
- /zh-cn/docs3-v2/java-sdk/reference-manual/protocol/thrift/
+ - /zh/overview/what/ecosystem/protocol/thrift/
description: Thrift协议
linkTitle: Thrift协议
title: Thrift协议
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/triple/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/triple/_index.md
index 09d11fe995..f60111c32a 100755
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/triple/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/triple/_index.md
@@ -2,9 +2,41 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/protocol/triple/
- /zh-cn/docs3-v2/java-sdk/reference-manual/protocol/triple/
+ - /zh/overview/what/ecosystem/protocol/triple/
+ - /zh/docs3-v2/java-sdk/concepts-and-architecture/triple/
+ - /zh-cn/docs3-v2/java-sdk/concepts-and-architecture/triple/
+ - zh-cn/overview/mannual/java-sdk/concepts-and-architecture/triple/
description: Triple协议
linkTitle: Triple协议
title: Triple协议
type: docs
weight: 3
---
+
+## 协议说明
+Triple 是 Dubbo3 提出的基于 HTTP 的开放协议,旨在解决 Dubbo2 私有协议带来的互通性问题,Tripe 基于 gRPC 和 gRPC-Web 设计而来,保留了两者的优秀设计,Triple 做到了完全兼容 gRPC 协议,并可同时运行在 HTTP/1 和 HTTP/2 之上。
+
+* 相比于原有 Dubbo2 协议,Triple 有以下优势:
+ 1. 原生和 gRPC 协议互通。打通 gRPC 生态,降低从 gRPC 至 Dubbo 的迁移成本。
+ 2. 增强多语言生态。避免因 CPP/C#/RUST 等语言的 Dubbo SDK 能力不足导致业务难以选型适配的问题。
+ 3. 网关友好。网关无需参与序列化,方便用户从传统的 HTTP 转泛化 Dubbo 调用网关升级至开源或云厂商的 Ingress 方案。
+ 4. 完善的异步和流式支持。带来从底层协议到上层业务的性能提升,易于构建全链路异步以及严格保证消息顺序的流式服务。
+
+
+* 相比于 gRPC 协议,Triple 有以下优势:
+ 1. 协议内置支持 HTTP/1,可以用 curl、浏览器直接访问你的 gRPC 服务
+ 2. 保持性能与 grpc-java 在同一水平的同时,实现上更轻量、简单,协议部分只有几千行代码
+ 3. 不绑定 IDL,支持 Java Interface 定义服务
+ 4. 保持与官方 gRPC 库的 100% 兼容性的同时,与 Dubbo 的微服务治理体系无缝融合
+
+更多关于 Triple 协议设计与协议规范,请参考 [triple协议规范](/zh-cn/overview/reference/protocols/triple/)。
+**目前 Java 和 Go 的 Dubbo SDK 已全面支持 Triple 协议。** 在阿里巴巴,Triple 协议广泛用于跨环境、跨语言、跨生态互通,已有数十万容器生产级使用。
+
+## 使用方式
+Java SDK 支持 [IDL 生成 Stub](/zh-cn/overview/mannual/java-sdk/quick-start/idl)
+和 [Java Interface](/zh-cn/overview/mannual/java-sdk/quick-start/idl) 两种方式,多语言、生态互通、流式需求推荐使用 IDL 方式,现有服务平滑升级推荐使用
+Interface 方式。
+
+- Dubbo2 老用户如何从现有协议升级至 Triple(TBD)
+- 新用户或业务参考 [Dubbo3 Triple Quick Start](/zh-cn/overview/mannual/java-sdk/quick-start/idl/)
+- 深入了解 Triple 协议: [Dubbo3 Triple 协议设计与原理](https://github.com/apache/dubbo-awesome/blob/master/proposals/D0-triple.md)
diff --git a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/v3.2_rest_protocol_design.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/v3.2_rest_protocol_design.md
similarity index 99%
rename from content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/v3.2_rest_protocol_design.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/v3.2_rest_protocol_design.md
index 21c7d538ab..4dd501e625 100644
--- a/content/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/v3.2_rest_protocol_design.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/v3.2_rest_protocol_design.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/concepts-and-architecture/v3.2_rest_protocol_design/
- /zh-cn/docs3-v2/java-sdk/concepts-and-architecture/v3.2_rest_protocol_design/
+ - zh-cn/overview/mannual/java-sdk/concepts-and-architecture/v3.2_rest_protocol_design/
description: 本文将介绍 Dubbo 的 Rest 协议。
linkTitle: Rest 协议
title: Rest 协议
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/_index.md
index fd6af5f442..ca74dbcdf4 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/_index.md
@@ -2,9 +2,10 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/registry/
- /zh-cn/docs3-v2/java-sdk/reference-manual/registry/
+ - /zh-cn/overview/what/ecosystem/registry/
description: Dubbo 注册中心的基本使用和工作原理
-linkTitle: 注册中心说明
-title: 注册中心说明
+linkTitle: 注册中心
+title: 注册中心
type: docs
weight: 6
---
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/nacos/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/nacos/_index.md
index 4502b9d899..9a0d516bc2 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/nacos/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/nacos/_index.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/registry/nacos/
- /zh-cn/docs3-v2/java-sdk/reference-manual/registry/nacos/
+ - /zh-cn/overview/what/ecosystem/registry/nacos/
description: Nacos 注册中心的基本使用和工作原理。
linkTitle: Nacos
title: Nacos
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/overview/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/overview/_index.md
index 1d7804aae2..6600c52a0b 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/overview/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/overview/_index.md
@@ -10,10 +10,6 @@ weight: 1
---
-
-
-
-
注册中心是 Dubbo 服务治理的核心组件,Dubbo 依赖注册中心的协调实现服务(地址)发现,自动化的服务发现是微服务实现动态扩缩容、负载均衡、、流量治理的基础。Dubbo 的服务发现机制经历了 Dubbo2 时代的接口级服务发现、Dubbo3 时代的应用级服务发现,具体可参见 [服务发现机制](/zh-cn/overview/mannual/java-sdk/concepts-and-architecture/service-discovery/) 解析了解具体演进过程。
## 基本使用
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/redis/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/redis/_index.md
index 12c876fb3d..d211ae65dc 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/redis/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/redis/_index.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/registry/redis/
- /zh-cn/docs3-v2/java-sdk/reference-manual/registry/redis/
+ - /zh-cn/overview/what/ecosystem/registry/redis/
description: Redis 注册中心的基本使用和工作原理。
linkTitle: Redis
title: Redis
diff --git a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/zookeeper/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/zookeeper/_index.md
index 24060ba336..e0ae459490 100644
--- a/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/zookeeper/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/registry/zookeeper/_index.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/reference-manual/registry/zookeeper/
- /zh-cn/docs3-v2/java-sdk/reference-manual/registry/zookeeper/
+ - /zh-cn/overview/what/ecosystem/registry/zookeeper/
description: Zookeeper 注册中心的基本使用和工作原理。
linkTitle: Zookeeper
title: Zookeeper
diff --git a/content/zh-cn/overview/what/ecosystem/serialization/_index.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/_index.md
similarity index 100%
rename from content/zh-cn/overview/what/ecosystem/serialization/_index.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/_index.md
diff --git a/content/zh-cn/overview/what/ecosystem/serialization/avro.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/avro.md
similarity index 96%
rename from content/zh-cn/overview/what/ecosystem/serialization/avro.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/avro.md
index 0b05351046..08fa532fb8 100644
--- a/content/zh-cn/overview/what/ecosystem/serialization/avro.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/avro.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/what/ecosystem/serialization/avro/
+ - /zh-cn/overview/what/ecosystem/serialization/avro/
description: ""
linkTitle: Avro
title: Avro
diff --git a/content/zh-cn/overview/what/ecosystem/serialization/fastjson.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/fastjson.md
similarity index 95%
rename from content/zh-cn/overview/what/ecosystem/serialization/fastjson.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/fastjson.md
index 023745f440..9618dfef6a 100644
--- a/content/zh-cn/overview/what/ecosystem/serialization/fastjson.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/fastjson.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/what/ecosystem/serialization/fastjson/
+ - /zh-cn/overview/what/ecosystem/serialization/fastjson/
description: ""
linkTitle: Fastjson
title: Fastjson
diff --git a/content/zh-cn/overview/what/ecosystem/serialization/fastjson2.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/fastjson2.md
similarity index 96%
rename from content/zh-cn/overview/what/ecosystem/serialization/fastjson2.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/fastjson2.md
index cb4493c2ae..e7130fa3bb 100644
--- a/content/zh-cn/overview/what/ecosystem/serialization/fastjson2.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/fastjson2.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/what/ecosystem/serialization/fastjson2/
+ - /zh-cn/overview/what/ecosystem/serialization/fastjson2/
description: ""
linkTitle: Fastjson2
title: Fastjson2
diff --git a/content/zh-cn/overview/what/ecosystem/serialization/fst.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/fst.md
similarity index 96%
rename from content/zh-cn/overview/what/ecosystem/serialization/fst.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/fst.md
index 9bc482ef63..9239a6feea 100644
--- a/content/zh-cn/overview/what/ecosystem/serialization/fst.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/fst.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/what/ecosystem/serialization/fst/
+ - /zh-cn/overview/what/ecosystem/serialization/fst/
description: ""
linkTitle: FST
title: FST
diff --git a/content/zh-cn/overview/what/ecosystem/serialization/gson.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/gson.md
similarity index 95%
rename from content/zh-cn/overview/what/ecosystem/serialization/gson.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/gson.md
index cd95d176d1..eaa09a0881 100644
--- a/content/zh-cn/overview/what/ecosystem/serialization/gson.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/gson.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/what/ecosystem/serialization/gson/
+ - /zh-cn/overview/what/ecosystem/serialization/gson/
description: ""
linkTitle: Gson
title: Gson
diff --git a/content/zh-cn/overview/what/ecosystem/serialization/hessian.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/hessian.md
similarity index 95%
rename from content/zh-cn/overview/what/ecosystem/serialization/hessian.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/hessian.md
index 1651136f0e..59efaab506 100644
--- a/content/zh-cn/overview/what/ecosystem/serialization/hessian.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/hessian.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/what/ecosystem/serialization/hessian/
+ - /zh-cn/overview/what/ecosystem/serialization/hessian/
description: ""
linkTitle: Hessian
title: Hessian
diff --git a/content/zh-cn/overview/what/ecosystem/serialization/kryo.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/kryo.md
similarity index 95%
rename from content/zh-cn/overview/what/ecosystem/serialization/kryo.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/kryo.md
index 262c272fe4..90e823bdc0 100644
--- a/content/zh-cn/overview/what/ecosystem/serialization/kryo.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/kryo.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/what/ecosystem/serialization/kryo/
+ - /zh-cn/overview/what/ecosystem/serialization/kryo/
description: ""
linkTitle: Kryo
title: Kryo
diff --git a/content/zh-cn/overview/what/ecosystem/serialization/msgpack.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/msgpack.md
similarity index 96%
rename from content/zh-cn/overview/what/ecosystem/serialization/msgpack.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/msgpack.md
index 9518b27e68..8450a41b7a 100644
--- a/content/zh-cn/overview/what/ecosystem/serialization/msgpack.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/msgpack.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/what/ecosystem/serialization/msgpack/
+ - /zh-cn/overview/what/ecosystem/serialization/msgpack/
description: ""
linkTitle: MessagePack
title: MessagePack
diff --git a/content/zh-cn/overview/what/ecosystem/serialization/protobuf.md b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/protobuf.md
similarity index 94%
rename from content/zh-cn/overview/what/ecosystem/serialization/protobuf.md
rename to content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/protobuf.md
index 1876e8673b..80faeffa16 100644
--- a/content/zh-cn/overview/what/ecosystem/serialization/protobuf.md
+++ b/content/zh-cn/overview/mannual/java-sdk/reference-manual/serialization/protobuf.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/what/ecosystem/serialization/protobuf/
+ - /zh-cn/overview/what/ecosystem/serialization/protobuf/
description: ""
linkTitle: Protobuf
title: Protobuf
diff --git a/content/zh-cn/overview/mannual/java-sdk/version/_index.md b/content/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/version/_index.md
similarity index 87%
rename from content/zh-cn/overview/mannual/java-sdk/version/_index.md
rename to content/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/version/_index.md
index f2b82972ee..3ffbadcdb9 100755
--- a/content/zh-cn/overview/mannual/java-sdk/version/_index.md
+++ b/content/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/version/_index.md
@@ -2,6 +2,7 @@
aliases:
- /zh/docs3-v2/java-sdk/version/
- /zh-cn/docs3-v2/java-sdk/version/
+ - /zh-cn/overview/mannual/java-sdk/version/
description: 查看历史版本文档
linkTitle: 查看历史版本文档
title: 查看历史版本文档
@@ -9,10 +10,6 @@ type: docs
weight: 100
---
-
-
-
-
{{< blocks/section color="white" height="auto">}}
<div class="td-content list-page">
<div class="lead"></div><header class="article-meta">
@@ -21,7 +18,7 @@ weight: 100
<div class="h-100 card shadow" href="#">
<div class="card-body">
<h4 class="card-title">
- <a target="_blank" href='{{< relref "../../../../docs/" >}}'>Early 3.0 Version</a>
+ <a target="_blank" href='{{< relref "../../../../../docs/" >}}'>Early 3.0 Version</a>
</h4>
<p>早期 3.0 版本文档</p>
</div>
@@ -31,7 +28,7 @@ weight: 100
<div class="h-100 card shadow">
<div class="card-body">
<h4 class="card-title">
- <a target="_blank" href='{{< relref "../../../../docsv2.7/" >}}'>2.7.x Version</a>
+ <a target="_blank" href='{{< relref "../../../../../docsv2.7/" >}}'>2.7.x Version</a>
</h4>
<p>2.7.x 版本文档</p>
</div>
diff --git a/content/zh-cn/overview/quickstart/_index.md b/content/zh-cn/overview/quickstart/_index.md
index 20b6d85cc6..de26b9216f 100755
--- a/content/zh-cn/overview/quickstart/_index.md
+++ b/content/zh-cn/overview/quickstart/_index.md
@@ -23,9 +23,7 @@ weight: 2
</h4>
<p>通过以下教程快速上手 Dubbo Java 开发:</p>
<p><a href='{{< relref "./java/brief" >}}'>1 - 快速部署</a></p>
- <p><a href='{{< relref "./java/api" >}}'>2 - 基于 Dubbo API 开发</a></p>
- <p><a href='{{< relref "./java/spring-boot" >}}'>3 - 基于 Dubbo x Spring Boot 开发</a></p>
- <p><a href='{{< relref "./java/spring-xml" >}}'>4 - 基于 Dubbo x Spring XML 开发</a></p>
+ <p><a href='{{< relref "./java/spring-boot" >}}'>2 - 基于 dubbo-spring-boot-starter 开发</a></p>
</div>
</div>
</div>
diff --git a/content/zh-cn/overview/quickstart/java/_index.md b/content/zh-cn/overview/quickstart/java/_index.md
index d72a74d698..64e5814c66 100755
--- a/content/zh-cn/overview/quickstart/java/_index.md
+++ b/content/zh-cn/overview/quickstart/java/_index.md
@@ -25,33 +25,13 @@ weight: 1
</div>
</div>
</div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./api" >}}'>Dubbo API 开发</a>
- </h4>
- <p>基于 Dubbo API 开发微服务应用</p>
- </div>
- </div>
- </div>
<div class="col-sm col-md-6 mb-4">
<div class="h-100 card shadow" href="#">
<div class="card-body">
<h4 class="card-title">
<a href='{{< relref "./spring-boot" >}}'>Dubbo x Spring Boot 开发</a>
</h4>
- <p>Dubbo x Spring Boot 开发微服务应用</p>
- </div>
- </div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./spring-xml" >}}'>Dubbo x Spring XML 开发</a>
- </h4>
- <p>Dubbo x Spring XML 开发微服务应用</p>
+ <p>使用 dubbo-spring-boot-starter 开发微服务应用</p>
</div>
</div>
</div>
diff --git a/content/zh-cn/overview/quickstart/java/api.md b/content/zh-cn/overview/quickstart/java/api.md
deleted file mode 100644
index 17612df0eb..0000000000
--- a/content/zh-cn/overview/quickstart/java/api.md
+++ /dev/null
@@ -1,281 +0,0 @@
----
-aliases:
- - /zh/overview/quickstart/java/api/
-description: 本文将基于 Dubbo Samples 示例演示如何通过 Dubbo API 快速开发微服务应用。
-linkTitle: 基于 Dubbo API 开发微服务应用
-title: 2 - 基于 Dubbo API 开发微服务应用
-type: docs
-weight: 2
----
-
-
-
-## 目标
-
-从零上手开发基于 Dubbo 的微服务
-
-## 难度
-
-低
-
-## 环境要求
-
-- 系统:Windows、Linux、MacOS
-
-- JDK 8 及以上(推荐使用 JDK17)
-
-- Git
-
-- IntelliJ IDEA(可选)
-
-- Docker (可选)
-
-## 动手实践
-
-本章将通过手把手的教程一步一步教你如何从零开发一个微服务应用。
-
-### 1. 启动注册中心
-
-对于一个微服务化的应用来说,注册中心是不可或缺的一个组件。只有通过注册中心,消费端才可以成功发现服务端的地址信息,进而进行调用。
-
-为了让本教程更易于上手,我们提供了一个基于 Apache Zookeeper 注册中心的简易启动器,如果您需要在生产环境部署注册中心,请参考[生产环境初始化](/)一文部署高可用的注册中心。
-
-```bash
-Windows:
-git clone --depth=1 --branch master git@github.com:apache/dubbo-samples.git
-cd dubbo-samples
-./mvnw.cmd clean compile exec:java -pl tools/embedded-zookeeper
-
-Linux / MacOS:
-git clone --depth=1 --branch master git@github.com:apache/dubbo-samples.git
-cd dubbo-samples
-./mvnw clean compile exec:java -pl tools/embedded-zookeeper
-
-Docker:
-docker run --name some-zookeeper --restart always -d zookeeper
-```
-
-### 2. 初始化项目
-
-从本小节开始,将基于 IntelliJ IDEA 进行工程的搭建以及测试。
-
-
-
-如上图所示,可以建立一个基础的项目。
-
-
-
-在初始化完项目之后,需要在 `src/main/java` 目录下创建 `org.apache.dubbo.samples.api` 、`org.apache.dubbo.samples.client` 和 `org.apache.dubbo.samples.provider` 三个 package。
-
-后续我们将在 `api` 下创建对应的接口,在 `client` 下创建对应客户端订阅服务的功能,在 `provider` 下创建对应服务端的实现以及发布服务的功能。
-
-上述三个 package 分别对应了应用共同依赖的 api、消费端应用的模块、服务端应用的模块。在实际部署中需要拆成三个工程,消费端和服务的共同依赖 api 模块。从简单出发,本教程将在同一个工程中进行开发,区分多个启动类。
-
-### 3. 添加 Maven 依赖
-
-在初始化完项目以后,我们需要先添加 Dubbo 相关的 maven 依赖。
-
-
-
-编辑 `pom.xml` 这个文件,添加下列配置。
-
-```xml
- <dependencies>
- <dependency>
- <groupId>org.apache.dubbo</groupId>
- <artifactId>dubbo</artifactId>
- <version>3.2.0-beta.4</version>
- </dependency>
-
- <dependency>
- <groupId>org.apache.curator</groupId>
- <artifactId>curator-x-discovery</artifactId>
- <version>4.3.0</version>
- </dependency>
- <dependency>
- <groupId>org.apache.zookeeper</groupId>
- <artifactId>zookeeper</artifactId>
- <version>3.8.0</version>
- <exclusions>
- <exclusion>
- <groupId>io.netty</groupId>
- <artifactId>netty-handler</artifactId>
- </exclusion>
- <exclusion>
- <groupId>io.netty</groupId>
- <artifactId>netty-transport-native-epoll</artifactId>
- </exclusion>
- </exclusions>
- </dependency>
- </dependencies>
-```
-
-在这份配置中,定义了 dubbo 和 zookeeper(以及对应的连接器 curator)的依赖。
-
-
-
-添加了上述的配置以后,可以通过 IDEA 的 `Maven - Reload All Maven Projects` 刷新依赖。
-
-### 4. 定义服务接口
-
-服务接口 Dubbo 中沟通消费端和服务端的桥梁。
-
-
-
-在 `org.apache.dubbo.samples.api` 下建立 `GreetingsService` 接口,定义如下:
-
-```java
-package org.apache.dubbo.samples.api;
-
-public interface GreetingsService {
-
- String sayHi(String name);
-}
-```
-
-在 `GreetingsService` 中,定义了 `sayHi` 这个方法。后续服务端发布的服务,消费端订阅的服务都是围绕着 `GreetingsService` 接口展开的。
-
-### 5. 定义服务端的实现
-
-定义了服务接口之后,可以在服务端这一侧定义对应的实现,这部分的实现相对于消费端来说是远端的实现,本地没有相关的信息。
-
-
-
-在 `org.apache.dubbo.samples.provider` 下建立 `GreetingsServiceImpl` 类,定义如下:
-
-```java
-package org.apache.dubbo.samples.provider;
-
-import org.apache.dubbo.samples.api.GreetingsService;
-
-public class GreetingsServiceImpl implements GreetingsService {
- @Override
- public String sayHi(String name) {
- return "hi, " + name;
- }
-}
-```
-
-在 `GreetingsServiceImpl` 中,实现了 `GreetingsService` 接口,对于 `sayHi` 方法返回 `hi, name`。
-
-### 6. 服务端发布服务
-
-在实现了服务之后,本小节将通过 Dubbo 的 API 在网络上发布这个服务。
-
-
-
-在 `org.apache.dubbo.samples.provider` 下建立 `Application` 类,定义如下:
-
-```java
-package org.apache.dubbo.samples.provider;
-
-import org.apache.dubbo.config.ProtocolConfig;
-import org.apache.dubbo.config.RegistryConfig;
-import org.apache.dubbo.config.ServiceConfig;
-import org.apache.dubbo.config.bootstrap.DubboBootstrap;
-import org.apache.dubbo.samples.api.GreetingsService;
-
-public class Application {
- public static void main(String[] args) {
- // 定义具体的服务
- ServiceConfig<GreetingsService> service = new ServiceConfig<>();
- service.setInterface(GreetingsService.class);
- service.setRef(new GreetingsServiceImpl());
-
- // 启动 Dubbo
- DubboBootstrap.getInstance()
- .application("first-dubbo-provider")
- .registry(new RegistryConfig("zookeeper://127.0.0.1:2181"))
- .protocol(new ProtocolConfig("dubbo", -1))
- .service(service)
- .start()
- .await();
- }
-}
-```
-
-在 `org.apache.dubbo.samples.provider.Application` 中做了两部分的功能:首先是基于 `ServiceConfig` 定义了发布的服务信息,包括接口的信息以及对应的实现类对象;然后是配置 Dubbo 启动器,传入了应用名,注册中心地址,协议的信息以及服务的信息等。
-
-注:DubboBootstrap 中的`registry` 、`protocol` 和 `service` 可以多次传入。
-
-### 7. 消费端订阅并调用
-
-对于消费端,可以通过 Dubbo 的 API 可以进行消费端订阅。
-
-
-
-在 `org.apache.dubbo.samples.client` 下建立 `Application` 类,定义如下:
-
-```java
-package org.apache.dubbo.samples.client;
-
-import java.io.IOException;
-
-import org.apache.dubbo.config.ReferenceConfig;
-import org.apache.dubbo.config.RegistryConfig;
-import org.apache.dubbo.config.bootstrap.DubboBootstrap;
-import org.apache.dubbo.samples.api.GreetingsService;
-
-public class Application {
- public static void main(String[] args) throws IOException {
- ReferenceConfig<GreetingsService> reference = new ReferenceConfig<>();
- reference.setInterface(GreetingsService.class);
-
- DubboBootstrap.getInstance()
- .application("first-dubbo-consumer")
- .registry(new RegistryConfig("zookeeper://127.0.0.1:2181"))
- .reference(reference);
-
- GreetingsService service = reference.get();
- String message = service.sayHi("dubbo");
- System.out.println("Receive result ======> " + message);
- System.in.read();
- }
-}
-```
-
-在 `org.apache.dubbo.samples.client.Application` 中做了三部分的功能:
-
-首先是基于 `ReferenceConfig` 定义了订阅的服务信息,包括接口的信息。
-
-其次是配置 Dubbo 启动器,传入了应用名,注册中心地址,协议的信息以及服务的信息等。
-
-最后是获取到动态代理的对象并进行调用。
-
-注:DubboBootstrap 中支持 `service` 和 `reference` 可以同时传入,意味着一个应用可以同时即是消费端、也是服务端。
-
-### 8. 启动应用
-
-截止第 7 步,代码就已经开发完成了,本小节将启动整个项目并进行验证。
-
-
-
-首先是启动 `org.apache.dubbo.samples.provider.Application` ,等待一会出现如下图所示的日志(`DubboBootstrap awaiting`)即代表服务提供者启动完毕,标志着该服务提供者可以对外提供服务了。
-
-```log
-[DUBBO] DubboBootstrap awaiting ..., dubbo version: 3.2.0-beta.4, current host: 169.254.44.42
-```
-
-然后是启动`org.apache.dubbo.samples.client.Application` ,等待一会出现如下图所示的日志(`hi, dubbo` )即代表服务消费端启动完毕并调用到服务端成功获取结果。
-
-
-
-```log
-Receive result ======> hi, dubbo
-```
-
-## 延伸阅读
-
-### 1. Dubbo 的配置介绍
-
-Dubbo 的主要配置入口有`ReferenceConfig` 、`ServiceConfig` 和 `DubboBootstrap` ,更多的细节可以参考 [API 配置 | Apache Dubbo](/zh-cn/overview/mannual/java-sdk/reference-manual/config/api/) 一文。
-
-### 2. 除了 API 方式其他的使用方式
-
-Dubbo 除了 API 方式还支持 Spring XML、Annotation、Spring Boot 等配置方式,在下一个教程中将就 Spring Boot 配置方式讲解如何进行快速开发。
-
-关于 XML 和 Annotation 的细节可以参考 [XML 配置 | Apache Dubbo](/zh-cn/overview/mannual/java-sdk/reference-manual/config/xml/)、[Annotation 配置 | Apache Dubbo](/zh-cn/overview/mannual/java-sdk/reference-manual/config/annotation/) 疑问。
-
-## 更多
-
-本教程介绍了如何基于 Dubbo 的纯 API 开发一个微服务应用。下一个教程中,将介绍[如何基于 Spring Boot 开发微服务项目](../spring-boot/)。
diff --git a/content/zh-cn/overview/quickstart/java/brief.md b/content/zh-cn/overview/quickstart/java/brief.md
index 71a7bfd241..628a7b004c 100644
--- a/content/zh-cn/overview/quickstart/java/brief.md
+++ b/content/zh-cn/overview/quickstart/java/brief.md
@@ -8,8 +8,6 @@ type: docs
weight: 1
---
-
-
## 背景

diff --git a/content/zh-cn/overview/quickstart/java/spring-boot.md b/content/zh-cn/overview/quickstart/java/spring-boot.md
index 8cb811837c..0bfc4c592d 100644
--- a/content/zh-cn/overview/quickstart/java/spring-boot.md
+++ b/content/zh-cn/overview/quickstart/java/spring-boot.md
@@ -2,8 +2,8 @@
aliases:
- /zh/overview/quickstart/java/spring-boot/
description: 本文将基于 Dubbo Samples 示例演示如何通过 Dubbo x Spring Boot 快速开发微服务应用。
-linkTitle: Dubbo x Spring Boot 开发微服务应用
-title: 3 - Dubbo x Spring Boot 开发微服务应用
+linkTitle: Dubbo Spring Boot Starter 开发微服务应用
+title: 3 - Dubbo Spring Boot Starter 开发微服务应用
type: docs
weight: 3
---
diff --git a/content/zh-cn/overview/quickstart/java/spring-xml.md b/content/zh-cn/overview/quickstart/java/spring-xml.md
deleted file mode 100644
index 36eaecba3d..0000000000
--- a/content/zh-cn/overview/quickstart/java/spring-xml.md
+++ /dev/null
@@ -1,395 +0,0 @@
----
-aliases:
- - /zh/overview/quickstart/java/spring-xml/
-description: 本文将基于 Dubbo Samples 示例演示如何通过 Dubbo x Spring XML 快速开发微服务应用。
-linkTitle: Dubbo x Spring XML 开发微服务应用
-title: 4 - Dubbo x Spring XML 开发微服务应用
-type: docs
-weight: 4
----
-
-
-
-## 目标
-
-从零上手开发基于 Dubbo x Spring XML 的微服务开发,了解 Dubbo x Spring XML 配置方式。
-
-## 难度
-
-低
-
-## 环境要求
-
-- 系统:Windows、Linux、MacOS
-
-- JDK 8 及以上(推荐使用 JDK17)
-
-- Git
-
-- IntelliJ IDEA(可选)
-
-- Docker (可选)
-
-## 快速部署(基于 Samples 直接启动)
-
-本章将通过几个简单的命令,一步一步教你如何部署并运行一个基于 Dubbo x Spring XML 的用例。
-
-注:本章部署的代码细节可以在 [apache/dubbo-samples](https://github.com/apache/dubbo-samples) 这个仓库中 `1-basic/dubbo-samples-spring-xml` 中找到,在下一章中也将展开进行讲解。
-
-### 1. 获取测试工程
-
-在开始整个教程之前,我们需要先获取测试工程的代码。Dubbo 的所有测试用例代码都存储在 [apache/dubbo-samples](https://github.com/apache/dubbo-samples) 这个仓库中,以下这个命令可以帮你获取 Samples 仓库的所有代码。
-
-```bash
-git clone --depth=1 --branch master git@github.com:apache/dubbo-samples.git
-```
-
-### 2. 启动一个简易的注册中心
-
-对于一个微服务化的应用来说,注册中心是不可或缺的一个组件。只有通过注册中心,消费端才可以成功发现服务端的地址信息,进而进行调用。
-
-为了让本教程更易于上手,我们提供了一个基于 Apache Zookeeper 注册中心的简易启动器,如果您需要在生产环境部署注册中心,请参考[生产环境初始化](/)一文部署高可用的注册中心。
-
-```bash
-Windows:
-./mvnw.cmd clean compile exec:java -pl tools/embedded-zookeeper
-
-Linux / MacOS:
-./mvnw clean compile exec:java -pl tools/embedded-zookeeper
-
-Docker:
-docker run --name some-zookeeper -p 2181:2181 --restart always -d zookeeper
-```
-
-### 3. 启动服务提供者
-
-在启动了注册中心之后,下一步是启动一个对外提供服务的服务提供者。在 dubbo-samples 中也提供了对应的示例,可以通过以下命令快速拉起。
-
-```bash
-Windows:
-./mvnw.cmd clean compile exec:java -pl 1-basic/dubbo-samples-spring-xml -Dexec.mainClass="org.apache.dubbo.samples.provider.Application"
-
-Linux / MacOS:
-./mvnw clean compile exec:java -pl 1-basic/dubbo-samples-spring-xml -Dexec.mainClass="org.apache.dubbo.samples.provider.Application"
-
-注:需要开一个独立的 terminal 运行,命令将会保持一直执行的状态。
-```
-
-在执行完上述命令以后,等待一会出现如下所示的日志(`Dubbo Application[1.1](demo-provider) is ready.`)即代表服务提供者启动完毕,标志着该服务提供者可以对外提供服务了。
-
-```log
-[08/02/23 03:26:52:052 CST] org.apache.dubbo.samples.provider.Application.main() INFO metadata.ConfigurableMetadataServiceExporter: [DUBBO] The MetadataService exports urls : [dubbo://30.221.128.96:20880/org.apache.dubbo.metadata.MetadataService?anyhost=true&application=demo-provider&background=false&bind.ip=30.221.128.96&bind.port=20880&connections=1&corethreads=2&delay=0&deprecated=false&dubbo=2.0.2&dynamic=true&executes=100&generic=false&getAndListenInstanceMetadata.1.callback=true& [...]
-[08/02/23 03:26:52:052 CST] org.apache.dubbo.samples.provider.Application.main() INFO metadata.ServiceInstanceMetadataUtils: [DUBBO] Start registering instance address to registry., dubbo version: 3.1.6, current host: 30.221.128.96
-[08/02/23 03:26:52:052 CST] org.apache.dubbo.samples.provider.Application.main() INFO metadata.MetadataInfo: [DUBBO] metadata revision changed: null -> 602d44cc6d653b9cd42ab23c3948b5ab, app: demo-provider, services: 1, dubbo version: 3.1.6, current host: 30.221.128.96
-[08/02/23 03:26:52:052 CST] org.apache.dubbo.samples.provider.Application.main() INFO deploy.DefaultApplicationDeployer: [DUBBO] Dubbo Application[1.1](demo-provider) is ready., dubbo version: 3.1.6, current host: 30.221.128.96
-```
-
-### 4. 启动服务消费者
-
-最后一步是启动一个服务消费者来调用服务提供者,也即是 RPC 调用的核心,为服务消费者提供调用服务提供者的桥梁。
-
-```bash
-Windows:
-./mvnw.cmd clean compile exec:java -pl 1-basic/dubbo-samples-spring-xml -Dexec.mainClass="org.apache.dubbo.samples.client.Application"
-
-Linux / MacOS:
-./mvnw clean compile exec:java -pl 1-basic/dubbo-samples-spring-xml -Dexec.mainClass="org.apache.dubbo.samples.client.Application"
-```
-
-在执行完上述命令以后,等待一会出现如下所示的日志(`hi, dubbo`),打印出的数据就是服务提供者处理之后返回的,标志着一次服务调用的成功。
-
-```log
-[08/02/23 03:28:23:023 CST] org.apache.dubbo.samples.client.Application.main() INFO deploy.DefaultApplicationDeployer: [DUBBO] Dubbo Application[1.1](demo-consumer) is ready., dubbo version: 3.1.6, current host: 30.221.128.96
-Receive result ======> hi, dubbo
-```
-
-## 动手实践(从零代码开发版)
-
-本章将通过手把手的教程一步一步教你如何从零开发一个微服务应用。
-
-### 1. 启动注册中心
-
-对于一个微服务化的应用来说,注册中心是不可或缺的一个组件。只有通过注册中心,消费端才可以成功发现服务端的地址信息,进而进行调用。
-
-为了让本教程更易于上手,我们提供了一个基于 Apache Zookeeper 注册中心的简易启动器,如果您需要在生产环境部署注册中心,请参考[生产环境初始化](/)一文部署高可用的注册中心。
-
-```bash
-Windows:
-git clone --depth=1 --branch master git@github.com:apache/dubbo-samples.git
-cd dubbo-samples
-./mvnw.cmd clean compile exec:java -pl tools/embedded-zookeeper
-
-Linux / MacOS:
-git clone --depth=1 --branch master git@github.com:apache/dubbo-samples.git
-cd dubbo-samples
-./mvnw clean compile exec:java -pl tools/embedded-zookeeper
-
-Docker:
-docker run --name some-zookeeper -p 2181:2181 --restart always -d zookeeper
-```
-
-### 2. 初始化项目
-
-从本小节开始,将基于 IntelliJ IDEA 进行工程的搭建以及测试。
-
-
-
-如上图所示,可以建立一个基础的项目。
-
-
-
-在初始化完项目之后,需要在 `src/main/java` 目录下创建 `org.apache.dubbo.samples.api` 、`org.apache.dubbo.samples.client` 和 `org.apache.dubbo.samples.provider` 三个 package。
-
-后续我们将在 `api` 下创建对应的接口,在 `client` 下创建对应客户端订阅服务的功能,在 `provider` 下创建对应服务端的实现以及发布服务的功能。
-
-上述三个 package 分别对应了应用共同依赖的 api、消费端应用的模块、服务端应用的模块。在实际部署中需要拆成三个工程,消费端和服务的共同依赖 api 模块。从简单出发,本教程将在同一个工程中进行开发,区分多个启动类。
-
-### 3. 添加 Maven 依赖
-
-在初始化完项目以后,我们需要先添加 Dubbo 相关的 maven 依赖。
-
-
-
-编辑 `pom.xml` 这个文件,添加下列配置。
-
-```xml
- <dependencies>
- <dependency>
- <groupId>org.apache.dubbo</groupId>
- <artifactId>dubbo</artifactId>
- <version>3.1.6</version>
- </dependency>
-
- <dependency>
- <groupId>org.springframework</groupId>
- <artifactId>spring-context</artifactId>
- <version>5.3.25</version>
- </dependency>
-
- <dependency>
- <groupId>org.apache.curator</groupId>
- <artifactId>curator-x-discovery</artifactId>
- <version>5.2.0</version>
- </dependency>
- <dependency>
- <groupId>org.apache.zookeeper</groupId>
- <artifactId>zookeeper</artifactId>
- <version>3.8.0</version>
- </dependency>
- </dependencies>
-```
-
-在这份配置中,定义了 dubbo 和 zookeeper(以及对应的连接器 curator)的依赖。
-
-
-
-添加了上述的配置以后,可以通过 IDEA 的 `Maven - Reload All Maven Projects` 刷新依赖。
-
-### 4. 定义服务接口
-
-服务接口 Dubbo 中沟通消费端和服务端的桥梁。
-
-
-
-在 `org.apache.dubbo.samples.api` 下建立 `GreetingsService` 接口,定义如下:
-
-```java
-package org.apache.dubbo.samples.api;
-
-public interface GreetingsService {
-
- String sayHi(String name);
-}
-```
-
-在 `GreetingsService` 中,定义了 `sayHi` 这个方法。后续服务端发布的服务,消费端订阅的服务都是围绕着 `GreetingsService` 接口展开的。
-
-### 5. 定义服务端的实现
-
-定义了服务接口之后,可以在服务端这一侧定义对应的实现,这部分的实现相对于消费端来说是远端的实现,本地没有相关的信息。
-
-
-
-在 `org.apache.dubbo.samples.provider` 下建立 `GreetingsServiceImpl` 类,定义如下:
-
-```java
-package org.apache.dubbo.samples.provider;
-
-import org.apache.dubbo.samples.api.GreetingsService;
-
-public class GreetingsServiceImpl implements GreetingsService {
- @Override
- public String sayHi(String name) {
- return "hi, " + name;
- }
-}
-```
-
-在 `GreetingsServiceImpl` 中,实现了 `GreetingsService` 接口,对于 `sayHi` 方法返回 `hi, name`。
-
-### 6. 配置服务端 XML 配置文件
-
-从本步骤开始至第 7 步,将会通过 Spring XML 的方式配置 Dubbo 服务的信息。
-
-首先,我们先创建服务端的配置文件。
-
-
-
-在 `resources` 资源文件夹下建立 `dubbo-demo-provider.xml` 文件,定义如下:
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:dubbo="http://dubbo.apache.org/schema/dubbo"
- xmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context"
- xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
- http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
- <context:property-placeholder/>
-
- <!-- 定义应用名 -->
- <dubbo:application name="demo-provider"/>
-
- <!-- 定义注册中心地址 -->
- <dubbo:registry address="zookeeper://127.0.0.1:2181"/>
-
- <!-- 定义实现类对应的 bean -->
- <bean id="greetingsService" class="org.apache.dubbo.samples.provider.GreetingsServiceImpl"/>
- <!-- 定义服务信息,引用上面的 bean -->
- <dubbo:service interface="org.apache.dubbo.samples.api.GreetingsService" ref="greetingsService"/>
-
-</beans>
-```
-
-在这个配置文件中,定义了 Dubbo 的应用名、Dubbo 使用的注册中心地址、发布服务的 spring bean 以及通过 Dubbo 去发布这个 bean。
-
-### 7. 配置消费端 XML 配置文件
-
-同样的,我们需要创建消费端的配置文件。
-
-
-
-在 `resources` 资源文件夹下建立 `dubbo-demo-consumer.xml` 文件,定义如下:
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-
-<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:dubbo="http://dubbo.apache.org/schema/dubbo"
- xmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context"
- xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
- http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
- <context:property-placeholder/>
-
- <!-- 定义应用名 -->
- <dubbo:application name="demo-consumer"/>
-
- <!-- 定义注册中心地址 -->
- <dubbo:registry address="zookeeper://127.0.0.1:2181"/>
-
- <!-- 定义订阅信息,Dubbo 会在 Spring Context 中创建对应的 bean -->
- <dubbo:reference id="greetingsService" interface="org.apache.dubbo.samples.api.GreetingsService"/>
-
-</beans>
-```
-
-在这个配置文件中,定义了 Dubbo 的应用名、Dubbo 使用的注册中心地址、订阅的服务信息。
-
-### 8. 基于 Spring 配置服务端启动类
-
-除了配置 XML 配置文件之外,我们还需要创建基于 Spring Context 的启动类。
-
-首先,我们先创建服务端的启动类。
-
-
-
-在 `org.apache.dubbo.samples.provider` 下建立 `Application` 类,定义如下:
-
-```java
-package org.apache.dubbo.samples.provider;
-
-import java.util.concurrent.CountDownLatch;
-
-import org.springframework.context.support.ClassPathXmlApplicationContext;
-
-public class Application {
-
- public static void main(String[] args) throws InterruptedException {
- ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("dubbo-demo-provider.xml");
- context.start();
-
- // 挂起主线程,防止退出
- new CountDownLatch(1).await();
- }
-}
-```
-
-在这个启动类中,配置了一个 `ClassPathXmlApplicationContext` 去读取我们前面第 6 步中定义的 `dubbo-demo-provider.xml` 配置文件。
-
-### 9. 基于 Spring 配置消费端启动类
-
-同样的,我们需要创建消费端的启动类。
-
-
-
-在 `org.apache.dubbo.samples.client` 下建立 `Application` 类,定义如下:
-
-```java
-package org.apache.dubbo.samples.client;
-
-import java.io.IOException;
-
-import org.apache.dubbo.samples.api.GreetingsService;
-import org.springframework.context.support.ClassPathXmlApplicationContext;
-
-public class Application {
- public static void main(String[] args) throws IOException {
- ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("dubbo-demo-consumer.xml");
- context.start();
- GreetingsService greetingsService = (GreetingsService) context.getBean("greetingsService");
-
- String message = greetingsService.sayHi("dubbo");
- System.out.println("Receive result ======> " + message);
- System.in.read();
- System.exit(0);
- }
-
-}
-```
-
-在这个启动类中,主要执行了三个功能:
-
-1. 配置了一个 `ClassPathXmlApplicationContext` 去读取我们前面第 7 步中定义的 `dubbo-demo-consumer.xml` 配置文件
-
-2. 从 Spring Context 中获取名字为 `greetingsService` 的由 Dubbo 创建的 bean
-
-3. 通过这个 bean 对远端发起调用
-
-### 10. 启动应用
-
-截止第 9 步,代码就已经开发完成了,本小节将启动整个项目并进行验证。
-
-
-
-首先是启动 `org.apache.dubbo.samples.provider.Application` ,等待一会出现如下图所示的日志(`Dubbo Application[1.1](demo-provider) is ready`)即代表服务提供者启动完毕,标志着该服务提供者可以对外提供服务了。
-
-```log
-[DUBBO] Dubbo Application[1.1](demo-provider) is ready., dubbo version: 3.1.6, current host: 30.221.128.96
-```
-
-然后是启动`org.apache.dubbo.samples.client.Application` ,等待一会出现如下图所示的日志(`hi, dubbo` )即代表服务消费端启动完毕并调用到服务端成功获取结果。
-
-
-
-```log
-Receive result ======> hi, dubbo
-```
-
-## 延伸阅读
-
-### 1. Dubbo 的 XML 配置介绍
-
-Dubbo 的主要配置入口有`dubbo:application` 、`dubbo:registry` 、 `dubbo:reference` 和 `dubbo:service` 等,更多的细节可以参考 [XML 配置 | Apache Dubbo](/zh-cn/overview/mannual/java-sdk/reference-manual/config/xml/) 一文。
-
-## 更多
-
-本教程介绍了如何基于 Dubbo x Spring XML 开发一个微服务应用。至此,Dubbo 基于 API、Spring Boot、Spring XML 三种主要的启动方式都已经介绍完毕。
diff --git a/content/zh-cn/overview/reference/admin/architecture.md b/content/zh-cn/overview/reference/admin/architecture.md
index b03d13e5a1..92afaf2567 100644
--- a/content/zh-cn/overview/reference/admin/architecture.md
+++ b/content/zh-cn/overview/reference/admin/architecture.md
@@ -5,6 +5,7 @@ no_list: true
title: Admin 整体架构与安装步骤
type: docs
weight: 1
+working_in_progress: true
---
回顾 [Dubbo 服务治理体系的总体架构](../../../what/overview/),Admin 是服务治理控制面中的一个核心组件,负责微服务集群的服务治理、可视化展示等。
diff --git a/content/zh-cn/overview/reference/admin/documentation.md b/content/zh-cn/overview/reference/admin/documentation.md
index 00f5077924..b1234b3199 100644
--- a/content/zh-cn/overview/reference/admin/documentation.md
+++ b/content/zh-cn/overview/reference/admin/documentation.md
@@ -6,6 +6,7 @@ toc_hide: true
title: Admin 文档管理功能介绍
type: docs
weight: 6
+working_in_progress: true
---
// TBD
diff --git a/content/zh-cn/overview/reference/admin/mock.md b/content/zh-cn/overview/reference/admin/mock.md
index eeeb7cf71a..939695cade 100644
--- a/content/zh-cn/overview/reference/admin/mock.md
+++ b/content/zh-cn/overview/reference/admin/mock.md
@@ -5,6 +5,7 @@ no_list: true
title: Admin 服务 Mock 功能简介
type: docs
weight: 4
+working_in_progress: true
---
Mock 功能是设计用来提升微服务研发与测试效率的,它可以短路 Consumer 侧发起的远程调用,提前返回预先设定好的 Mock 值,这样即使在没有 Provider 可用的情况下,消费端也能正常的推进开发、测试进程。除此之外,mock 也可用于快速模拟负责返回值的测试数据、模拟服务端异常等场景
diff --git a/content/zh-cn/overview/reference/admin/search.md b/content/zh-cn/overview/reference/admin/search.md
index 9888f72088..9001fa3409 100644
--- a/content/zh-cn/overview/reference/admin/search.md
+++ b/content/zh-cn/overview/reference/admin/search.md
@@ -4,6 +4,7 @@ linkTitle: 文档查询
title: Admin 服务查询
type: docs
weight: 2
+working_in_progress: true
---
Admin 支持可视化的展示 Dubbo 微服务集群的状态,方便用户从全局掌握集群的应用、服务和实例分布,Admin 还可以通过查询的方式了解某一个服务更详细的信息:
diff --git a/content/zh-cn/overview/reference/admin/test.md b/content/zh-cn/overview/reference/admin/test.md
index 1c426f72d7..0e002de91d 100644
--- a/content/zh-cn/overview/reference/admin/test.md
+++ b/content/zh-cn/overview/reference/admin/test.md
@@ -5,6 +5,7 @@ no_list: true
title: Admin 服务测试功能简介
type: docs
weight: 3
+working_in_progress: true
---
服务测试功能通常提供给 Dubbo 服务的开发者使用,用来对自己发布的服务进行自测。通过在 Admin 控制台上模拟真实的消费端进程,对服务提供者发起调用,并验证调用结果是否符合预期。
diff --git a/content/zh-cn/overview/reference/proposals/_index.md b/content/zh-cn/overview/reference/proposals/_index.md
index 5856cceffc..a2cd48189f 100644
--- a/content/zh-cn/overview/reference/proposals/_index.md
+++ b/content/zh-cn/overview/reference/proposals/_index.md
@@ -1,7 +1,7 @@
---
aliases:
- /zh/overview/reference/proposals/
-description: ""
+description: "Dubbo 框架核心功能设计方案"
linkTitle: 提案
title: 提案
type: docs
diff --git a/content/zh-cn/overview/reference/proposals/admin.md b/content/zh-cn/overview/reference/proposals/admin.md
index 86a1c1207f..ec327d76e3 100644
--- a/content/zh-cn/overview/reference/proposals/admin.md
+++ b/content/zh-cn/overview/reference/proposals/admin.md
@@ -9,6 +9,7 @@ linkTitle: Admin 架构设计
title: Dubbo Admin 控制面总体架构设计
type: docs
weight: 3
+working_in_progress: true
---
diff --git a/content/zh-cn/overview/reference/proposals/heuristic-flow-control.md b/content/zh-cn/overview/reference/proposals/heuristic-flow-control.md
index ec7c35ca82..5e3ce3e9a7 100644
--- a/content/zh-cn/overview/reference/proposals/heuristic-flow-control.md
+++ b/content/zh-cn/overview/reference/proposals/heuristic-flow-control.md
@@ -3,169 +3,232 @@ aliases:
- /zh/overview/reference/proposals/heuristic-flow-control/
author: Quanlu Liu
date: 2023-01-30T00:00:00Z
-description: 本文所说的“柔性服务”主要是指consumer端的负载均衡和provider端的限流两个功能。在之前的dubbo版本中,负载均衡部分更多的考虑的是公平性原则,即consumer端尽可能平等的从provider中作出选择,在某些情况下表现并不够理想。而限流部分只提供了静态的限流方案,需要用户对provider端设置静态的最大并发值,然而该值的合理选取对用户来讲并不容易。我们针对这些存在的问题进行了改进。
+description: 本文所说的柔性服务主要是指**consumer端的负载均衡**和**provider端的限流**两个功能。在之前的dubbo版本中,负载均衡部分更多的考虑的是公平性原则,即consumer端尽可能平等的从provider中作出选择,在某些情况下表现并不够理想。而限流部分只提供了静态的限流方案,需要用户对provider端设置静态的最大并发值,然而该值的合理选取对用户来讲并不容易。我们针对这些存在的问题进行了改进。
linkTitle: 服务柔性
title: 自适应负载均衡与限流
type: docs
weight: 5
+working_in_progress: true
---
-
# 整体介绍
-本文所说的“柔性服务”主要是指consumer端的负载均衡和provider端的限流两个功能。在之前的dubbo版本中,负载均衡部分更多的考虑的是公平性原则,即consumer端尽可能平等的从provider中作出选择,在某些情况下表现并不够理想。而限流部分只提供了静态的限流方案,需要用户对provider端设置静态的最大并发值,然而该值的合理选取对用户来讲并不容易。我们针对这些存在的问题进行了改进。
-# 负载均衡
-在原本的dubbo版本中,有五种负载均衡的方案供选择,他们分别是"Random","ShortestResponse","RoundRobin","LeastActive"和"ConsistentHash"。其中除"ShortestResponse"和"LeastActive"外,其他的几种方案主要是考虑选择时的公平性和稳定性。对于"ShortestResponse"来说,其设计目的是从所有备选的provider中选择response时间最短的以提高系统整体的吞吐量。然而存在两个问题:1.在大多数的场景下,不同provider的response时长没有非常明显的区别,此时该算法会退化为随机选择。2.response的时间长短有时也并不能代表机器的吞吐能力。对于"LeastActive"来说,其认为应该将流量尽可能分配到当前并发处理任务较少的机器上。但是其同样存在和"ShortestResponse"类似的问题,即这并不能单独代表机器的吞吐能力。
-基于以上分析,我们提出了两种新的负载均衡算法。一种是同样基于公平性考虑的单纯"P2C"算法,另一种是基于自适应的方法"adaptive",其试图自适应的衡量provider端机器的吞吐能力,然后将流量尽可能分配到吞吐能力高的机器上,以提高系统整体的性能。
-## 效果介绍
+本文所说的柔性服务主要是指**consumer端的负载均衡**和**provider端的限流**两个功能。在之前的dubbo版本中,
+* 负载均衡部分更多的考虑的是公平性原则,即consumer端尽可能平等的从provider中作出选择,在某些情况下表现并不够理想。
+* 限流部分只提供了静态的限流方案,需要用户对provider端设置静态的最大并发值,然而该值的合理选取对用户来讲并不容易。
+
+我们针对这些存在的问题进行了改进。
+
+## 负载均衡
+### 使用介绍
+在原本的dubbo版本中,有五种负载均衡的方案供选择,他们分别是 `Random`、`ShortestResponse`、`RoundRobin`、`LeastActive` 和 `ConsistentHash`。其中除 `ShortestResponse` 和 `LeastActive` 外,其他的几种方案主要是考虑选择时的公平性和稳定性。
+
+对于 `ShortestResponse` 来说,其设计目的是从所有备选的 provider 中选择 response 时间最短的以提高系统整体的吞吐量。然而存在两个问题:
+1. 在大多数的场景下,不同provider的response时长没有非常明显的区别,此时该算法会退化为随机选择。
+2. response的时间长短有时也并不能代表机器的吞吐能力。对于 `LeastActive` 来说,其认为应该将流量尽可能分配到当前并发处理任务较少的机器上。但是其同样存在和 `ShortestResponse` 类似的问题,即这并不能单独代表机器的吞吐能力。
+
+基于以上分析,我们提出了两种新的负载均衡算法。一种是同样基于公平性考虑的单纯 `P2C` 算法,另一种是基于自适应的方法 `adaptive`,其试图自适应的衡量 provider 端机器的吞吐能力,然后将流量尽可能分配到吞吐能力高的机器上,以提高系统整体的性能。
+
+#### 总体效果
对于负载均衡部分的有效性实验在两个不同的情况下进行的,分别是提供端机器配置比较均衡和提供端机器配置差距较大的情况。
+

+

-## 使用方法
-使用方法与原本的负载均衡方法相同。只需要在consumer端将"loadbalance"设置为"p2c"或者"adaptive"即可。
-## 代码结构
+
+#### 使用方法
+[Dubbo Java 实现的使用方法](/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/loadbalance) 与原本的负载均衡方法相同。只需要在consumer端将"loadbalance"设置为"p2c"或者"adaptive"即可。
+
+#### 代码结构
负载均衡部分的算法实现只需要在原本负载均衡框架内继承 LoadBalance接口即可。
-## 原理介绍
-### P2C算法
-Power of Two Choice算法简单但是经典,主要思路如下:
-1.对于每次调用,从可用的provider列表中做两次随机选择,选出两个节点providerA和providerB。
-2.比较providerA和providerB两个节点,选择其“当前正在处理的连接数”较小的那个节点。
-### adaptive算法
+
+### 原理介绍
+
+#### P2C算法
+
+Power of Two Choice 算法简单但是经典,主要思路如下:
+
+1. 对于每次调用,从可用的provider列表中做两次随机选择,选出两个节点providerA和providerB。
+2. 比较providerA和providerB两个节点,选择其“当前正在处理的连接数”较小的那个节点。
+
+#### adaptive算法
+
[代码的github地址](https://github.com/apache/dubbo/pull/10745)
-#### 相关指标
-1.cpuLoad
+
+##### 相关指标
+1. cpuLoad
。该指标在provider端机器获得,并通过invocation的attachment传递给consumer端。
-2.rt
+
+2. rt
rt为一次rpc调用所用的时间,单位为毫秒。
-3.timeout
+
+3. timeout
timeout为本次rpc调用超时剩余的时间,单位为毫秒。
-4.weight
+
+4. weight
weight是设置的服务权重。
-5.currentProviderTime
+
+5. currentProviderTime
provider端在计算cpuLoad时的时间,单位是毫秒
-6.currentTime
+
+6. currentTime
currentTime为最后一次计算load时的时间,初始化为currentProviderTime,单位是毫秒。
-7.multiple
+7. multiple

-8.lastLatency
+
+8. lastLatency

-11.inflight
+
+11. inflight
inflight为consumer端还未返回的请求的数量。

-12.load
+
+12. load
对于备选后端机器x来说,若距离上次被调用的时间大于2*timeout,则其load值为0。
-否则
+否则,
+

-#### 算法实现
+
+##### 算法实现
依然是基于P2C算法。
-1.从备选列表中做两次随机选择,得到providerA和providerB
-2.比较providerA和providerB的load值,选择较小的那个。
-# 自适应限流
-与负载均衡运行在consumer端不同的是,限流功能运行在provider端。其作用是限制provider端处理并发任务时的最大数量。从理论上讲,服务端机器的处理能力是存在上限的,对于一台服务端机器,当短时间内出现大量的请求调用时,会导致处理不及时的请求积压,使机器过载。在这种情况下可能导致两个问题:1.由于请求积压,最终所有的请求都必须等待较长时间才能被处理,从而使整个服务瘫痪。2.服务端机器长时间的过载可能有宕机的风险。因此,在可能存在过载风险时,拒绝掉一部分请求反而是更好的选择。在之前的dubbo版本中,限流是通过在provider端设置静态的最大并发值实现的。但是在服务数量多,拓扑复杂且处理能力会动态变化的局面下,该值难以通过计算静态设置。
-基于以上原因,我们需要一种自适应的算法,其可以动态调整服务端机器的最大并发值,使其可以在保证机器不过载的前提下,尽可能多的处理接收到的请求。因此,我们参考brpc等其他框架的基础上,在dubbo的框架内实现了两种自适应限流算法,分别是基于启发式平滑的"HeuristicSmoothingFlowControl"和基于窗口的"AutoConcurrencyLimier"。
+1. 从备选列表中做两次随机选择,得到providerA和providerB
+2. 比较providerA和providerB的load值,选择较小的那个。
+
+## 自适应限流
+
+与负载均衡运行在consumer端不同的是,限流功能运行在provider端。其作用是限制provider端处理并发任务时的最大数量。从理论上讲,服务端机器的处理能力是存在上限的,对于一台服务端机器,当短时间内出现大量的请求调用时,会导致处理不及时的请求积压,使机器过载。在这种情况下可能导致两个问题:
+
+1. 由于请求积压,最终所有的请求都必须等待较长时间才能被处理,从而使整个服务瘫痪。
+2. 服务端机器长时间的过载可能有宕机的风险。
+
+因此,在可能存在过载风险时,拒绝掉一部分请求反而是更好的选择。在之前的 Dubbo 版本中,限流是通过在 provider 端设置静态的最大并发值实现的。但是在服务数量多,拓扑复杂且处理能力会动态变化的局面下,该值难以通过计算静态设置。
+
+基于以上原因,我们需要一种自适应的算法,其可以动态调整服务端机器的最大并发值,使其可以在保证机器不过载的前提下,尽可能多的处理接收到的请求。因此,我们参考相关理论与算法实践基础上,在 Dubbo 框架内实现了两种自适应限流算法,分别是基于启发式平滑的`HeuristicSmoothingFlowControl` 和基于窗口的 `AutoConcurrencyLimier`。
+
[代码的github地址](https://github.com/apache/dubbo/pull/10642)
-## 效果介绍
+
+### 使用介绍
+#### 总体效果
+
自适应限流部分的有效性实验我们在提供端机器配置尽可能大的情况下进行,并且为了凸显效果,在实验中我们将单次请求的复杂度提高,将超时时间尽可能设置的大,并且开启消费端的重试功能。

-## 使用方法
+
+#### 使用方法
要确保服务端存在多个节点,并且消费端开启重试策略的前提下,限流功能才能更好的发挥作用。
-设置方法与静态的最大并发值设置类似,只需在provider端将"flowcontrol"设置为"autoConcurrencyLimier"或者"heuristicSmoothingFlowControl"即可。
-## 代码结构
-1.FlowControlFilter:在provider端的filter负责根据限流算法的结果来对provider端进行限流功能。
-2.FlowControl:根据dubbo的spi实现的限流算法的接口。限流的具体实现算法需要继承自该接口并可以通过dubbo的spi方式使用。
-3.CpuUsage:周期性获取cpu的相关指标
-4.HardwareMetricsCollector:获取硬件指标的相关方法
-5.ServerMetricsCollector:基于滑动窗口的获取限流需要的指标的相关方法。比如qps等。
-6.AutoConcurrencyLimier:自适应限流的具体实现算法。
-7.HeuristicSmoothingFlowControl:自适应限流的具体实现方法。
-## 原理介绍
-### HeuristicSmoothingFlowControl
-#### 相关指标
-1.alpha
+
+[Dubbo Java 实现的自适应限流开启方法](/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/performance/loadbalance) 与静态的最大并发值设置类似,只需在provider端将"flowcontrol"设置为"autoConcurrencyLimier"或者"heuristicSmoothingFlowControl"即可。
+
+#### 代码结构
+1. FlowControlFilter:在provider端的filter负责根据限流算法的结果来对provider端进行限流功能。
+2. FlowControl:根据dubbo的spi实现的限流算法的接口。限流的具体实现算法需要继承自该接口并可以通过dubbo的spi方式使用。
+3. CpuUsage:周期性获取cpu的相关指标
+4. HardwareMetricsCollector:获取硬件指标的相关方法
+5. ServerMetricsCollector:基于滑动窗口的获取限流需要的指标的相关方法。比如qps等。
+6. AutoConcurrencyLimier:自适应限流的具体实现算法。
+7. HeuristicSmoothingFlowControl:自适应限流的具体实现方法。
+
+### 原理介绍
+#### HeuristicSmoothingFlowControl
+##### 相关指标
+1. alpha
alpha为可接受的延时的上升幅度,默认为0.3
-2.minLatency
+
+2. minLatency
在一个时间窗口内的最小的Latency值。
-3.noLoadLatency
+
+3. noLoadLatency
noLoadLatency是单纯处理任务的延时,不包括排队时间。这是服务端机器的固有属性,但是并不是一成不变的。在HeuristicSmoothingFlowControl算法中,我们根据机器CPU的使用率来确定机器当前的noLoadLatency。当机器的CPU使用率较低时,我们认为minLatency便是noLoadLatency。当CPU使用率适中时,我们平滑的用minLatency来更新noLoadLatency的值。当CPU使用率较高时,noLoadLatency的值不再改变。
-4.maxQPS
+
+4. maxQPS
一个时间窗口周期内的QPS的最大值。
-5.avgLatency
+
+5. avgLatency
一个时间窗口周期内的Latency的平均值,单位为毫秒。
-6.maxConcurrency
+
+6. maxConcurrency
计算得到的当前服务提供端的最大并发值。

-#### 算法实现
+
+##### 算法实现
当服务端收到一个请求时,首先判断CPU的使用率是否超过50%。如果没有超过50%,则接受这个请求进行处理。如果超过50%,说明当前的负载较高,便从HeuristicSmoothingFlowControl算法中获得当前的maxConcurrency值。如果当前正在处理的请求数量超过了maxConcurrency,则拒绝该请求。
-### AutoConcurrencyLimier
-#### 相关指标
-1.MaxExploreRatio
+#### AutoConcurrencyLimier
+##### 相关指标
+1. MaxExploreRatio
默认设置为0.3
-2.MinExploreRatio
+2. MinExploreRatio
默认设置为0.06
-3.SampleWindowSizeMs
+3. SampleWindowSizeMs
采样窗口的时长。默认为1000毫秒。
-4.MinSampleCount
+4. MinSampleCount
采样窗口的最小请求数量。默认为40。
-5.MaxSampleCount
+5. MaxSampleCount
采样窗口的最大请求数量。默认为500。
-6.emaFactor
+6. emaFactor
平滑处理参数。默认为0.1。
-7.exploreRatio
+7. exploreRatio
探索率。初始设置为MaxExploreRatio。
若avgLatency<=noLoadLatency*(1.0 + MinExploreRatio)或者qps>=maxQPS*(1.0 + MinExploreRatio)
则exploreRatio=min(MaxExploreRatio,exploreRatio+0.02)
否则
exploreRatio=max(MinExploreRatio,exploreRatio-0.02)
-8.maxQPS
+8. maxQPS
窗口周期内QPS的最大值。

-12.remeasureStartUs
+12. remeasureStartUs
下一次重置窗口的开始时间。

-13.startSampleTimeUs
+13. startSampleTimeUs
开始采样的时间。单位为微秒。
-14.sampleCount
+14. sampleCount
当前采样窗口内请求的数量。
-15.totalSampleUs
+15. totalSampleUs
采样窗口内所有请求的latency的和。单位为微秒。
-16.totalReqCount
+16. totalReqCount
采样窗口时间内所有请求的数量和。注意区别sampleCount。
-17.samplingTimeUs
+17. samplingTimeUs
采样当前请求的时间戳。单位为微秒。
-18.latency
+18. latency
当前请求的latency。
-19.qps
+19. qps
在该时间窗口内的qps值。

-20.avgLatency
+20. avgLatency
窗口内的平均latency。

-21.maxConcurrency
+21. maxConcurrency
上一个窗口计算得到当前周期的最大并发值。
-22.nextMaxConcurrency
+22. nextMaxConcurrency
当前窗口计算出的下一个周期的最大并发值。
|spring web| http client\(okhttp/httpclient/jdk URLConnnection )
-| ---- | ---- |--- |--- |--- |---|
-| 3.0 | 依赖与resteasy的client和server |遵循j2ee规范|依赖常见web容器|不依赖|不依赖
-| 3.2 | 不依赖(仅需要JaxRs注解包) |不遵循|netty实现的http服务器|仅依赖spring web注解|内部实现RestClient依赖http client(默认为okhttp)
-
+目前支持以上media,后面还会对type进行扩展
-##快速入门
+## 快速入门
详细的依赖以及spring配置,可以参见dubbo 项目的duubo-demo-xml模块
https://github.com/apache/dubbo/tree/3.2/dubbo-demo/dubbo-demo-xml
@@ -474,7 +460,7 @@ public class JaxRsRestDemoService {
````
- 微服务服务调用dubbo http
-
+
````java
/**
@@ -585,10 +571,12 @@ public class HttpClientInvoke {
}
````
+## 3.2 与 3.0 HTTP 实现对比
+因为 Dubbo Java 3.2 内部移除了原本 Resteasy 的实现,因此在对 Resteasy 内置的 Response,extend,ExceptionMapper 支持上将会有所变化
+ExceptionMapper 转换成了org.apache.dubbo.rpc.protocol.rest.exception.mapper.ExceptionHandler,Response后面也会做适配处理
-
-
-
-
-
+| 版本 | JaxRs| j2ee | web容器(tomcat/jetty)|spring web| http client\(okhttp/httpclient/jdk URLConnnection )
+| ---- | ---- |--- |--- |--- |---|
+| 3.0 | 依赖与resteasy的client和server |遵循j2ee规范|依赖常见web容器|不依赖|不依赖
+| 3.2 | 不依赖(仅需要JaxRs注解包) |不遵循|netty实现的http服务器|仅依赖spring web注解|内部实现RestClient依赖http client(默认为okhttp)
diff --git a/content/zh-cn/overview/reference/protocols/tcp.md b/content/zh-cn/overview/reference/protocols/tcp.md
new file mode 100644
index 0000000000..5e8f397dc0
--- /dev/null
+++ b/content/zh-cn/overview/reference/protocols/tcp.md
@@ -0,0 +1,98 @@
+---
+description: "TCP (Dubbo2) 协议规范"
+linkTitle: Dubbo2 协议规范
+title: Dubbo2 协议规范
+type: docs
+weight: 2
+---
+
+## 协议规范 Specification
+
+- Magic - Magic High & Magic Low (16 bits)
+
+ 标识协议版本号,Dubbo 协议:0xdabb
+
+- Req/Res (1 bit)
+
+ 标识是请求或响应。请求: 1; 响应: 0。
+
+- 2 Way (1 bit)
+
+ 仅在 Req/Res 为1(请求)时才有用,标记是否期望从服务器返回值。如果需要来自服务器的返回值,则设置为1。
+
+- Event (1 bit)
+
+ 标识是否是事件消息,例如,心跳事件。如果这是一个事件,则设置为1。
+
+- Serialization ID (5 bit)
+
+ 标识序列化类型:比如 fastjson 的值为6。
+
+- Status (8 bits)
+
+ 仅在 Req/Res 为0(响应)时有用,用于标识响应的状态。
+
+ - 20 - OK
+ - 30 - CLIENT_TIMEOUT
+ - 31 - SERVER_TIMEOUT
+ - 40 - BAD_REQUEST
+ - 50 - BAD_RESPONSE
+ - 60 - SERVICE_NOT_FOUND
+ - 70 - SERVICE_ERROR
+ - 80 - SERVER_ERROR
+ - 90 - CLIENT_ERROR
+ - 100 - SERVER_THREADPOOL_EXHAUSTED_ERROR
+
+- Request ID (64 bits)
+
+ 标识唯一请求。类型为long。
+
+- Data Length (32 bits)
+
+ 序列化后的内容长度(可变部分),按字节计数。int类型。
+
+- Variable Part
+
+ 被特定的序列化类型(由序列化 ID 标识)序列化后,每个部分都是一个 byte [] 或者 byte
+
+ - 如果是请求包 ( Req/Res = 1),则每个部分依次为:
+ - Dubbo version
+ - Service name
+ - Service version
+ - Method name
+ - Method parameter types
+ - Method arguments
+ - Attachments
+ - 如果是响应包(Req/Res = 0),则每个部分依次为:
+ - 返回值类型(byte),标识从服务器端返回的值类型:
+ - 返回空值:RESPONSE_NULL_VALUE 2
+ - 正常响应值: RESPONSE_VALUE 1
+ - 异常:RESPONSE_WITH_EXCEPTION 0
+ - 返回值:从服务端返回的响应bytes
+
+**注意:** 对于(Variable Part)变长部分,当前版本的Dubbo 框架使用json序列化时,在每部分内容间额外增加了换行符作为分隔,请在Variable Part的每个part后额外增加换行符, 如:
+
+```
+Dubbo version bytes (换行符)
+Service name bytes (换行符)
+...
+```
+
+## 协议特点分析
+
+### 优点
+
+- 协议设计上很紧凑,能用 1 个 bit 表示的,不会用一个 byte 来表示,比如 boolean 类型的标识。
+- 请求、响应的 header 一致,通过序列化器对 content 组装特定的内容,代码实现起来简单。
+
+### 可以改进的点
+
+- 对于网关代理类组件不友好。http 请求而言,通过 header 就可以确定要访问的资源,而 Dubbo 需要涉及到用特定序列化协议才可以将服务名、方法、方法签名解析出来,并且这些资源定位符是 string 类型或者 string 数组,很容易转成 bytes,因此可以组装到 header 中。类似于 http2 的 header 压缩,对于 rpc 调用的资源也可以协商出来一个int来标识,从而提升性能,如果在`header`上组装资源定位符的话,该功能则更易实现。
+
+- 通过 req/res 是否是请求后,可以精细定制协议,去掉一些不需要的标识和添加一些特定的标识。比如`status`,`twoWay`标识可以严格定制,去掉冗余标识。还有超时时间是作为 Dubbo 的 `attachment` 进行传输的,理论上应该放到请求协议的header中,因为超时是网络请求中必不可少的。提到 `attachment` ,通过实现可以看到 `attachment` 中有一些是跟协议 `content`中已有的字段是重复的,比如 `path`和`version`等字段,这些会增大协议尺寸。
+
+- Dubbo 会将服务名`com.alibaba.middleware.hsf.guide.api.param.ModifyOrderPriceParam`,转换为`Lcom/alibaba/middleware/hsf/guide/api/param/ModifyOrderPriceParam;`,理论上是不必要的,最后追加一个`;`即可。
+
+- Dubbo 协议没有预留扩展字段,没法新增标识,扩展性不太好,比如新增`响应上下文`的功能,只有改协议版本号的方式,但是这样要求客户端和服务端的版本都进行升级,对于分布式场景很不友好。
+
+
diff --git a/content/zh-cn/overview/reference/protocols/triple.md b/content/zh-cn/overview/reference/protocols/triple.md
new file mode 100644
index 0000000000..b37bc29576
--- /dev/null
+++ b/content/zh-cn/overview/reference/protocols/triple.md
@@ -0,0 +1,85 @@
+---
+description: "HTTP/2 (Triple) 协议规范"
+linkTitle: Triple 协议规范
+title: Triple 协议设计理念与规范
+type: docs
+weight: 1
+---
+
+## 简介
+Triple 协议是 Dubbo3 设计的基于 HTTP 的 RPC 通信协议规范,它基于 gRPC 设计而来因此可以完全兼容 gRPC 协议,可同时运行在 HTTP/1 和 HTTP/2 之上。
+
+Dubbo 框架提供了 Triple 协议的多种语言实现,它们可以帮助你构建浏览器、gRPC 兼容的 HTTP API 接口:你只需要定义一个标准的 Protocol Buffer 格式的服务并实现业务逻辑,Dubbo 负责帮助生成语言相关的 Server Stub、Client Stub,并将整个调用流程无缝接入如路由、服务发现等 Dubbo 体系。Go、Java 等语言的 Triple 协议实现原生支持 HTTP/1 传输层通信,相比于 gRPC 官方实现,Dubbo 框架提供的协议实现更简单、更稳定,帮助你更容易的开发和治理微服务应用。
+
+针对某些语言版本,Dubbo 框架还提供了更贴合语言特性的编程模式,即不绑定 IDL 的服务定义与开发模式,比如在 Dubbo Java 中,你可以选择使用 Java Interface 和 Pojo 类定义 Dubbo 服务,并将起发布为基于 Triple 协议通信的微服务。
+
+## 协议规范(Specification)
+Triple 协议是参考 gRPC 与 gRPC-Web 两个协议设计而来,它吸取了两个协议各自的特性和优点,将它们整合在一起,成为一个完全兼容 gRPC 且支持 Streaming 通信的协议,同时 Triple 还支持 HTTP/1、HTTP/2。
+
+Triple 协议的设计目标如下:
+* Triple 设计为对人类友好、开发调试友好的一款基于 HTTP 的协议,尤其是对 unary 类型的 RPC 请求。
+* 完全兼容基于 HTTP/2 的 gRPC 协议,因此 Dubbo Triple 协议实现可以 100% 与 gRPC 体系互调互通。
+* 仅依赖标准的、被广泛使用的 HTTP 特性,以便在实现层面可以直接依赖官方的标准 HTTP 网络库。
+
+当与 Protocol Buffers 一起使用时,Dubbo Triple 协议实现支持 unary、client-streaming、server-streaming 和 bi-streaming RPC,可以支持二进制 Protobuf、JSON 两种数据 payload。其中,除了双向流需要 HTTP/2,其他 RPC 类型都支持 HTTP/1.1。Triple 协议不使用 HTTP trailers,因此可以与任何网络基础设施配合使用。
+
+Unary RPC使用 application/proto 和 application/json 内容类型,看起来类似于精简的 REST 方言。大多数请求都是 POST,路径是从 Protobuf 模式派生的,请求和响应主体是有效的 Protobuf 或 JSON(没有 gRPC 风格的二进制框架),响应具有有意义的 HTTP 状态代码。
+
+请参考以下文档编写详细的 Triple Specification。
+* [参考文档1](https://connect.build/docs/protocol/)
+* [参考文档2](https://github.com/grpc/grpc/edit/master/doc/PROTOCOL-HTTP2.md)
+
+## 为什么要再实现一遍 gRPC 协议
+既然 gRPC 官方已经提供了多语言的框架实现,为什么 Dubbo 还要重新实现一遍那?核心目标主要有以下两点:
+
+* 首先,在协议设计上,Dubbo 参考 gRPC 与 gRPC-Web 两个协议设计了自定义的 Triple 协议:Triple 是一个基于 HTTP 传输层协议的 RPC 协议,它完全兼容 gRPC,可以同时运行在 HTTP/1、HTTP/2 之上。
+* 其次,Dubbo 框架在每个语言的实现过程中遵循了符合框架自身定位的设计理念,相比于 grpc-java、grpc-go 等框架库,Dubbo 协议实现更简单、更纯粹,尝试在实现上规避 gRPC 官方库中存在的一系列问题。
+
+gRPC 本身作为 RPC 协议规范非常优秀,但我们发现原生的 gRPC 库实现在实际使用存在一系列问题,包括实现复杂、绑定 IDL、难以调试等,Dubbo 在协议设计与实现上从实践出发,很好的规避了这些问题:
+
+* 原生的 gRPC 实现受限于 HTTP/2 交互规范,无法为浏览器、HTTP API 提供交互方式,你需要额外的代理组件如 grpc-web、grpc-gateway 等才能实现。在 Dubbo 中,你可以直接用 curl、浏览器访问 Dubbo HTTP/2 服务.
+* gRPC 官方库强制绑定 Proto Buffer,唯一的开发选择就是使用 IDL 定义和管理服务,这对于一些多语言诉求不强的用户是一个非常大的使用负担。Dubbo 则在支持 IDL 的同时,为 Java、Go 等提供了语言特有的服务定义与开发方式。
+* 在开发阶段,以 gRPC 协议发布的服务非常难以调试,你只能使用 gRPC 特定的工具来进行,很多工具都比较简陋 & 不成熟。而从 Dubbo3 开始,你可以直接使用 curl | jq 或者 Chrome 开发者工具来调试你的服务,直接传入 JSON 结构体就能调用服务。
+* 首先,gRPC 协议库有超过 10 万行代码的规模,但 Dubbo (Go、Java、Rust、Node.js 等) 关于协议实现部分仅有几千行代码,这让代码维护和问题排查变得更简单。
+* 谷歌提供的 gRPC 实现库没有使用主流的第三方或语言官方协议库,而是选择自己维护了一套实现,让整个维护与生态扩展变得更加复杂。比如 grpc-go 自己维护了一套 HTTP/2 库而不是使用的 go 官方库。Dubbo 使用了官方库的同时,相比 gRPC 自行维护的 http 协议库维持了同一性能水准。
+* gRPC 库仅仅提供了 RPC 协议实现,需要你做很多额外工作为其引入服务治理能力。而 Dubbo 本身是不绑定协议的微服务开发框架,内置 HTTP/2 协议实现可以与 Dubbo 服务治理能力更好的衔接在一起。
+
+### 实现简单
+Dubbo 框架实现专注在 Triple 协议自身,而对于底层的网络通信、HTTP/2 协议解析等选择依赖那些经过长期检验的网络库。比如 Dubbo Java 基于 Netty 构建,而 Dubbo Go 则是直接使用的 Go 官方 HTTP 库。
+
+Dubbo 提供的 Triple 协议实现非常简单,对应 Dubbo 中的 Protocol 组件实现,你可以仅仅花一下午时间就搞清楚 Dubbo 协议的代码实现。
+
+### 大规模生产环境检验
+自 Dubbo3 发布以来,Triple 协议已被广泛应用于阿里巴巴以及众多社区标杆企业,尤其是一些代理、网关互通场景。一方面 Triple 通过大规模生产实践被证实可靠稳定,另一方面 Triple 的简单、易于调试、不绑定 IDL 的设计也是其得到广泛应用的重要因素。
+
+### 原生多协议支持
+当以 Dubbo 框架为服务端对外发布服务时,可以做到在同一端口原生支持 Triple、gRPC 和 HTTP/1 协议,这意味着你可以用多种形式访问 Dubbo 服务端发布的服务,所有请求形式最终都会被转发到相同的业务逻辑实现,这给你提供了更大的灵活性。
+
+Dubbo 完全兼容 gRPC 协议及相关特性包括 streaming、trailers、error details 等,你选择直接在 Dubbo 框架中使用 Triple 协议(另外,你也可以选择使用原生的 gRPC 协议),然后你就可以直接使用 Dubbo 客户端、curl、浏览器等访问你发布的服务。在与 gRPC 生态互操作性方面,任何标准的 gRPC 客户端,都可以正常访问 Dubbo 服务;Dubbo 客户端也可以调用任何标准的 gRPC 服务,这里有提供的 [互操作性示例](https://github.com/apache/dubbo-samples/tree/master/3-extensions/protocol/dubbo-samples-triple/src/main/java/org/apache/dubbo/sample/tri/interop)
+
+以下是使用 curl 客户端访问 Dubbo 服务端一个 Triple 协议服务的示例:
+
+```sh
+curl \
+ --header "Content-Type: application/json" \
+ --data '{"sentence": "Hello Dubbo."}' \
+ https://host:port/org.apache.dubbo.sample.GreetService/sayHello
+```
+
+### 一站式服务治理接入
+我们都知道 Dubbo 有丰富的微服务治理能力,比如服务发现、负载均衡、流量管控等,这也是我们使用 Dubbo 框架开发应用的优势所在。要想在 Dubbo 体系下使用 gRPC 协议通信,有两种方式可以实现,一种是直接在 Dubbo 框架中引入 gRPC 官方发布的二进制包,另一种是在 Dubbo 内原生提供 gRPC 协议兼容的源码实现。
+
+相比于第一种引入二进制依赖的方式,Dubbo 框架通过内置 Triple 协议实现的方式,原生支持了 gRPC 协议,这种方式的优势在于源码完全由自己掌控,因此协议的实现与 Dubbo 框架结合更为紧密,能够更灵活的接入 Dubbo 的服务治理体系。
+
+### Java 语言
+在 Dubbo Java 库实现中,除了 IDL 方式外,你可以使用 Java Interface 方式定义服务,这对于众多熟悉 Dubbo 体系的 Java 用户来说,可以大大降低使用 gRPC 协议的成本。
+
+另外,Java 版本的协议实现在性能上与 grpc-java 库基本持平,甚至某些场景下比 grpc-java 性能表现还要出色。而这一切还是建立在 Dubbo 版本协议的实现复杂度远小于 gRPC 版本的情况下,因为 grpc-java 维护了一套定制版本的 netty 协议实现。
+
+### Go 语言实现
+Dubbo Go 推荐 IDL 开发模式,通过 Dubbo 配套的 protoc 插件生成 stub 代码,你只需要提供对应的业务逻辑实现即可,你可以通过 curl、浏览器访问 Dubbo Go 发布的 gRPC 服务。
+
+## 后续规划
+当前我们已经提供了 Triple 协议的 Java、Go 语言版本,接下来我们计划陆续提供 Rust、Python、Node.js 等语言的对应实现。
+
+
diff --git a/content/zh-cn/overview/tasks/develop/async.md b/content/zh-cn/overview/tasks/develop/async.md
index 676a291e5a..3350732426 100644
--- a/content/zh-cn/overview/tasks/develop/async.md
+++ b/content/zh-cn/overview/tasks/develop/async.md
@@ -8,6 +8,10 @@ type: docs
weight: 3
---
+文档完整的示例地址请参见
+* [服务调用异步](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-async/dubbo-samples-async-simple-boot)
+* [服务执行异步](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-async/dubbo-samples-async-provider)
+* [定义 CompletableFuture 方法签名的服务](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-async/dubbo-samples-async-original-future)
## 异步调用
Dubbo异步调用分为Provider端异步调用和Consumer端异步调用。
diff --git a/content/zh-cn/overview/tasks/develop/service_reference.md b/content/zh-cn/overview/tasks/develop/service_reference.md
index 55ddd6ccb1..769ee5ddb9 100644
--- a/content/zh-cn/overview/tasks/develop/service_reference.md
+++ b/content/zh-cn/overview/tasks/develop/service_reference.md
@@ -14,13 +14,15 @@ weight: 2
本文将基于 Dubbo Samples 示例演示如何快速搭建并部署一个微服务应用。
代码地址:[dubbo-samples-develop](https://github.com/apache/dubbo-samples/tree/master/10-task/dubbo-samples-develop)
-代码分为三个模块,如下图:
-``
+代码分为三个模块
+* api
+* develop-provider
+* develop-consumer
## 准备
本示例代码基于Springboot 3.0
-1、首先需要一个可用的注册中心Zookeeper,Nacos,Redis均可。
+1、首先需要一个可用的注册中心 Zookeeper,Nacos,Redis 均可。
2、新建一个maven工程,添加如下依赖
```xml
diff --git a/content/zh-cn/overview/tasks/develop/template.md b/content/zh-cn/overview/tasks/develop/template.md
index 11a3061c2b..b7c7e683a0 100644
--- a/content/zh-cn/overview/tasks/develop/template.md
+++ b/content/zh-cn/overview/tasks/develop/template.md
@@ -8,5 +8,54 @@ type: docs
weight: 1
---
+<a href="https://start.dubbo.apache.org/bootstrap.html" target="_blank">Dubbo Initializer</a> 可用来快速生成 Java 项目脚手架,帮助简化微服务项目搭建、基本配置、组件依赖管理等。
+
+> Initializer 仍在持续更新中,更多 Dubbo Feature 的支持将会陆续发布。
+
+## 选择 Dubbo 版本
+Initializer 将使用 `dubbo-spring-boot-starter` 创建 Spring Boot 项目,因此我们首先需要选择 Dubbo 与 Spring Boot 的版本。
+
+
+
+## 录入项目基本信息
+接下来,填入项目基本信息,包括项目坐标、项目名称、包名、JDK 版本等。
+
+
+
+## 选择项目结构
+有两种项目结构可共选择,分别是 `单模块` 和 `多模块`,在这个示例中我们选择 `单模块`。
+
+
+
+* 单模块,所有组件代码存放在一个 module 中,特点是结构简单。
+* 多模块,生成的项目有 `API`、`Service` 两个模块,其中 `API` 用于存放 Dubbo 服务定义,`Service` 用于存放服务服务实现或调用逻辑。通常多模块更有利于服务定义的单独管理与发布。
+
+## 选择依赖组件
+我们为模板默认选择如下几个依赖组件:
+* Dubbo 组件
+ * Java Interface
+ * 注册中心,zookeeper
+ * 协议 TCP
+* 常用微服务组件
+ * Web
+ * Mybatis
+ * 模版引擎
+
+
+
+基于以上选项,生成的项目将以 Zookeeper 为注册中心,以高性能 Dubbo2 TCP 协议为 RPC 通信协议,并且增加了 Web、Mybatis 等组件依赖和示例。
+
+> 注意:上面选中的 Dubbo 组件也都是默认选项,即在不手动添加任何依赖的情况下,打开页面后直接点击代码生成,生成的代码即包含以上 Dubbo 组件。
+>
+> 如手动添加依赖组件,请注意 Dubbo 各个依赖组件之间的隐含组合关系限制,比如
+> * 如果选择了【Dubbo Service API】-【IDL】,则目前仅支持选择 【Dubbo Protocol】中的 【HTTP/2】或 【gRPC】 协议。
+> * 同一个依赖分组下,相同类型的依赖只能选择一个,比如 【Dubbo Registry&Config&Metadata】分组下,从注册中心视角【Zookeeper】、【Nacos】只能选一个,如果要设置多注册中心,请在生成的代码中手动修改配置。但注册中心、配置中心可以分别选一个,比如 Zookeeper 和 Apollo 可同时选中。
+
+## 生成项目模板
+* 点击 “浏览代码” 可在线浏览项目结构与代码
+* 点击 “获取代码” 生成项目下载地址
+
+
+
+项目下载到本地后,解压并导入 IDE 后即可根据需要开发定制 Dubbo 应用。
-// Project Initializer will be available soon.
\ No newline at end of file
diff --git a/content/zh-cn/overview/tasks/ecosystem/_index.md b/content/zh-cn/overview/tasks/ecosystem/_index.md
index 8c35ff70dd..22fcb37b92 100755
--- a/content/zh-cn/overview/tasks/ecosystem/_index.md
+++ b/content/zh-cn/overview/tasks/ecosystem/_index.md
@@ -9,8 +9,6 @@ type: docs
weight: 4
---
-
-
{{< blocks/section color="white" height="auto">}}
<div class="td-content list-page">
<div class="lead"></div><header class="article-meta">
@@ -25,16 +23,6 @@ weight: 4
</div>
</div>
</div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./rate-limit/" >}}'>限流降级</a>
- </h4>
- <p>使用 Sentinel 保护您的应用,防止应用因个别服务的突发流量过载而出现稳定性问题。</p>
- </div>
- </div>
- </div>
<div class="col-sm col-md-6 mb-4">
<div class="h-100 card shadow">
<div class="card-body">
diff --git a/content/zh-cn/overview/tasks/ecosystem/gateway.md b/content/zh-cn/overview/tasks/ecosystem/gateway.md
index e6a3f222ce..5fa3d450b3 100644
--- a/content/zh-cn/overview/tasks/ecosystem/gateway.md
+++ b/content/zh-cn/overview/tasks/ecosystem/gateway.md
@@ -9,9 +9,9 @@ type: docs
weight: 2
---
-
-
-更多网关接入案例,请参考 [官方博客]({{< relref "../../../../blog/integration/how-to-proxy-dubbo-in-apache-shenyu" >}})
+更多网关接入案例,请参考
+* [使用 Apache Shenyu 代理 Dubbo 流量]({{< relref "../../../../blog/integration/how-to-proxy-dubbo-in-apache-shenyu" >}})
+* [使用 Higress 代理 Dubbo 流量]({{< relref "../../../../blog/integration/how-to-proxy-dubbo-in-higress" >}})
## 背景
diff --git a/content/zh-cn/overview/tasks/ecosystem/transaction.md b/content/zh-cn/overview/tasks/ecosystem/transaction.md
index 5bc346cdd0..8519c59d06 100644
--- a/content/zh-cn/overview/tasks/ecosystem/transaction.md
+++ b/content/zh-cn/overview/tasks/ecosystem/transaction.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/tasks/ecosystem/transaction/
+ - /zh-cn/overview/what/ecosystem/transaction/seata/
description: 本示例演示如何通过 Seata 实现分布式 Dubbo 服务的事务管理,保证数据一致性。
linkTitle: 事务管理
title: 事务管理
@@ -8,12 +9,12 @@ type: docs
weight: 1
---
-
-
## Seata 是什么
Seata 是一款开源的分布式事务解决方案,致力于提供高性能和简单易用的分布式事务服务。Seata 将为用户提供了 AT、TCC、SAGA 和 XA 事务模式,为用户打造一站式的分布式解决方案。
## 一、示例架构说明
+可在此查看本示例完整代码地址:<a href="https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-seata" target="_blank">dubbo-samples-seata</a>
+
用户采购商品业务,整个业务包含3个微服务:
- 库存服务: 扣减给定商品的库存数量。
diff --git a/content/zh-cn/overview/tasks/extensibility/registry.md b/content/zh-cn/overview/tasks/extensibility/registry.md
index 0c1da51dab..5b1488a57c 100644
--- a/content/zh-cn/overview/tasks/extensibility/registry.md
+++ b/content/zh-cn/overview/tasks/extensibility/registry.md
@@ -8,3 +8,5 @@ title: Registry
type: docs
weight: 3
---
+
+文档编写中...
diff --git a/content/zh-cn/overview/tasks/observability/grafana.md b/content/zh-cn/overview/tasks/observability/grafana.md
index 08b8876c71..03136446d3 100644
--- a/content/zh-cn/overview/tasks/observability/grafana.md
+++ b/content/zh-cn/overview/tasks/observability/grafana.md
@@ -15,7 +15,7 @@ weight: 3
- 一个可以访问的 Kubernetes 集群
- 正确安装并配置 [普罗米修斯服务](../../../reference/integrations/prometheus)
- 安装 [Grafana](../../../reference/integrations/grafana)
-- 部署 [示例应用](https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-metrics-spring-boot)
+- 部署 [示例应用](https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-metrics-spring-boot) 并开启指标采集
## 确认组件正常运行
diff --git a/content/zh-cn/overview/tasks/observability/metrics-start.md b/content/zh-cn/overview/tasks/observability/metrics-start.md
deleted file mode 100644
index 48c25fa5c0..0000000000
--- a/content/zh-cn/overview/tasks/observability/metrics-start.md
+++ /dev/null
@@ -1,94 +0,0 @@
----
-aliases:
- - /zh/overview/tasks/observability/metrics-start/
-description: ""
-linkTitle: 指标入门
-no_list: true
-title: 指标监控入门指南
-type: docs
-weight: 2
----
-
-
-# 指标监控入门指南
-## 指标模块简介
-Dubbo的指标模块帮助用户从外部观察正在运行的系统的内部服务状况 ,Dubbo参考 *四个黄金信号*、*RED方法*、*USE方法* 等理论并结合实际企业应用场景从不同维度统计了丰富的关键指标,关注这些核心指标对于提供可用性的服务是至关重要的。
-
-Dubbo的关键指标包含:**延迟(Latency)**、**流量(Traffic)**、 **错误(Errors)** 和 **饱和度(Saturation)** 等内容 。同时,为了更好的监测服务运行状态,Dubbo 还提供了对核心组件状态的监控,如Dubbo应用信息、线程池信息、三大中心交互的指标数据等。
-
-Dubbo指标监控目前推荐使用Prometheus来进行服务监控,Grafana来展示指标数据。接下来就通过案例来快速入门Dubbo的指标监控吧。
-
-## 快速入门
-### 环境
-- 系统:Windows、Linux、MacOS
-- JDK 8 及以上
-- Git
-- Maven
-- Prometheus [使用教程](../prometheus)
-- Grafana [使用教程](../grafana)
-
-### 参考案例
-Dubbo官方案例中提供了指标埋点的示例,可以访问如下地址获取案例源码:
-- Spring项目参考案例: [dubbo-samples-metrics-prometheus](https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-metrics-prometheus)
-- SpringBoot项目参考案例: [dubbo-samples-metrics-spring-boot](https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-metrics-spring-boot)
-
-### 依赖
-目前Dubbo的指标埋点仅支持3.2及以上版本,同时需要额外引入dubbo-spring-boot-observability-starter依赖如下所示:
-```xml
- <dependency>
- <groupId>org.apache.dubbo</groupId>
- <artifactId>dubbo-spring-boot-observability-starter</artifactId>
- <version>3.2及以上的正式版本</version>
- </dependency>
-```
-
-### 配置
-目前Dubbo支持推和拉两种模式获取指标数据,下面以普罗米修斯拉取指标数据的方式来作为演示,Dubbo的指标埋点服务端口复用了QOS的服务,拉取模式只需要开启QOS相关对应配置即可。下面介绍两种开启的方式分别为Spring文件中配置和dubbo.properties配置文件中配置,您可以选择其中一种适合自己方式即可。
-
-#### Spring XML配置
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:dubbo="http://dubbo.apache.org/schema/dubbo"
- xmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context"
- xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
- http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
- <context:property-placeholder/>
-
- <dubbo:application name="metrics-provider" qos-enable="true" qos-port="22222" qos-accept-foreign-ip="false"
- qos-accept-foreign-ip-whitelist="192.168.1.169,47.96.183.43,192.168.1.9,121.199.25.64"/>
-
- <dubbo:registry address="zookeeper://${zookeeper.address:127.0.0.1}:2181"/>
- <dubbo:config-center address="zookeeper://${zookeeper.address:127.0.0.1}:2181" />
- <dubbo:metadata-report address="zookeeper://${zookeeper.address:127.0.0.1}:2181" />
-
- <dubbo:metrics protocol="prometheus">
- <dubbo:histogram enabled="true"/>
- </dubbo:metrics>
-
- <bean id="demoService" class="org.apache.dubbo.samples.metrics.prometheus.provider.impl.DemoServiceImpl"/>
- <dubbo:service interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService" ref="demoService"/>
-
-
- <bean id="demoService2" class="org.apache.dubbo.samples.metrics.prometheus.provider.impl.DemoServiceImpl2"/>
- <dubbo:service interface="org.apache.dubbo.samples.metrics.prometheus.api.DemoService2" ref="demoService2"/>
-</beans>
-```
-
-#### dubbo.properties配置
-
-```
-dubbo.application.qos-port=22222
-dubbo.application.qos-accept-foreign-ip=false
-dubbo.application.qos-accept-foreign-ip-whitelist=8.131.79.126,114.55.147.139,121.199.25.64
-dubbo.metrics.histogram.enabled=true
-dubbo.metrics.protocol=prometheus
-```
-
-### 查询Apache Dubbo指标
-
-如果需要测试指标数据可以直接在服务器上面执行如下命令:
-
-```bash
-curl http://localhost:22222/metrics
-```
\ No newline at end of file
diff --git a/content/zh-cn/overview/tasks/observability/prometheus.md b/content/zh-cn/overview/tasks/observability/prometheus.md
index 55f56e3b98..3fdcfce00d 100644
--- a/content/zh-cn/overview/tasks/observability/prometheus.md
+++ b/content/zh-cn/overview/tasks/observability/prometheus.md
@@ -15,7 +15,7 @@ weight: 4
* 本地或远端 Kubernetes 集群
* 确保 [Prometheus 正确安装](../../../reference/integrations/prometheus/#安装)
-* 部署 [示例应用](https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-metrics-spring-boot)
+* 部署 [示例应用](https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-metrics-spring-boot) 并开启指标采集
* 使用 Prometheus dashboard 查询数据指标
## 确保 Prometheus 正确运行
diff --git a/content/zh-cn/overview/tasks/observability/tracing/skywalking.md b/content/zh-cn/overview/tasks/observability/tracing/skywalking.md
index febd2cc2a3..18ca823ce7 100644
--- a/content/zh-cn/overview/tasks/observability/tracing/skywalking.md
+++ b/content/zh-cn/overview/tasks/observability/tracing/skywalking.md
@@ -9,7 +9,7 @@ type: docs
weight: 2
---
-本文演示如何将 Dubbo 接入 Skywalking 全链路监控体系,依赖的 Skywalking Agent 版本为 [skywalking micrometer-1.10 api](https://skywalking.apache.org/docs/skywalking-java/next/en/setup/service-agent/java-agent/application-toolkit-micrometer-1.10/).
+本文演示如何将 Dubbo 接入 Skywalking 全链路监控体系,完整示例请参考 <a href="https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-spring-boot-tracing-skywalking" target="_blank">dubbo-samples-tracing-skywalking</a>。依赖的 Skywalking Agent 版本为 [skywalking micrometer-1.10 api](https://skywalking.apache.org/docs/skywalking-java/next/en/setup/service-agent/java-agent/application-toolkit-micrometer-1.10/).
## 1. 添加 Micrometer Observation 依赖到你的项目
为了能够将 Micrometer 及相关 Metrics 依赖添加到 classpath,需要增加 `dubbo-metrics-api` 依赖,如下所示:
diff --git a/content/zh-cn/overview/tasks/observability/tracing/zipkin.md b/content/zh-cn/overview/tasks/observability/tracing/zipkin.md
index 4ef8731ce8..cb1190a1e0 100644
--- a/content/zh-cn/overview/tasks/observability/tracing/zipkin.md
+++ b/content/zh-cn/overview/tasks/observability/tracing/zipkin.md
@@ -9,13 +9,11 @@ type: docs
weight: 1
---
-这个示例演示了 SpringBoot 项目中 Dubbo 集成 Zipkin 全链路追踪的基础示例,此示例共包含三部分内容:
-
+这个示例演示了 Dubbo 集成 Zipkin 全链路追踪的基础示例,完整代码请参考 <a href="https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-spring-boot3-tracing" target="_blank">dubbo-samples-tracing-zipkin</a>,此示例共包含三部分内容:
* dubbo-samples-spring-boot3-tracing-provider
* dubbo-samples-spring-boot3-tracing-consumer
* dubbo-samples-spring-boot3-tracing-interface
-[案例代码地址](https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-spring-boot3-tracing)
## 快速开始
diff --git a/content/zh-cn/overview/tasks/protocols/dubbo.md b/content/zh-cn/overview/tasks/protocols/dubbo.md
new file mode 100644
index 0000000000..539f63c389
--- /dev/null
+++ b/content/zh-cn/overview/tasks/protocols/dubbo.md
@@ -0,0 +1,9 @@
+---
+description: "使用 Dubbo 开发 TCP 通信协议服务"
+linkTitle: 开发 Dubbo2 服务
+title: 使用 Dubbo 开发 TCP 通信协议服务
+type: docs
+weight: 1
+---
+
+文档编写中...
\ No newline at end of file
diff --git a/content/zh-cn/overview/tasks/protocols/grpc.md b/content/zh-cn/overview/tasks/protocols/grpc.md
index 38f6f6998c..a7eb9a05ec 100644
--- a/content/zh-cn/overview/tasks/protocols/grpc.md
+++ b/content/zh-cn/overview/tasks/protocols/grpc.md
@@ -1,9 +1,11 @@
---
aliases:
- /zh/overview/tasks/protocols/grpc/
-description: ""
+description: "使用 Dubbo 开发 gRPC 服务"
linkTitle: 开发 gRPC 服务
title: 使用 Dubbo 开发 gRPC 服务
type: docs
weight: 1
---
+
+文档编写中...
\ No newline at end of file
diff --git a/content/zh-cn/overview/tasks/protocols/triple.md b/content/zh-cn/overview/tasks/protocols/triple.md
new file mode 100644
index 0000000000..84f49fdf76
--- /dev/null
+++ b/content/zh-cn/overview/tasks/protocols/triple.md
@@ -0,0 +1,9 @@
+---
+description: "使用 Dubbo 开发 Triple 协议通信服务"
+linkTitle: 开发 Triple 服务
+title: 使用 Dubbo 开发 Triple 协议通信服务
+type: docs
+weight: 1
+---
+
+文档编写中...
diff --git a/content/zh-cn/overview/tasks/protocols/web.md b/content/zh-cn/overview/tasks/protocols/web.md
index 0dd947c905..955210fc70 100644
--- a/content/zh-cn/overview/tasks/protocols/web.md
+++ b/content/zh-cn/overview/tasks/protocols/web.md
@@ -8,6 +8,7 @@ type: docs
weight: 2
---
+文档编写中...
Dubbo3 HTTP 协议支持仍在建设中,目前最新的 3.3 开发分支已经有初版原型供体验。正式的生产可用版本预计会在 3.4/3.4 的某个正式版本发布。
diff --git a/content/zh-cn/overview/tasks/rate-limit/_index.md b/content/zh-cn/overview/tasks/rate-limit/_index.md
new file mode 100755
index 0000000000..dffcfb97fb
--- /dev/null
+++ b/content/zh-cn/overview/tasks/rate-limit/_index.md
@@ -0,0 +1,48 @@
+---
+aliases:
+ - /zh/overview/tasks/protocols/
+description: 演示 Dubbo 熔断、限流、降级等场景工作方式
+hide: true
+linkTitle: 限流降级
+no_list: true
+title: 限流降级
+type: docs
+weight: 6
+---
+
+{{< blocks/section color="white" height="auto">}}
+<div class="td-content list-page">
+ <div class="lead"></div><header class="article-meta">
+ </header><div class="row">
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100 card shadow" href="#">
+ <div class="card-body">
+ <h4 class="card-title">
+ <a href='{{< relref "./hystrix/" >}}'>基于 Hystrix 的熔断降级示例</a>
+ </h4>
+ </div>
+ </div>
+ </div>
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100 card shadow" href="#">
+ <div class="card-body">
+ <h4 class="card-title">
+ <a href='{{< relref "./sentinel/" >}}'>基于 Sentinel 的服务限流示例</a>
+ </h4>
+ </div>
+ </div>
+ </div>
+ <div class="col-sm col-md-6 mb-4">
+ <div class="h-100 card shadow" href="#">
+ <div class="card-body">
+ <h4 class="card-title">
+ <a href='{{< relref "./resilience4j/" >}}'>基于 Resilience4j 的限流、熔断降级示例</a>
+ </h4>
+ </div>
+ </div>
+ </div>
+</div>
+<hr>
+</div>
+
+{{< /blocks/section >}}
diff --git a/content/zh-cn/overview/what/ecosystem/rate-limit/hystrix.md b/content/zh-cn/overview/tasks/rate-limit/hystrix.md
similarity index 94%
rename from content/zh-cn/overview/what/ecosystem/rate-limit/hystrix.md
rename to content/zh-cn/overview/tasks/rate-limit/hystrix.md
index d15464810f..019523cd59 100644
--- a/content/zh-cn/overview/what/ecosystem/rate-limit/hystrix.md
+++ b/content/zh-cn/overview/tasks/rate-limit/hystrix.md
@@ -1,33 +1,29 @@
---
aliases:
- - /zh/overview/what/ecosystem/rate-limit/hystrix/
-description: ""
-linkTitle: Hystrix
-title: Hystrix
+ - /zh-cn/overview/what/ecosystem/rate-limit/hystrix/
+description: "使用 Hystrix 对 Dubbo 服务进行熔断限流保护"
+linkTitle: Hystrix 熔断降级
+title: Hystrix 熔断降级
type: docs
-weight: 20
+weight: 2
---
-
-
## 背景
Hystrix 旨在通过控制那些访问远程系统、服务和第三方库的节点,从而对延迟和故障提供更强大的容错能力。Hystrix具备拥有回退机制和断路器功能的线程和信号隔离,请求缓存和请求打包,以及监控和配置等功能。
-Dubbo是Alibaba开源的,目前国内最流行的java rpc框架。
-
-本文介绍在spring应用里,怎么把Dubbo和Hystrix结合起来使用。
+本文介绍在spring应用里,怎么把 Dubbo 和 Hystrix 结合起来使用。
- <https://github.com/Netflix/Hystrix>
- <https://github.com/apache/dubbo>
## Spring Boot应用
-Demo地址: <https://github.com/dubbo/dubbo-samples/tree/master/4-governance/dubbo-samples-spring-boot-hystrix>
+Demo 地址: <https://github.com/dubbo/dubbo-samples/tree/master/4-governance/dubbo-samples-spring-boot-hystrix>
### 生成dubbo集成spring boot的应用
-对于不熟悉dubbo 集成spring boot应用的同学,可以在这里直接生成dubbo + spring boot的工程: <http://start.dubbo.io/>
+对于不熟悉dubbo 集成spring boot应用的同学,可以在这里直接生成dubbo + spring boot的工程: <http://start.dubbo.apache.org/bootstrap.html/>
### 配置spring-cloud-starter-netflix-hystrix
@@ -143,7 +139,7 @@ public class HystrixCommandAspect {
@EnableCircuitBreaker
public @interface EnableHystrix {
}
-
+
@Import(EnableCircuitBreakerImportSelector.class)
public @interface EnableCircuitBreaker {
}
@@ -158,7 +154,7 @@ public class HystrixCommandAspect {
```java
@Configuration
public class HystrixCircuitBreakerConfiguration {
-
+
@Bean
public HystrixCommandAspect hystrixCommandAspect() {
return new HystrixCommandAspect();
diff --git a/content/zh-cn/overview/tasks/rate-limit/resilience4j.md b/content/zh-cn/overview/tasks/rate-limit/resilience4j.md
new file mode 100644
index 0000000000..5570a80a7e
--- /dev/null
+++ b/content/zh-cn/overview/tasks/rate-limit/resilience4j.md
@@ -0,0 +1,11 @@
+---
+description: "使用 Resilience4j 断路器、限流器、重试、隔离机制保护 Dubbo 应用"
+linkTitle: Resilience4j
+title: Resilience4j
+type: docs
+weight: 3
+---
+
+Resilience4j 提供了一组高阶函数(装饰器),包括断路器,限流器,重试,隔离,可以对任何的函数式接口,lambda表达式,或方法的引用进行增强,并且这些装饰器可以进行叠加。这样做的好处是,你可以根据需要选择特定的装饰器进行组合。
+
+关于 Resilience4j 与 Dubbo 集成的使用示例请参见 [dubbo-samples-resilience4j](https://github.com/apache/dubbo-samples/tree/master/3-extensions/protocol/dubbo-samples-resilience4j)
\ No newline at end of file
diff --git a/content/zh-cn/overview/tasks/ecosystem/rate-limit.md b/content/zh-cn/overview/tasks/rate-limit/sentinel.md
similarity index 77%
rename from content/zh-cn/overview/tasks/ecosystem/rate-limit.md
rename to content/zh-cn/overview/tasks/rate-limit/sentinel.md
index c797dea424..b84190692b 100644
--- a/content/zh-cn/overview/tasks/ecosystem/rate-limit.md
+++ b/content/zh-cn/overview/tasks/rate-limit/sentinel.md
@@ -1,21 +1,23 @@
---
aliases:
- - /zh/overview/tasks/ecosystem/rate-limit/
-description: 使用 Sentinel 保护您的应用,防止应用因个别服务的突发流量过载而出现稳定性问题。
-linkTitle: 限流降级
-title: 限流降级
+ - /zh-cn/overview/tasks/ecosystem/rate-limit/
+ - /zh-cn/overview/what/ecosystem/rate-limit/
+ - /zh-cn/overview/what/ecosystem/rate-limit/sentinel/
+description: "使用 Sentinel 保护您的应用,防止应用因个别服务的突发流量过载而出现稳定性问题。"
+linkTitle: Sentinel 限流
+title: Sentinel 限流
type: docs
-weight: 3
+weight: 1
---
-
-
## Sentinel 是什么
随着微服务的流行,服务和服务之间的稳定性变得越来越重要。Sentinel 是面向分布式、多语言异构化服务架构的流量治理组件,主要以流量为切入点,从流量路由、流量控制、流量整形、熔断降级、系统自适应过载保护、热点流量防护等多个维度来帮助开发者保障微服务的稳定性。
## 一、示例架构说明
+完整示例项目地址 <a href="https://github.com/apache/dubbo-samples/tree/master/4-governance/dubbo-samples-sentinel" target="_blank">dubbo-samples-sentinel</a>
+
接口定义:
```java
@@ -96,4 +98,4 @@ Blocked
Blocked
```
-> 关于 Sentinel 的更多使用方式可以参考:[Sentinel 为 Dubbo 服务保驾护航](/zh-cn/blog/2018/07/27/sentinel-为-dubbo-服务保驾护航/),[Sentinel 官网](https://sentinelguard.io/zh-cn/index.html)
+> 关于 Sentinel 的更多使用方式可以参考:[Sentinel 为 Dubbo 服务保驾护航]({{< relref "../../../../blog/integration/sentinel-introduction-for-dubbo" >}}),[Sentinel 官网](https://sentinelguard.io/zh-cn/index.html)
\ No newline at end of file
diff --git a/content/zh-cn/overview/tasks/traffic-management/accesslog.md b/content/zh-cn/overview/tasks/traffic-management/accesslog.md
index ab2b48c3d4..776778eb28 100644
--- a/content/zh-cn/overview/tasks/traffic-management/accesslog.md
+++ b/content/zh-cn/overview/tasks/traffic-management/accesslog.md
@@ -14,7 +14,7 @@ weight: 3
## 开始之前
* [部署 Shop 商城项目](../#部署商场系统)
-* 部署并打开 [Dubbo Admin](../../deploy)
+* 部署并打开 [Dubbo Admin](../.././../reference/admin/architecture/)
## 任务详情
diff --git a/content/zh-cn/overview/tasks/traffic-management/arguments.md b/content/zh-cn/overview/tasks/traffic-management/arguments.md
index 3588f95195..7a32622c11 100644
--- a/content/zh-cn/overview/tasks/traffic-management/arguments.md
+++ b/content/zh-cn/overview/tasks/traffic-management/arguments.md
@@ -17,7 +17,7 @@ weight: 6
## 开始之前
* [部署 Shop 商城项目](../#部署商场系统)
-* 部署并打开 [Dubbo Admin](../../deploy)
+* 部署并打开 [Dubbo Admin](../.././../reference/admin/architecture/)
## 任务详情
@@ -84,4 +84,4 @@ conditions:
* arguments[0]=1~100
* url_key=value
-更为灵活的是,条件路由的匹配条件支持扩展,用户可以自定义匹配条件的来源和格式,具体可参见 [条件路由规则说明](/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/traffic/routing-rule/)。
+更为灵活的是,条件路由的匹配条件支持扩展,用户可以自定义匹配条件的来源和格式,具体可参见 [条件路由规则说明](/zh-cn/overview/core-features/traffic/condition-rule/)。
diff --git a/content/zh-cn/overview/tasks/traffic-management/host.md b/content/zh-cn/overview/tasks/traffic-management/host.md
index 4d0d61b9c6..db0375140c 100644
--- a/content/zh-cn/overview/tasks/traffic-management/host.md
+++ b/content/zh-cn/overview/tasks/traffic-management/host.md
@@ -15,7 +15,7 @@ weight: 9
## 开始之前
* [部署 Shop 商城项目](../#部署商场系统)
-* 部署并打开 [Dubbo Admin](../../deploy)
+* 部署并打开 [Dubbo Admin](../.././../reference/admin/architecture/)
## 任务详情
diff --git a/content/zh-cn/overview/tasks/traffic-management/isolation.md b/content/zh-cn/overview/tasks/traffic-management/isolation.md
index 545f79a305..dd854a7d28 100644
--- a/content/zh-cn/overview/tasks/traffic-management/isolation.md
+++ b/content/zh-cn/overview/tasks/traffic-management/isolation.md
@@ -21,7 +21,7 @@ weight: 5
## 开始之前
* [部署 Shop 商城项目](../#部署商场系统)
-* 部署并打开 [Dubbo Admin](../../deploy)
+* 部署并打开 [Dubbo Admin](../.././../reference/admin/architecture/)
## 任务详情
@@ -104,6 +104,6 @@ force: true
## 其他事项
-除了示例中演示的动态环境划分,也可以在部署态指定实例所属流量标签(通过一个特殊的 key `dubbo.provider.tag` 实现),这样当实例启动成功后就已经被自动圈定在某个流量环境,具体配置方式可参见 [标签路由](/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/traffic/routing-rule/) 说明。
+除了示例中演示的动态环境划分,也可以在部署态指定实例所属流量标签(通过一个特殊的 key `dubbo.provider.tag` 实现),这样当实例启动成功后就已经被自动圈定在某个流量环境,具体配置方式可参见 [标签路由](/zh-cn/overview/core-features/traffic/tag-rule/) 说明。
通常,`dubbo.tag` 流量标的传递需要依赖全链路追踪工具的帮助,Dubbo 只会负责 A-B 的点对点标签传递,示例中也是通过在每次点对点 RPC 调用前重复设置达成的传递效果,在实践中,全链路灰度往往从 tag 设置进全链路上下文后自动启动,我们只需要扩展 Dubbo Filter 将全链路工具上下文中的 tag 标签读取并设置进 Dubbo 上下文即可实现全链路在 Dubbo 中的自动传递,具体可参见 [Dubbo 链路追踪集成示例](../../observability)。另外,除了 RPC 调用,在微服务体系的其他基础产品中也需要依赖全链路上下文保证灰度标识的传递,以保证完整的流量隔离环境。
diff --git a/content/zh-cn/overview/tasks/traffic-management/mock.md b/content/zh-cn/overview/tasks/traffic-management/mock.md
index a93681f7cc..af15637566 100644
--- a/content/zh-cn/overview/tasks/traffic-management/mock.md
+++ b/content/zh-cn/overview/tasks/traffic-management/mock.md
@@ -17,7 +17,7 @@ weight: 8
## 开始之前
* [部署 Shop 商城项目](../#部署商场系统)
-* 部署并打开 [Dubbo Admin](../../deploy)
+* 部署并打开 [Dubbo Admin](../.././../reference/admin/architecture/)
## 任务详情
@@ -66,6 +66,6 @@ configs:
## 其他事项
-服务降级功能也可以用于开发测试环境,由于微服务分布式的特点,不同的服务或应用之间都有相互依赖关系,因此,一个服务或应用很难不依赖其他服务而独立部署工作。但测试环境下并不是所有服务都是随时就绪的状态,这对于微服务强调的服务独立演进是一个很大的障碍,通过服务降级这个功能,我们可以模拟或短路应用对其他服务的依赖,从而可以让应用按照自己预期的行为 Mock 外部服务调用的返回结果。具体可参见 [Dubbo Admin 服务 Mock](/) 特性的使用方式。
+服务降级功能也可以用于开发测试环境,由于微服务分布式的特点,不同的服务或应用之间都有相互依赖关系,因此,一个服务或应用很难不依赖其他服务而独立部署工作。但测试环境下并不是所有服务都是随时就绪的状态,这对于微服务强调的服务独立演进是一个很大的障碍,通过服务降级这个功能,我们可以模拟或短路应用对其他服务的依赖,从而可以让应用按照自己预期的行为 Mock 外部服务调用的返回结果。具体可参见 [Dubbo Admin 服务 Mock](../.././../reference/admin/mock/) 特性的使用方式。
-Dubbo 的降级规则用来设置发生降级时的行为和返回值,而对于何时应该执行限流降级动作,即限流降级时机的判断并没有过多涉猎,这一点 Dubbo 通过集成更专业的限流降级产品如 Sentinel 进行了补全,可以配合 Dubbo 降级规则一起使用,具体可参见 [限流降级](../../ecosystem/rate-limit/) 文档。
+Dubbo 的降级规则用来设置发生降级时的行为和返回值,而对于何时应该执行限流降级动作,即限流降级时机的判断并没有过多涉猎,这一点 Dubbo 通过集成更专业的限流降级产品如 Sentinel 进行了补全,可以配合 Dubbo 降级规则一起使用,具体可参见 [限流降级](/zh-cn/overview/core-features/traffic/circuit-breaking/) 文档。
diff --git a/content/zh-cn/overview/tasks/traffic-management/region.md b/content/zh-cn/overview/tasks/traffic-management/region.md
index 1dc77b84b3..d8151cd62e 100644
--- a/content/zh-cn/overview/tasks/traffic-management/region.md
+++ b/content/zh-cn/overview/tasks/traffic-management/region.md
@@ -17,7 +17,7 @@ weight: 4
## 开始之前
* [部署 Shop 商城项目](../#部署商场系统)
-* 部署并打开 [Dubbo Admin](../../deploy)
+* 部署并打开 [Dubbo Admin](../.././../reference/admin/architecture/)
## 任务详情
diff --git a/content/zh-cn/overview/tasks/traffic-management/retry.md b/content/zh-cn/overview/tasks/traffic-management/retry.md
index 9bffc100e1..1d0bac9c28 100644
--- a/content/zh-cn/overview/tasks/traffic-management/retry.md
+++ b/content/zh-cn/overview/tasks/traffic-management/retry.md
@@ -14,7 +14,7 @@ weight: 2
## 开始之前
* [部署 Shop 商城项目](../#部署商场系统)
-* 部署并打开 [Dubbo Admin](../../deploy)
+* 部署并打开 [Dubbo Admin](../.././../reference/admin/architecture/)
## 任务详情
diff --git a/content/zh-cn/overview/tasks/traffic-management/timeout.md b/content/zh-cn/overview/tasks/traffic-management/timeout.md
index 3a0b36bd17..10e91a53d4 100644
--- a/content/zh-cn/overview/tasks/traffic-management/timeout.md
+++ b/content/zh-cn/overview/tasks/traffic-management/timeout.md
@@ -14,7 +14,7 @@ Dubbo 提供动态调整服务超时时间的能力,在无需重启应用的
## 开始之前
* [部署 Shop 商城项目](../#部署商场系统)
-* 部署并打开 [Dubbo Admin](../../deploy)
+* 部署并打开 [Dubbo Admin](../.././../reference/admin/architecture/)
## 任务详情
diff --git a/content/zh-cn/overview/tasks/traffic-management/weight.md b/content/zh-cn/overview/tasks/traffic-management/weight.md
index 92e6136840..f347019ef3 100644
--- a/content/zh-cn/overview/tasks/traffic-management/weight.md
+++ b/content/zh-cn/overview/tasks/traffic-management/weight.md
@@ -20,7 +20,7 @@ Dubbo 提供了基于权重的负载均衡算法,可以实现按比例的流
## 开始之前
* [部署 Shop 商城项目](../#部署商场系统)
-* 部署并打开 [Dubbo Admin](../../deploy)
+* 部署并打开 [Dubbo Admin](../.././../reference/admin/architecture/)
## 任务详情
diff --git a/content/zh-cn/overview/what/advantages/_index.md b/content/zh-cn/overview/what/advantages/_index.md
index 02335ca85a..60ad035cb5 100644
--- a/content/zh-cn/overview/what/advantages/_index.md
+++ b/content/zh-cn/overview/what/advantages/_index.md
@@ -5,5 +5,5 @@ description: ""
linkTitle: 核心优势
title: 核心优势
type: docs
-weight: 3
+weight: 4
---
diff --git a/content/zh-cn/overview/what/advantages/performance.md b/content/zh-cn/overview/what/advantages/performance.md
index 6c21f5ed23..0066495d2e 100644
--- a/content/zh-cn/overview/what/advantages/performance.md
+++ b/content/zh-cn/overview/what/advantages/performance.md
@@ -16,19 +16,27 @@ Dubbo 内置支持 Dubbo2、Triple 两款高性能通信协议。其中
* Dubbo2 是基于 TCP 传输协议之上构建的二进制私有 RPC 通信协议,是一款非常简单、紧凑、高效的通信协议。
* Triple 是基于 HTTP/2 的新一代 RPC 通信协议,在网关穿透性、通用性以及 Streaming 通信上具备优势,Triple 完全兼容 gRPC 协议。
-Dubbo TCP Protocol benchmark 性能指标
+以下是基于 Dubbo 3.2 版本得出的压测指标数据,您也可以通过 [dubbo-benchmark](https://github.com/apache/dubbo-benchmark) 项目自行压测。
-
+### TCP protocol benchmark
-Triple benchmark 性能指标
+对比 Dubbo 2.x 及早期 3.x 版本
+* 较小报文场景 createUser、getUser 下,提升率约 180%。
+* 极小报文 existUser(仅一个boolean值)下提升率约 24%
+* 较大报文 listUser 提升率最高,达到了 1000%!
-
+
+
+### Triple protocol benchmark
+
+* 较小报文场景 createUser、existUser、getUser 下,较 3.1 版本性能提升约 40-45%,提升后的性能与 gRPC 同场景的性能基本持平。
+* 较大报文场景 listUser 下较 3.1 版本提升了约 17%,相较于同场景下的 gRPC 低 11%。
+
+
了解更多
* [通信协议](../../../core-features/protocols)
-* [Benchmark 指标](../../../mannual/java-sdk/reference-manual/performance/rpc-benchmarking)
-
-## 流式通信
+* [Benchmark 指标 (不定期更新)](https://github.com/apache/dubbo/issues/10558#issuecomment-1473015636)
## 构建可伸缩的微服务集群
业务增长带来了集群规模的快速增长,而集群规模的增长会对服务治理架构带来挑战:
@@ -41,9 +49,19 @@ Triple benchmark 性能指标
以上内容直接关系到微服务集群的稳定性,因此很容易成为影响集群和业务增长的瓶颈,集群规模越大,问题带来的影响面也就被进一步放大。很多开发者可能会想只有几个应用而已,当前不需要并不关心集群规模,但作为技术架构选型的关键因素之一,我们还是要充分考虑微服务集群未来的可伸缩性。并且基于对业界大量微服务架构和框架实现的调研,一些产品的性能瓶颈点可能很快就会到来(部分产品所能高效支持的瓶颈节点规模阈值都是比较低的,比如几十个应用、数百个节点)。
-
-
Dubbo 的优势在于近乎无限水平扩容的集群规模,在阿里巴巴双十一场景万亿次调用的实践检验,通过以下内容了解 Dubbo 构建生产可用的、可伸缩的大规模微服务集群背后的原理:
-* [Dubbo3 服务发现](/)
-* [流量管控](/)
-* [源码解析](/)
+* [Dubbo3 服务发现](../../../core-features/service-discovery/)
+* [流量管控](../../../core-features/traffic/)
+
+## 智能化流量调度
+Dubbo3 内置了具备自适应感知集群负载状态、智能调节流量分布的限流与调度算法实现,从消费者、提供者两个不同视角智能调整流量分布,最大限度确保将流量调度到具有最佳处理能力的实例上,从而提升整个集群的吞吐量与稳定性。
+
+### 自适应负载均衡
+自适应负载均衡是从消费者视角考虑如何将请求分配到当前具有最优处理能力的机器实例。Dubbo3 新引入了两种负载均衡算法
+* 一种是基于公平性考虑的单纯 `P2C` 算法
+* 另一种是基于自适应的方法 `adaptive`,其试图自适应的衡量 provider 端机器的吞吐能力,然后将流量尽可能分配到吞吐能力高的机器上,以提高系统整体的性能。
+
+### 自适应限流
+与负载均衡运行在消费者端不同的是,限流功能运行在提供者端。其作用是限制提供端实例处理并发任务时的最大数量。从理论上讲,服务端机器的处理能力是存在上限的,因此当并发请求量达到或接近上限时,拒绝掉一部分请求反而是更好的选择。相比于人为提前设置静态最大并发值,自适应限流算法可以动态调整服务端机器的最大并发值,使其可以在保证机器不过载的前提下,尽可能多的处理接收到的请求。
+
+关于这部分请参考 [Dubbo3 服务柔性设计文档](../../../reference/proposals/heuristic-flow-control)
\ No newline at end of file
diff --git a/content/zh-cn/overview/what/advantages/usability.md b/content/zh-cn/overview/what/advantages/usability.md
index b57d467769..822400230a 100644
--- a/content/zh-cn/overview/what/advantages/usability.md
+++ b/content/zh-cn/overview/what/advantages/usability.md
@@ -30,15 +30,15 @@ Dubbo 微服务间远程通信实现细节,支持 HTTP、HTTP/2、gRPC、TCP
## 加速微服务开发
### 项目脚手架
-项目脚手架让 Dubbo 项目创建、依赖管理更容易。
+<a href="https://start.dubbo.apache.org/bootstrap.html" target="_blank">项目脚手架</a> 让 Dubbo 项目创建、依赖管理更容易。
-比如通过如下可视化界面,勾选 Dubbo 版本、Zookeeper 注册中心以及必要的微服务生态选项后,一个完整的 Dubbo 项目模板就可以自动生成,接下来基于脚手架项目添加业务逻辑就可以了。
+比如通过如下可视化界面,勾选 Dubbo 版本、Zookeeper 注册中心以及必要的微服务生态选项后,一个完整的 Dubbo 项目模板就可以自动生成,接下来基于脚手架项目添加业务逻辑就可以了。更多脚手架使用方式的讲解,请参见任务模块的 [通过模板生成项目脚手架](../../../tasks/develop/template/)

### 开发测试
相比于单体应用,微服务分布式的特性会让不同组织之间的研发协同变得困难,这时我们需要有效的配套工具,用来提升整体的微服务研发效率。
-Dubbo 从内核设计和实现阶段就考虑了如何解决开发、测试与运维问题,配合官方提供的生态工具,可以实现服务测试、服务 Mock、文档管理、单机运维等能力,并通过 Dubbo Admin 控制台将所有操作都可视化的展现出来。
+Dubbo 从内核设计和实现阶段就考虑了如何解决开发、测试与运维问题,比如 Dubbo RPC 协议均支持 curl 访问,让开发协作更简单;配合官方提供的生态工具,可以实现服务测试、服务 Mock、文档管理、单机运维等能力,并通过 Dubbo Admin 控制台将所有操作都可视化的展现出来。

diff --git a/content/zh-cn/overview/what/ecosystem/_index.md b/content/zh-cn/overview/what/ecosystem/_index.md
deleted file mode 100644
index 9aa8ebd722..0000000000
--- a/content/zh-cn/overview/what/ecosystem/_index.md
+++ /dev/null
@@ -1,179 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/
-description: ""
-linkTitle: 生态
-no_list: true
-title: 生态
-type: docs
-weight: 4
----
-
-
-
-{{< blocks/section color="white" height="auto">}}
-<div class="td-content list-page">
- <div class="lead"></div><header class="article-meta">
- </header><div class="row">
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./protocol/" >}}'>协议</a>
- </h4>
- <p>Dubbo 提供以下协议类型的支持:</p>
- <p><a href='{{< relref "./protocol/dubbo" >}}'>Dubbo 协议</a></p>
- <p><a href='{{< relref "./protocol/triple" >}}'>Triple 协议</a></p>
- <p><a href='{{< relref "./protocol/gRPC" >}}'>gRPC 协议</a></p>
- <p><a href='{{< relref "./protocol/http" >}}'>HTTP / Rest 协议</a></p>
- <p><a href='{{< relref "./protocol/thrift" >}}'>Thrift 协议</a></p>
- <p><a href='{{< relref "./protocol/rmi" >}}'>RMI 协议</a></p>
- </div>
- </div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./serialization/" >}}'>序列化</a>
- </h4>
- <p>Dubbo 提供以下序列化类型的支持:</p>
- <p><a href='{{< relref "./serialization/hessian" >}}'>Hessian 2</a></p>
- <p><a href='{{< relref "./serialization/fastjson2" >}}'>Fastjson 2</a></p>
- <p><a href='{{< relref "./serialization/protobuf" >}}'>Protobuf</a></p>
- <p><a href='{{< relref "./serialization/fastjson" >}}'>Fastjson</a></p>
- <p><a href='{{< relref "./serialization/gson" >}}'>Gson</a></p>
- <p><a href='{{< relref "./serialization/msgpack" >}}'>MessagePack</a></p>
- <p><a href='{{< relref "./serialization/avro" >}}'>Avro</a></p>
- <p><a href='{{< relref "./serialization/fst" >}}'>FST</a></p>
- <p><a href='{{< relref "./serialization/kryo" >}}'>Kryo</a></p>
- </div>
- </div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./registry/" >}}'>注册中心</a>
- </h4>
- <p>Dubbo 提供以下注册中心的支持:</p>
- <p><a href='{{< relref "./registry/zookeeper" >}}'>Zookeeper</a></p>
- <p><a href='{{< relref "./registry/nacos" >}}'>Nacos</a></p>
- <p><a href='{{< relref "./registry/consul" >}}'>Consul</a></p>
- <p><a href='{{< relref "./registry/sofa" >}}'>Sofa</a></p>
- <p><a href='{{< relref "./registry/polaris" >}}'>Polaris</a></p>
- <p><a href='{{< relref "./registry/eureka" >}}'>Eureka</a></p>
- <p><a href='{{< relref "./registry/etcd" >}}'>Etcd</a></p>
- </div>
- </div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./config-center/" >}}'>配置中心</a>
- </h4>
- <p>Dubbo 提供以下配置中心的支持:</p>
- <p><a href='{{< relref "./config-center/zookeeper" >}}'>Zookeeper</a></p>
- <p><a href='{{< relref "./config-center/nacos" >}}'>Nacos</a></p>
- <p><a href='{{< relref "./config-center/apollo" >}}'>Apollo</a></p>
- </div>
- </div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./metadata-center/" >}}'>元数据中心</a>
- </h4>
- <p>Dubbo 提供以下元数据中心的支持:</p>
- <p><a href='{{< relref "./metadata-center/zookeeper" >}}'>Zookeeper</a></p>
- <p><a href='{{< relref "./metadata-center/nacos" >}}'>Nacos</a></p>
- <p><a href='{{< relref "./metadata-center/Redis" >}}'>Redis</a></p>
- </div>
- </div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./gateway/" >}}'>网关</a>
- </h4>
- <p>Dubbo 提供以下网关的支持:</p>
- <p><a href='{{< relref "./gateway/apisix" >}}'>APISIX</a></p>
- <p><a href='{{< relref "./gateway/shenyu" >}}'>Shenyu</a></p>
- <p><a href='{{< relref "./gateway/higress" >}}'>Higress</a></p>
- <p><a href='{{< relref "./gateway/kong" >}}'>Kong</a></p>
- <p><a href='{{< relref "./gateway/pixiu" >}}'>Pixiu</a></p>
- <p><a href='{{< relref "./gateway/tengine" >}}'>Tengine</a></p>
- </div>
- </div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./service-mesh/" >}}'>Service Mesh</a>
- </h4>
- <p>Dubbo 提供以下 Service Mesh 控制平面的支持:</p>
- <p><a href='{{< relref "./service-mesh/istio" >}}'>istio</a></p>
- <p><a href='{{< relref "./service-mesh/aeraki" >}}'>Aeraki</a></p>
- </div>
- </div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./rate-limit/" >}}'>限流降级</a>
- </h4>
- <p>Dubbo 提供以下限流降级的支持:</p>
- <p><a href='{{< relref "./rate-limit/sentinel" >}}'>Sentinel</a></p>
- <p><a href='{{< relref "./rate-limit/polaris" >}}'>Polaris</a></p>
- <p><a href='{{< relref "./rate-limit/hystrix" >}}'>Hystrix</a></p>
- </div>
- </div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./transaction/" >}}'>全局事务</a>
- </h4>
- <p>Dubbo 提供以下全局事务的支持:</p>
- <p><a href='{{< relref "./transaction/seata" >}}'>Seata</a></p>
- </div>
- </div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./tracing/" >}}'>链路追踪</a>
- </h4>
- <p>Dubbo 提供以下链路追踪的支持:</p>
- <p><a href='{{< relref "./tracing/skywalking" >}}'>Skywalking</a></p>
- <p><a href='{{< relref "./tracing/zipkin" >}}'>Zipkin</a></p>
- <p><a href='{{< relref "./tracing/micrometer" >}}'>MicroMeter</a></p>
- <p><a href='{{< relref "./tracing/opentelemetry" >}}'>OpenTelemetry</a></p>
- </div>
- </div>
- </div>
- <div class="col-sm col-md-6 mb-4">
- <div class="h-100 card shadow" href="#">
- <div class="card-body">
- <h4 class="card-title">
- <a href='{{< relref "./monitoring/" >}}'>监控</a>
- </h4>
- <p>Dubbo 提供以下监控平台的支持:</p>
- <p><a href='{{< relref "./monitoring/prometheus" >}}'>Prometheus</a></p>
- <p><a href='{{< relref "./monitoring/grafana" >}}'>Grafana</a></p>
- <p><a href='{{< relref "./monitoring/micrometer" >}}'>MicroMeter</a></p>
- </div>
- </div>
- </div>
-</div>
-<hr>
-</div>
-
-{{< /blocks/section >}}
diff --git a/content/zh-cn/overview/what/ecosystem/config-center/_index.md b/content/zh-cn/overview/what/ecosystem/config-center/_index.md
deleted file mode 100644
index 1314d69128..0000000000
--- a/content/zh-cn/overview/what/ecosystem/config-center/_index.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/config-center/
-description: ""
-linkTitle: 配置中心
-title: 配置中心
-type: docs
-weight: 40
----
diff --git a/content/zh-cn/overview/what/ecosystem/config-center/apollo.md b/content/zh-cn/overview/what/ecosystem/config-center/apollo.md
deleted file mode 100644
index 030d0776d2..0000000000
--- a/content/zh-cn/overview/what/ecosystem/config-center/apollo.md
+++ /dev/null
@@ -1,119 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/config-center/apollo/
-description: ""
-linkTitle: Apollo
-title: Apollo
-type: docs
-weight: 30
----
-
-
-
-## 1 介绍
-
-Apollo(阿波罗)是一款可靠的分布式配置管理中心,诞生于携程框架研发部,能够集中化管理应用不同环境、不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限、流程治理等特性,适用于微服务配置管理场景。
-
-
-## 2 使用说明
-在此查看[完整示例代码](https://github.com/apache/dubbo-samples/tree/master/3-extensions/configcenter/dubbo-samples-configcenter-apollo)
-
-### 2.1 增加 Maven 依赖
-
-```xml
-<dependency>
- <groupId>org.apache.dubbo</groupId>
- <artifactId>dubbo</artifactId>
- <version>3.0.9</version>
-</dependency>
-<dependency>
- <groupId>com.ctrip.framework.apollo</groupId>
- <artifactId>apollo-openapi</artifactId>
- <version>2.0.0</version>
-</dependency>
-<dependency>
- <groupId>com.ctrip.framework.apollo</groupId>
- <artifactId>apollo-client</artifactId>
- <version>2.0.0</version>
-</dependency>
-```
-
-### 2.2 启用 Apollo 配置中心
-```xml
-<dubbo:config-center address="apollo://localhost:8080"/>
-```
-
-或者
-
-```yaml
-dubbo
- config-center
- address: apollo://localhost:8080
-```
-
-或者
-
-```properties
-dubbo.config-center.address=apollo://localhost:8080
-```
-
-或者
-
-```java
-ConfigCenterConfig configCenter = new ConfigCenterConfig();
-configCenter.setAddress("apollo://localhost:8080");
-```
-
-## 3 高级配置
-Apollo中的一个核心概念是命名空间 - namespace,和上面 Zookeeper、Nacos 的 namespace 概念不同,因此使用方式上也比较特殊些,建议充分了解 Apollo 自身的用法后再阅读以下文档内容。
-
-但总的来说,对 Apollo 的适配而言:
-* namespace 特用于流量治理规则隔离,参见 3.1
-* group 特用于外部化配置的隔离,参见 3.2
-
-### 3.1 外部化配置
-
-```xml
-<dubbo:config-center group="demo-provider" address="apollo://localhost:8080"/>
-```
-
-config-center 的 `group` 决定了 Apollo 读取外部化配置 `dubbo.properties` 文件的位置:
-1. 如果 group 为空,则默认从 `dubbo` namespace 读取配置,用户须将外部化配置写在 `dubbo` namespace 下。
-2. 如果 group 不为空
- 2.1 group 值为应用名,则从应用当前的 namespace 读取配置,用户须将外部化配置写在 Apollo 自动指定的应用默认 namespace 下。
- 2.2 group 值为任意值,则从对应的 namespace 读取配置,用户须将外部化配置写在该 namespace 下。
-
-如以下示例是用的默认 group='dubbo' 的全局外部化配置,即该配置可被所有应用读取到。
-
-
-如果配置 group='应用名' 则是应用特有配置,只有该应用可以读取到。
-
-> 关于外部化文件配置托管,相当于是把 `dubbo.properties` 配置文件的内容存储在了 Apollo 中。每个应用都可以通过关联共享的 `dubbo` namespace 继承公共配置, 进而可以单独覆盖个别配置项。
-### 3.2 流量治理规则
-**流量治理规则一定都是全局共享的,因此每个应用内的 namespace 配置都应该保持一致。**
-
-```xml
-<dubbo:config-center namespace="governance" address="apollo://localhost:8080"/>
-```
-
-config-center 的 `namespace` 决定了 Apollo 存取 `流量治理规则` 的位置:
-1. 如果 namespace 为空,则默认从 `dubbo` namespace 存取配置,须治理规则写在 `dubbo` namespace 下。
-2. 如果 namespace 不为空,则从对应的 namespace 值读取规则,须治理规则写在该 namespace 下。
-
-如以下示例是通过 `namespace='governance'` 将流量治理规则放在了 `governance` namespace 下。
-
-
-### 3.3 更多 Apollo 特有配置
-当前 Dubbo 适配了 env、apollo.meta、apollo.cluster、apollo.id 等特有配置项,可通过 config-center 的扩展参数进行配置。
-
-如
-```properties
-dubbo.config-center.address=apollo://localhost:8080
-```
-
-或者
-
-```properties
-dubbo.config-center.prameters.apollo.meta=xxx
-dubbo.config-center.prameters.env=xxx
-```
\ No newline at end of file
diff --git a/content/zh-cn/overview/what/ecosystem/config-center/nacos.md b/content/zh-cn/overview/what/ecosystem/config-center/nacos.md
deleted file mode 100644
index e24047b39c..0000000000
--- a/content/zh-cn/overview/what/ecosystem/config-center/nacos.md
+++ /dev/null
@@ -1,61 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/config-center/nacos/
-description: ""
-linkTitle: Nacos
-title: Nacos
-type: docs
-weight: 20
----
-
-
-
-## 1 介绍
-
-Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。
-
-Nacos 致力于帮助您发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。
-
-Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。 Nacos 是构建以“服务”为中心的现代应用架构 (例如微服务范式、云原生范式) 的服务基础设施。
-
-参考文档:https://nacos.io/zh-cn/docs/v2/what-is-nacos.html
-
-
-## 2 使用说明 - Java
-Dubbo 融合 Nacos 成为元数据中心的操作步骤非常简单,大致分为 `增加 Maven 依赖` 以及 `配置元数据中心` 两步。
-> 如果元数据地址(dubbo.metadata-report.address)也不进行配置,会使用注册中心的地址来用作元数据中心。
-
-### 2.1 增加 Maven 依赖
-
-如果项目已经启用 Nacos 作为注册中心,则无需增加任何额外配置。
-
-如果未启用 Nacos 注册中心,则请参考 [为注册中心增加 Nacos 依赖](../../registry/nacos/#21-增加依赖)。
-> 当Dubbo使用`3.0.0`及以上版本时,需要使用Nacos `2.0.0`及以上版本
-
-### 2.2 启用 Nacos 配置中心
-```xml
-<dubbo:config-center address="nacos://127.0.0.1:8848"/>
-```
-
-或者
-
-```yaml
-dubbo:
- config-center:
- address: nacos://127.0.0.1:8848
-```
-
-或者
-
-```properties
-dubbo.config-center.address=nacos://127.0.0.1:8848
-```
-
-或者
-
-```java
-ConfigCenterConfig configCenterConfig = new ConfigCenterConfig();
-configCenterConfig.setAddress("nacos://127.0.0.1:8848");
-```
-
-`address` 格式请参考 [Nacos 注册中心 - 启用配置](../../registry/nacos/#22-配置并启用-nacos)
\ No newline at end of file
diff --git a/content/zh-cn/overview/what/ecosystem/config-center/zookeeper.md b/content/zh-cn/overview/what/ecosystem/config-center/zookeeper.md
deleted file mode 100644
index 940e9cc0c0..0000000000
--- a/content/zh-cn/overview/what/ecosystem/config-center/zookeeper.md
+++ /dev/null
@@ -1,113 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/config-center/zookeeper/
-description: ""
-linkTitle: Zookeeper
-title: Zookeeper
-type: docs
-weight: 10
----
-
-
-
-
-## 1 介绍
-
-Apache ZooKeeper是Apache软件基金会的一个软件项目,它为大型分布式计算提供开源的分布式配置服务、同步服务和命名注册。 ZooKeeper曾经是Hadoop的一个子项目,但现在是一个独立的顶级项目。
-
-ZooKeeper的架构通过冗余服务实现高可用性。因此,如果第一次无应答,客户端就可以询问另一台ZooKeeper主机。ZooKeeper节点将它们的数据存储于一个分层的名字空间,非常类似于一个文件系统或一个前缀树结构。客户端可以在节点读写,从而以这种方式拥有一个共享的配置服务。更新是全序的。
-
-
-## 2 使用说明 - Java
-
-在此查看[完整示例代码](https://github.com/apache/dubbo-samples/tree/master/3-extensions/registry/dubbo-samples-zookeeper)
-
-### 2.1 增加 Maven 依赖
-```xml
-<properties>
- <dubbo.version>3.1.6</dubbo.version>
-</properties>
-
-<dependencies>
- <!-- This dependency helps to introduce Curator and Zookeeper dependencies that are necessary for Dubbo to work with zookeeper as transitive dependencies -->
- <dependency>
- <groupId>org.apache.dubbo</groupId>
- <artifactId>dubbo-dependencies-zookeeper</artifactId>
- <version>${dubbo.version}</version>
- <type>pom</type>
- </dependency>
-</dependencies>
-```
-
-`dubbo-dependencies-zookeeper` 将自动为应用增加 Zookeeper 相关客户端的依赖,减少用户使用 Zookeeper 成本,如使用中遇到版本兼容问题,用户也可以不使用 `dubbo-dependencies-zookeeper`,而是自行添加 Curator、Zookeeper Client 等依赖。
-
-由于 Dubbo 使用 Curator 作为与 Zookeeper Server 交互的编程客户端,因此,要特别注意 Zookeeper Server 与 Dubbo 版本依赖的兼容性
-
-|Zookeeper Server 版本|Dubbo 版本|Dubbo Zookeeper 依赖包|说明|
-|-----|-----|-----|-----|
-|3.4.x 及以下|3.0.x 及以上|dubbo-dependencies-zookeeper|传递依赖 Curator 4.x 、Zookeeper 3.4.x|
-|3.5.x 及以上|3.0.x 及以上|dubbo-dependencies-zookeeper-curator5|传递依赖 Curator 5.x 、Zookeeper 3.7.x|
-|3.4.x 及以上|2.7.x 及以下|dubbo-dependencies-zookeeper|传递依赖 Curator 4.x 、Zookeeper 3.4.x|
-|3.5.x 及以上|2.7.x 及以下|无|须自行添加 Curator、Zookeeper 等相关客户端依赖|
-
-### 2.2 配置并启用 Zookeeper
-```yaml
-# application.yml
-dubbo:
- config-center:
- address: zookeeper://localhost:2181
-```
-或
-```properties
-# dubbo.properties
-dubbo.config-center.address=zookeeper://localhost:2181
-```
-或
-```xml
-<dubbo:config-center address="zookeeper://localhost:2181" />
-```
-
-`address` 是启用 zookeeper 注册中心唯一必须指定的属性,而在生产环境下,`address` 通常被指定为集群地址,如
-
-`address=zookeeper://10.20.153.10:2181?backup=10.20.153.11:2181,10.20.153.12:2181`
-
-protocol 与 address 分开配置的模式也可以,如
-
-`<dubbo:config-center protocol="zookeeper" address="10.20.153.10:2181,10.20.153.11:2181,10.20.153.12:2181" />`
-
-## 3 高级配置
-### 3.1 认证与鉴权
-
-如果 Zookeeper 开启认证,Dubbo 支持指定 username、password 的方式传入身份标识。
-
-```yaml
-# application.yml
-dubbo:
- config-center:
- address: zookeeper://localhost:2181
- username: hello
- password: 1234
-```
-
-也可以直接将参数扩展在 address 上 `address=zookeeper://hello:1234@localhost:2181`
-
-### 3.2 分组隔离
-通过指定 `group` 属性,可以在同一个 Zookeeper 集群内实现微服务地址的逻辑隔离。比如可以在一套集群内隔离出多套开发环境,在地址发现层面实现隔离。
-
-```yaml
-# application.yml
-dubbo:
- config-center:
- address: zookeeper://localhost:2181
- group: daily1
-```
-### 3.3 其他扩展配置
-配置连接、会话过期时间
-```yaml
-# application.yml
-dubbo:
- config-center:
- address: zookeeper://localhost:2181
- timeout: 30 * 1000 # 连接超时时间,默认 30s
- session: 60 * 1000 # 会话超时时间,默认 60s
-```
\ No newline at end of file
diff --git a/content/zh-cn/overview/what/ecosystem/gateway/_index.md b/content/zh-cn/overview/what/ecosystem/gateway/_index.md
deleted file mode 100644
index 941212d353..0000000000
--- a/content/zh-cn/overview/what/ecosystem/gateway/_index.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/gateway/
-description: ""
-linkTitle: 网关
-title: 网关
-type: docs
-weight: 60
----
diff --git a/content/zh-cn/overview/what/ecosystem/gateway/apisix.md b/content/zh-cn/overview/what/ecosystem/gateway/apisix.md
deleted file mode 100644
index 4d7d9bf0af..0000000000
--- a/content/zh-cn/overview/what/ecosystem/gateway/apisix.md
+++ /dev/null
@@ -1,226 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/gateway/apisix/
-description: ""
-linkTitle: Apache APISIX
-title: Apache APISIX
-type: docs
-weight: 10
----
-
-
-
-## 背景
-
-[Apache Dubbo](/zh-cn/) 是由阿里巴巴开源并捐赠给 Apache 的微服务开发框架,它提供了 RPC 通信与微服务治理两大关键能力。不仅经过了阿里电商场景中海量流量的验证,也在国内的技术公司中被广泛落地。
-
-在实际应用场景中,Apache Dubbo 一般会作为后端系统间 RPC 调用的实现框架,当需要提供 HTTP 接口给到前端时,会通过一个「胶水层」将 Dubbo Service 包装成 HTTP 接口,再交付到前端系统。
-
-[Apache APISIX](https://apisix.apache.org/) 是 Apache 软件基金会的顶级开源项目,也是当前最活跃的开源网关项目。作为一个动态、实时、高性能的开源 API 网关,Apache APISIX 提供了负载均衡、动态上游、灰度发布、服务熔断、身份认证、可观测性等丰富的流量管理功能。
-
-得益于 Apache Dubbo 的应用场景优势,Apache APISIX 基于开源项目 tengine/mod_dubbo 模块为 Apache Dubbo 服务配备了HTTP 网关能力。通过 dubbo-proxy 插件,可以轻松地将 Dubbo Service 发布为 HTTP 服务。
-
-
-
-## 如何使用
-
-### 入门篇:安装使用
-
->这里我们建议使用 Apache APISIX 2.11 版本镜像进行安装。该版本的 APISIX-Base 中已默认编译了 Dubbo 模块,可直接使用 `dubbo-proxy` 插件。
-在接下来的操作中,我们将使用 [`dubbo-samples`](https://github.com/apache/dubbo-samples) 项目进行部分展示。该项目是一些使用 Apache Dubbo 实现的 Demo 应用,本文中我们采用其中的一个子模块作为 Dubbo Provider。
-
-在进入正式操作前,我们先简单看下 Dubbo 接口的定义、配置以及相关实现。
-
-#### 接口实现一览
-
-```java
-public interface DemoService {
- /**
- * standard samples dubbo infterace demo
- * @param context pass http infos
- * @return Map<String, Object></> pass to response http
- **/
- Map<String, Object> apisixDubbo(Map<String, Object> httpRequestContext);
-}
-```
-
-如上所示,Dubbo 接口的定义是固定的。即方法参数中 `Map` 表示 APISIX 传递给 Dubbo Provider 关于 HTTP request 的一些信息(如:header、body...)。而方法返回值的 `Map` 表示 Dubbo Provider 传递给 APISIX 要如何返回 HTTP response 的一些信息。
-
-接口信息配置好之后可通过 XML 配置方式发布 DemoService。
-
-```xml
-<!-- service implementation, as same as regular local bean -->
-<bean id="demoService" class="org.apache.dubbo.samples.provider.DemoServiceImpl"/>
-
-<!-- declare the service interface to be exported -->
-<dubbo:service interface="org.apache.dubbo.samples.apisix.DemoService" ref="demoService"/>
-```
-
-通过上述配置后,Consumer 可通过 `org.apache.dubbo.samples.apisix.DemoService` 访问其中的`apisixDubbo` 方法。具体接口实现如下:
-
-```java
-public class DemoServiceImpl implements DemoService {
- @Override
- public Map<String, Object> apisixDubbo(Map<String, Object> httpRequestContext) {
- for (Map.Entry<String, Object> entry : httpRequestContext.entrySet()) {
- System.out.println("Key = " + entry.getKey() + ", Value = " + entry.getValue());
- }
- Map<String, Object> ret = new HashMap<String, Object>();
- ret.put("body", "dubbo success\n"); // http response body
- ret.put("status", "200"); // http response status
- ret.put("test", "123"); // http response header
- return ret;
- }
-}
-```
-
-上述代码中,`DemoServiceImpl` 会打印接收到的 `httpRequestContext`,并通过返回包含有指定 Key 的 Map 对象去描述该 Dubbo 请求的 HTTP 响应。
-
-#### 操作步骤
-
-1. 启动 [`dubbo-samples`](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-tengine#install-dubbo)。
-2. 在 `config.yaml` 文件中进行 `dubbo-proxy` 插件启用。
-
-```yaml
-# Add this in config.yaml
-plugins:
- - ... # plugin you need
- - dubbo-proxy
-```
-
-3. 创建指向 Dubbo Provider 的 Upstream。
-
-```shell
-curl http://127.0.0.1:9180/apisix/admin/upstreams/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
-{
- "nodes": {
- "127.0.0.1:20880": 1
- },
- "type": "roundrobin"
-}'
-```
-
-4. 为 DemoService 暴露一个 HTTP 路由。
-
-```shell
-curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
-{
- "host": "example.org"
- "uris": [
- "/demo"
- ],
- "plugins": {
- "dubbo-proxy": {
- "service_name": "org.apache.dubbo.samples.apisix.DemoService",
- "service_version": "0.0.0",
- "method": "apisixDubbo"
- }
- },
- "upstream_id": 1
-}'
-```
-
-5. 使用 curl 命令请求 Apache APISIX,并查看返回结果。
-
-```shell
-curl http://127.0.0.1:9080/demo -H "Host: example.org" -X POST --data '{"name": "hello"}'
-< HTTP/1.1 200 OK
-< Date: Sun, 26 Dec 2021 11:33:27 GMT
-< Content-Type: text/plain; charset=utf-8
-< Content-Length: 14
-< Connection: keep-alive
-< test: 123
-< Server: APISIX/2.11.0
-<
-dubbo success
-```
-
-:::note 说明
-上述代码返回中包含了 `test: 123` Header,以及 `dubbo success` 字符串作为 Body 体。这与我们在 `DemoServiceImpl` 编码的预期效果一致。
-:::
-
-6. 查看 Dubbo Provider 的日志。
-
-```
-Key = content-length, Value = 17
-Key = host, Value = example.org
-Key = content-type, Value = application/x-www-form-urlencoded
-Key = body, Value = [B@70754265
-Key = accept, Value = */*
-Key = user-agent, Value = curl/7.80.0
-```
-
-:::note 说明
-通过 `httpRequestContext` 可以拿到 HTTP 请求的 Header 和 Body。其中 Header 会作为 Map 元素,而 Body 中 Key 值是固定的字符串"body",Value 则代表 Byte 数组。
-:::
-
-### 进阶篇:复杂场景示例
-
-在上述的简单用例中可以看出,我们确实通过 Apache APISIX 将 Dubbo Service 发布为一个 HTTP 服务,但是在使用过程中的限制也非常明显。比如:接口的参数和返回值都必须要是 `Map<String, Object>`。
-
-那么,如果项目中出现已经定义好、但又不符合上述限制的接口,该如何通过 Apache APISIX 来暴露 HTTP 服务呢?
-
-#### 操作步骤
-
-针对上述场景,我们可以通过 HTTP Request Body 描述要调用的 Service 和 Method 以及对应参数,再利用 Java 的反射机制实现目标方法的调用。最后将返回值序列化为 JSON,并写入到 HTTP Response Body 中。
-
-这样就可以将 Apache APISIX 的 「HTTP to Dubbo」 能力进一步加强,并应用到所有已存在的 Dubbo Service 中。具体操作可参考下方:
-
-1. 为已有项目增加一个 Dubbo Service 用来统一处理 HTTP to Dubbo 的转化。
-
-```java
-public class DubboInvocationParameter {
- private String type;
- private String value;
-}
-public class DubboInvocation {
- private String service;
- private String method;
- private DubboInvocationParameter[] parameters;
-}
-public interface HTTP2DubboService {
- Map<String, Object> invoke(Map<String, Object> context) throws Exception;
-}
-@Component
-public class HTTP2DubboServiceImpl implements HTTP2DubboService {
- @Autowired
- private ApplicationContext appContext;
- @Override
- public Map<String, Object> invoke(Map<String, Object> context) throws Exception {
- DubboInvocation invocation = JSONObject.parseObject((byte[]) context.get("body"), DubboInvocation.class);
- Object[] args = new Object[invocation.getParameters().size()];
- for (int i = 0; i < args.length; i++) {
- DubboInvocationParameter parameter = invocation.getParameters().get(i);
- args[i] = JSONObject.parseObject(parameter.getValue(), Class.forName(parameter.getType()));
- }
- Object svc = appContext.getBean(Class.forName(invocation.getService()));
- Object result = svc.getClass().getMethod(invocation.getMethod()).invoke(args);
- Map<String, Object> httpResponse = new HashMap<>();
- httpResponse.put("status", 200);
- httpResponse.put("body", JSONObject.toJSONString(result));
- return httpResponse;
- }
-}
-```
-
-2. 通过如下命令请求来发起相关调用。
-
-```shell
-curl http://127.0.0.1:9080/demo -H "Host: example.org" -X POST --data '
-{
- "service": "org.apache.dubbo.samples.apisix.DemoService",
- "method": "createUser",
- "parameters": [
- {
- "type": "org.apache.dubbo.samples.apisix.User",
- "value": "{'name': 'hello'}"
- }
- ]
-}'
-```
-
-## 总结
-
-本文为大家介绍了如何借助 Apache APISIX 实现 Dubbo Service 的代理,通过引入 `dubbo-proxy` 插件便可为 Dubbo 框架的后端系统构建更简单更高效的流量链路。
-
-希望通过上述操作步骤和用例场景分享,能为大家在相关场景的使用提供借鉴思路。更多关于 `dubbo-proxy` 插件的介绍与使用可参考[官方文档](https://apisix.apache.org/docs/apisix/plugins/dubbo-proxy/)。
\ No newline at end of file
diff --git a/content/zh-cn/overview/what/ecosystem/gateway/kong.md b/content/zh-cn/overview/what/ecosystem/gateway/kong.md
deleted file mode 100644
index 2038eace14..0000000000
--- a/content/zh-cn/overview/what/ecosystem/gateway/kong.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/gateway/kong/
-description: ""
-linkTitle: Kong
-title: Kong
-type: docs
-weight: 40
----
diff --git a/content/zh-cn/overview/what/ecosystem/gateway/pixiu.md b/content/zh-cn/overview/what/ecosystem/gateway/pixiu.md
deleted file mode 100644
index 91d3f0d5d0..0000000000
--- a/content/zh-cn/overview/what/ecosystem/gateway/pixiu.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/gateway/pixiu/
-description: ""
-linkTitle: Apache Dubbo Go Pixiu
-title: Apache Dubbo Go Pixiu
-type: docs
-weight: 40
----
diff --git a/content/zh-cn/overview/what/ecosystem/gateway/shenyu.md b/content/zh-cn/overview/what/ecosystem/gateway/shenyu.md
deleted file mode 100644
index b350928675..0000000000
--- a/content/zh-cn/overview/what/ecosystem/gateway/shenyu.md
+++ /dev/null
@@ -1,410 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/gateway/shenyu/
-description: ""
-linkTitle: Apache Shenyu
-title: Apache Shenyu
-type: docs
-weight: 20
----
-
-
-
-
-
-
-## 1. 介绍
-
-- Apache ShenYu
-
-
-
-
-[Apache ShenYu(Incubating)](https://shenyu.apache.org/zh/docs/index) 是一个异步的,高性能的,跨语言的,响应式的 `API` 网关。兼容各种主流框架体系,支持热插拔,用户可以定制化开发,满足用户各种场景的现状和未来需求,经历过大规模场景的锤炼。
-
-2021年5月,`ShenYu`捐献给 `Apache` 软件基金会,Apache 基金会全票通过,顺利进入孵化器。
-
-
-- Apache Dubbo
-
-`Apache Dubbo` 是一款微服务开发框架,它提供了 `RPC` 通信 与 微服务治理 两大关键能力。这意味着,使用 `Dubbo` 开发的微服务,将具备相互之间的远程发现与通信能力, 同时利用 Dubbo 提供的丰富服务治理能力,可以实现诸如服务发现、负载均衡、流量调度等服务治理诉求。同时 `Dubbo` 是高度可扩展的,用户几乎可以在任意功能点去定制自己的实现,以改变框架的默认行为来满足自己的业务需求。
-
-
-## 2. Dubbo快速开始
-
-本小节介绍如何将`Dubbo`服务接入到`ShenYu`网关,您可以直接在工程下找到本小节的[示例代码](https://github.com/apache/shenyu/tree/master/shenyu-examples/shenyu-examples-dubbo) 。
-
-
-### 2.1 启动shenyu-admin
-
-`shenyu-admin`是`Apache ShenYu`后台管理系统, 启动的方式有多种,本文通过 `[本地部署](https://shenyu.apache.org/zh/docs/deployment/deployment-local)` 的方式启动。启动成功后,需要在基础配置`->`插件管理中,把`dubbo` 插件设置为开启,并设置你的注册地址,请确保注册中心已经开启。
-
-
-
-
-### 2.2 启动shenyu网关
-
-在这里通过 [源码](https://github.com/apache/incubator-shenyu/tree/master/shenyu-bootstrap) 的方式启动,直接运行`shenyu-bootstrap`中的`ShenyuBootstrapApplication`。
-
-在启动前,请确保网关已经引入相关依赖。如果客户端是`apache dubbo`,注册中心使用`zookeeper`,请参考如下配置:
-
-```java
- <!-- apache shenyu apache dubbo plugin start-->
- <dependency>
- <groupId>org.apache.shenyu</groupId>
- <artifactId>shenyu-spring-boot-starter-plugin-apache-dubbo</artifactId>
- <version>${project.version}</version>
- </dependency>
- <dependency>
- <groupId>org.apache.dubbo</groupId>
- <artifactId>dubbo</artifactId>
- <version>2.7.5</version>
- </dependency>
- <!-- Dubbo zookeeper registry dependency start -->
- <dependency>
- <groupId>org.apache.curator</groupId>
- <artifactId>curator-client</artifactId>
- <version>4.0.1</version>
- <exclusions>
- <exclusion>
- <artifactId>log4j</artifactId>
- <groupId>log4j</groupId>
- </exclusion>
- </exclusions>
- </dependency>
- <dependency>
- <groupId>org.apache.curator</groupId>
- <artifactId>curator-framework</artifactId>
- <version>4.0.1</version>
- </dependency>
- <dependency>
- <groupId>org.apache.curator</groupId>
- <artifactId>curator-recipes</artifactId>
- <version>4.0.1</version>
- </dependency>
- <!-- Dubbo zookeeper registry dependency end -->
- <!-- apache dubbo plugin end-->
-```
-
-### 2.3 启动shenyu-examples-dubbo
-
-以官网提供的例子为例 [shenyu-examples-dubbo](https://github.com/apache/shenyu/tree/master/shenyu-examples/shenyu-examples-dubbo) 。 假如`dubbo`服务定义如下:
-
-```xml
-<beans /* ...... * />
-
- <dubbo:application name="test-dubbo-service"/>
- <dubbo:registry address="${dubbo.registry.address}"/>
- <dubbo:protocol name="dubbo" port="20888"/>
-
- <dubbo:service timeout="10000" interface="org.apache.shenyu.examples.dubbo.api.service.DubboTestService" ref="dubboTestService"/>
-
-</beans>
-```
-
-声明应用服务名称,注册中心地址,使用`dubbo`协议,声明服务接口,对应接口实现类:
-
-```java
-/**
- * DubboTestServiceImpl.
- */
-@Service("dubboTestService")
-public class DubboTestServiceImpl implements DubboTestService {
-
- @Override
- @ShenyuDubboClient(path = "/findById", desc = "Query by Id")
- public DubboTest findById(final String id) {
- return new DubboTest(id, "hello world shenyu Apache, findById");
- }
- //......
-}
-```
-
-在接口实现类中,使用注解`@ShenyuDubboClient`向`shenyu-admin`注册服务。
-
-在配置文件`application.yml`中的配置信息:
-
-```yaml
-server:
- port: 8011
- address: 0.0.0.0
- servlet:
- context-path: /
-spring:
- main:
- allow-bean-definition-overriding: true
-dubbo:
- registry:
- address: zookeeper://localhost:2181 # dubbo使用的注册中心
-
-shenyu:
- register:
- registerType: http #注册方式
- serverLists: http://localhost:9095 #注册地址
- props:
- username: admin
- password: 123456
- client:
- dubbo:
- props:
- contextPath: /dubbo
- appName: dubbo
-```
-
-在配置文件中,声明`dubbo`使用的注册中心地址,`dubbo`服务向`shenyu-admin`注册,使用的方式是`http`,注册地址是`http://localhost:9095`。
-
-关于注册方式的使用,请参考 `[应用客户端接入](https://shenyu.apache.org/docs/design/register-center-design/)` 。
-
-
-### 2.4 调用dubbo服务
-
-`shenyu-examples-dubbo`项目成功启动之后会自动把加 `@ShenyuDubboClient` 注解的接口方法注册到网关。
-
-
-打开 `插件列表 -> Proxy -> dubbo` 可以看到插件规则配置列表:
-
-
-
-
-注册成功的选择器信息:
-
-
-
-注册成功的规则信息:
-
-
-
-> 选择器和规则是 `Apache ShenYu` 网关中最灵魂的东西。掌握好它,你可以对任何流量进行管理。对应为选择器与规则里面的匹配条件(conditions),根据不同的流量筛选规则,我们可以处理各种复杂的场景。流量筛选可以从`Header`, `URI`, `Query`, `Cookie` 等等Http请求获取数据。
->
-> 然后可以采用 `Match`,`=`,`Regex`,`Groovy`,`Exclude`等匹配方式,匹配出你所预想的数据。多组匹配添加可以使用`And/Or`的匹配策略。
->
-> 具体的介绍与使用请看: `[选择器与规则管理](https://shenyu.apache.org/zh/docs/user-guide/admin-usage/selector-and-rule)` 。
-
-发起`GET`请求,通过`ShenYu`网关调用`dubbo`服务:
-
-```
-GET http://localhost:9195/dubbo/findById?id=100
-Accept: application/json
-```
-
-成功响应之后,结果如下:
-
-```
-{
- "name": "hello world shenyu Apache, findById",
- "id": "100"
-}
-```
-
-至此,就成功的通过`http`请求访问`dubbo`服务了,`ShenYu`网关通过`shenyu-plugin-dubbo`模块将`http`协议转成了`dubbo`协议。
-
-
-## 3. 深入理解Dubbo插件
-
-在运行上述`demo`的过程中,是否存在一些疑问:
-
-- `dubbo`服务是如何注册到`shenyu-admin`?
-- `shenyu-admin`是如何将数据同步到`ShenYu`网关?
-- `DubboPlugin`是如何将`http`协议转换到到dubbo协议?
-
-带着这些疑问,来深入理解`dubbo`插件。
-
-
-### 3.1 应用客户端接入
-
-应用客户端接入是指将微服务接入到`Apache ShenYu`网关,当前支持`Http`、 `Dubbo`、 `Spring Cloud`、 `gRPC`、 `Motan`、 `Sofa`、 `Tars`等协议的接入。
-
-将应用客户端接入到`Apache ShenYu`网关是通过注册中心来实现的,涉及到客户端注册和服务端同步数据。注册中心支持`Http`、`Zookeeper`、`Etcd`、`Consul`和`Nacos`。默认是通过`Http`方式注册。
-
-客户端接入的相关配置请参考 `[客户端接入配置](https://shenyu.apache.org/zh/docs/user-guide/register-center-access)` 。
-
-#### 3.1.1 客户端注册
-
-
-
-在你的微服务配置中声明注册中心客户端类型,如`Http`或`Zookeeper`。
-应用程序启动时使用`SPI`方式加载并初始化对应注册中心客户端,通过实现`Spring Bean`相关的后置处理器接口,在其中获取需要进行注册的服务接口信息,将获取的信息放入`Disruptor`中。
-
-注册中心客户端从`Disruptor`中读取数据,并将接口信息注册到`shenyu-admin`,`Disruptor`在其中起数据与操作解耦的作用,利于扩展。
-
-#### 3.1.2 服务端注册
-
-
-
-在`shenyu-admin`配置中声明注册中心服务端类型,如`Http`或`Zookeeper`。当`shenyu-admin`启动时,读取配置类型,加载并初始化对应的注册中心服务端,注册中心服务端收到`shenyu-client`注册的接口信息后,将其放入`Disruptor`中,然后会触发注册处理逻辑,将服务接口信息更新并发布同步事件。
-
-`Disruptor`在其中起到数据与操作解耦,利于扩展。如果注册请求过多,导致注册异常,也有数据缓冲作用。
-
-### 3.2 数据同步原理
-
-数据同步是指在 `shenyu-admin` 后台操作数据以后,使用何种策略将数据同步到 `Apache ShenYu` 网关。`Apache ShenYu` 网关当前支持`ZooKeeper`、`WebSocket`、`Http长轮询`、`Nacos` 、`Etcd` 和 `Consul` 进行数据同步。默认是通过`WebSocket`进行数据同步。
-
-数据同步的相关配置请参考 `[数据同步配置](https://shenyu.apache.org/zh/docs/user-guide/use-data-sync)` 。
-
-#### 3.2.1 数据同步的意义
-
-网关是流量请求的入口,在微服务架构中承担了非常重要的角色,网关高可用的重要性不言而喻。在使用网关的过程中,为了满足业务诉求,经常需要变更配置,比如流控规则、路由规则等等。因此,网关动态配置是保障网关高可用的重要因素。
-
-当前数据同步特性如下:
-
-- 所有的配置都缓存在 `Apache ShenYu` 网关内存中,每次请求都使用本地缓存,速度非常快。
-- 用户可以在 `shenyu-admin` 后台任意修改数据,并马上同步到网关内存。
-- 支持 `Apache ShenYu` 的插件、选择器、规则数据、元数据、签名数据等数据同步。
-- 所有插件的选择器,规则都是动态配置,立即生效,不需要重启服务。
-- 数据同步方式支持 `Zookeeper`、`Http 长轮询`、`Websocket`、`Nacos`、`Etcd` 和 `Consul`。
-
-#### 3.2.2 数据同步原理分析
-
-下图展示了 `Apache ShenYu` 数据同步的流程,`Apache ShenYu` 网关在启动时,会从配置服务同步配置数据,并且支持推拉模式获取配置变更信息,然后更新本地缓存。管理员可以在管理后台(`shenyu-admin`),变更用户权限、规则、插件、流量配置,通过推拉模式将变更信息同步给 `Apache ShenYu` 网关,具体是 `push` 模式,还是 `pull` 模式取决于使用哪种同步方式。
-
-
-
-在最初的版本中,配置服务依赖 `Zookeeper` 实现,管理后台将变更信息 `push` 给网关。而现在可以支持 `WebSocket`、`Http长轮询`、`Zookeeper`、`Nacos`、`Etcd` 和 `Consul`,通过在配置文件中设置 `shenyu.sync.${strategy}` 指定对应的同步策略,默认使用 `webosocket` 同步策略,可以做到秒级数据同步。但是,有一点需要注意的是,`Apache ShenYu`网关 和 `shenyu-admin` 必须使用相同的同步策略。
-
-如下图所示,`shenyu-admin` 在用户发生配置变更之后,会通过 `EventPublisher` 发出配置变更通知,由 `EventDispatcher` 处理该变更通知,然后根据配置的同步策略(`http、weboscket、zookeeper、naocs、etcd、consul`),将配置发送给对应的事件处理器。
-
-- 如果是 `websocket` 同步策略,则将变更后的数据主动推送给 `shenyu-web`,并且在网关层,会有对应的 `WebsocketDataHandler` 处理器来处理 `shenyu-admin` 的数据推送。
-- 如果是 `zookeeper` 同步策略,将变更数据更新到 `zookeeper`,而 `ZookeeperSyncCache` 会监听到 `zookeeper` 的数据变更,并予以处理。
-- 如果是 `http` 同步策略,由网关主动发起长轮询请求,默认有 `90s` 超时时间,如果 `shenyu-admin` 没有数据变更,则会阻塞 `http` 请求,如果有数据发生变更则响应变更的数据信息,如果超过 `60s` 仍然没有数据变更则响应空数据,网关层接到响应后,继续发起 `http` 请求,反复同样的请求。
-
-### 3.3 流程分析
-
-流程分析是从源码的角度,展示服务注册流程,数据同步流程和服务调用流程。
-
-#### 3.3.1 服务注册流程
-
-- 读取dubbo服务
-
-使用注解`@ShenyuDubboClient`标记需要注册到网关的`dubbo`服务。
-
-注解扫描通过`ApacheDubboServiceBeanListener`完成,它实现了`ApplicationListener<ContextRefreshedEvent>`接口,在`Spring`容器启动过程中,发生上下文刷新事件时,开始执行事件处理方法`onApplicationEvent()`。在重写的方法逻辑中,读取`Dubbo`服务`ServiceBean`,构建元数据对象和`URI`对象,并向`shenyu-admin`注册。
-
-具体的注册逻辑由注册中心实现,请参考 `[客户端接入原理](https://shenyu.apache.org/zh/docs/design/register-center-design/)` 。
-
-
-- 处理注册信息
-
-客户端通过注册中心注册的元数据和`URI`数据,在`shenyu-admin`端进行处理,负责存储到数据库和同步给`shenyu`网关。`Dubbo`插件的客户端注册处理逻辑在`ShenyuClientRegisterDubboServiceImpl`中。继承关系如下:
-
-
-
-- ShenyuClientRegisterService:客户端注册服务,顶层接口;
-- FallbackShenyuClientRegisterService:注册失败,提供重试操作;
-- AbstractShenyuClientRegisterServiceImpl:抽象类,实现部分公共注册逻辑;
-- ShenyuClientRegisterDubboServiceImpl:实现`Dubbo`插件的注册;
-
-注册信息包括选择器,规则和元数据。
-
-
-整体的`dubbo`服务注册流程如下:
-
-
-
-#### 3.3.2 数据同步流程
-
-- admin更新数据
-
-假设在在后台管理系统中,新增一条选择器数据,请求会进入`SelectorController`类中的`createSelector()`方法,它负责数据的校验,添加或更新数据,返回结果信息。
-
-在`SelectorServiceImpl`类中通过`createOrUpdate()`方法完成数据的转换,保存到数据库,发布事件,更新`upstream`。
-
-在`Service`类完成数据的持久化操作,即保存数据到数据库。发布变更数据通过`eventPublisher.publishEvent()`完成,这个`eventPublisher`对象是一个`ApplicationEventPublisher`类,这个类的全限定名是`org.springframework.context.ApplicationEventPublisher`,发布数据的功能正是是通过`Spring`相关的功能来完成的。
-
-当事件发布完成后,会自动进入到`DataChangedEventDispatcher`类中的`onApplicationEvent()`方法,根据不同数据类型和数据同步方式进行事件处理。
-
-- 网关数据同步
-
-网关在启动时,根据指定的数据同步方式加载不同的配置类,初始化数据同步相关类。
-
-在接收到数据后,进行反序列化操作,读取数据类型和操作类型。不同的数据类型,有不同的数据处理方式,所以有不同的实现类。但是它们之间也有相同的处理逻辑,所以可以通过模板方法设计模式来实现。相同的逻辑放在抽象类`AbstractDataHandler`中的`handle()`方法中,不同逻辑就交给各自的实现类。
-
-新增一条选择器数据,是新增操作,会进入到`SelectorDataHandler.doUpdate()`具体的数据处理逻辑中。
-
-在通用插件数据订阅者`CommonPluginDataSubscriber`,负责处理所有插件、选择器和规则信息
-
-将数据保存到网关的内存中,`BaseDataCache`是最终缓存数据的类,通过单例模式实现。选择器数据就存到了`SELECTOR_MAP`这个`Map`中。在后续使用的时候,也是从这里拿数据。
-
-上述逻辑用流程图表示如下:
-
-
-
-#### 3.3.3 服务调用流程
-
-在`Dubbo`插件体系中,类继承关系如下:
-
-
-
-> ShenyuPlugin:顶层接口,定义接口方法;
->
-> AbstractShenyuPlugin:抽象类,实现插件共有逻辑;
->
-> AbstractDubboPlugin:dubbo插件抽象类,实现`dubbo`共有逻辑(ShenYu网关支持ApacheDubbo和AlibabaDubbo);
->
-> ApacheDubboPlugin:ApacheDubbo插件。
-
-- org.apache.shenyu.web.handler.ShenyuWebHandler.DefaultShenyuPluginChain#execute()
-
-通过`ShenYu`网关代理后,请求入口是`ShenyuWebHandler`,它实现了`org.springframework.web.server.WebHandler`接口,通过责任链设计模式将所有插件连接起来。
-
-- org.apache.shenyu.plugin.base.AbstractShenyuPlugin#execute()
-
-当请求到网关时,判断某个插件是否执行,是通过指定的匹配逻辑来完成。在`execute()`方法中执行选择器和规则的匹配逻辑。
-
-
-- org.apache.shenyu.plugin.global.GlobalPlugin#execute()
-
-最先被执行的是`GlobalPlugin` ,它是一个全局插件,在`execute()`方法中构建上下文信息。
-
-- org.apache.shenyu.plugin.base.RpcParamTransformPlugin#execute()
-
-接着被执行的是`RpcParamTransformPlugin` , 它负责从`http`请求中读取参数,保存到`exchange`中,传递给`rpc`服务。在`execute()`方法中,执行该插件的核心逻辑:从`exchange`中获取请求信息,根据请求传入的内容形式处理参数。
-
-- org.apache.shenyu.plugin.dubbo.common.AbstractDubboPlugin
-
-然后被执行的是`DubboPlugin` 。在`doExecute()`方法中,主要是检查元数据和参数。在`doDubboInvoker()`方法中设置特殊的上下文信息,然后开始`dubbo`的泛化调用。
-
-在`genericInvoker()`方法中:
-
-- 获取`ReferenceConfig`对象;
-- 获取泛化服务`GenericService`对象;
-- 构造请求参数`pair`对象;
-- 发起异步的泛化调用。
-
-通过泛化调用就可以实现在网关调用`dubbo`服务了。
-
-`ReferenceConfig`对象是支持泛化调用的关键对象 ,它的初始化操作是在数据同步的时候完成的。
-
-- org.apache.shenyu.plugin.response.ResponsePlugin#execute()
-
-最后被执行的是`ResponsePlugin` ,它统一处理网关的响应结果信息。处理类型由`MessageWriter`决定,类继承关系如下:
-
-
-
-> MessageWriter:接口,定义消息处理方法;
->
-> NettyClientMessageWriter:处理`Netty`调用结果;
->
-> RPCMessageWriter:处理`RPC`调用结果;
->
-> WebClientMessageWriter:处理`WebClient`调用结果;
-`Dubbo`服务调用,处理结果是`RPCMessageWriter`。
-
-- org.apache.shenyu.plugin.response.strategy.RPCMessageWriter#writeWith()
-
-在`writeWith()`方法中处理响应结果,获取结果或处理异常。
-
-分析至此,关于`Dubbo`插件的源码分析就完成了,分析流程图如下:
-
-
-
-
-## 4. 小结
-
-本文从实际案例出发,由浅入深分析了`ShenYu`网关对Dubbo服务的代理过程。涉及到的主要知识点如下:
-
-- 通过责任链设计模式执行插件;
-- 使用模板方法设计模式实现`AbstractShenyuPlugin`,处理通用的操作类型;
-- 使用单例设计模式实现缓存数据类`BaseDataCache`;
-- 通过`springboot starter`即可引入不同的注册中心和数同步方式,扩展性很好;
-- 通过`admin`支持规则热更新,方便流量管控;
-- `Disruptor`队列是为了数据与操作解耦,以及数据缓冲。
\ No newline at end of file
diff --git a/content/zh-cn/overview/what/ecosystem/gateway/tengine.md b/content/zh-cn/overview/what/ecosystem/gateway/tengine.md
deleted file mode 100644
index 0cbcb7b318..0000000000
--- a/content/zh-cn/overview/what/ecosystem/gateway/tengine.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/gateway/tengine/
-description: ""
-linkTitle: Tengine
-title: Tengine
-type: docs
-weight: 60
----
diff --git a/content/zh-cn/overview/what/ecosystem/metadata-center/_index.md b/content/zh-cn/overview/what/ecosystem/metadata-center/_index.md
deleted file mode 100644
index 14d34268b3..0000000000
--- a/content/zh-cn/overview/what/ecosystem/metadata-center/_index.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/metadata-center/
-description: ""
-linkTitle: 元数据中心
-title: 元数据中心
-type: docs
-weight: 50
----
diff --git a/content/zh-cn/overview/what/ecosystem/metadata-center/nacos.md b/content/zh-cn/overview/what/ecosystem/metadata-center/nacos.md
deleted file mode 100644
index 43918d645c..0000000000
--- a/content/zh-cn/overview/what/ecosystem/metadata-center/nacos.md
+++ /dev/null
@@ -1,120 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/metadata-center/nacos/
-description: ""
-linkTitle: Nacos
-title: Nacos
-type: docs
-weight: 20
----
-
-
-
-## 1 介绍
-
-Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。
-
-Nacos 致力于帮助您发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。
-
-Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。 Nacos 是构建以“服务”为中心的现代应用架构 (例如微服务范式、云原生范式) 的服务基础设施。
-
-参考文档:https://nacos.io/zh-cn/docs/v2/what-is-nacos.html
-
-## 2 使用说明 - Java
-Dubbo 融合 Nacos 成为元数据中心的操作步骤非常简单,大致分为 `增加 Maven 依赖` 以及 `配置元数据中心` 两步。
-> 如果元数据地址(dubbo.metadata-report.address)也不进行配置,会使用注册中心的地址来用作元数据中心。
-
-### 2.1 增加 Maven 依赖
-
-如果项目已经启用 Nacos 作为注册中心,则无需增加任何额外配置。
-
-如果未启用 Nacos 注册中心,则请参考 [为注册中心增加 Nacos 依赖](../../registry/nacos/#21-增加依赖)。
-> 当Dubbo使用`3.0.0`及以上版本时,需要使用Nacos `2.0.0`及以上版本
-
-### 2.2 启用 Nacos 配置中心
-```xml
-<dubbo:metadata-report address="nacos://127.0.0.1:8848"/>
-```
-
-或者
-
-```yaml
-dubbo:
- metadata-report:
- address: nacos://127.0.0.1:8848
-```
-
-或者
-
-```properties
-dubbo.metadata-report.address=nacos://127.0.0.1:8848
-```
-
-或者
-
-```java
-MetadataReportConfig metadataConfig = new MetadataReportConfig();
-metadataConfig.setAddress("nacos://127.0.0.1:8848");
-```
-
-`address` 格式请参考 [Nacos 注册中心 - 启用配置](../../registry/nacos/#22-配置并启用-nacos)
-
-## 3 工作原理
-
-### 3.1 服务运维元数据
-
-在 Nacos 的控制台上可看到服务提供者、消费者注册的服务运维相关的元数据信息:
-
-
-
-在 Nacos 中,本身就存在配置中心这个概念,正好用于元数据存储。在配置中心的场景下,存在命名空间- namespace 的概念,在 namespace 之下,还存在 group 概念。即通过 namespace 和 group 以及 dataId 去定位一个配置项,在不指定 namespace 的情况下,默认使用 ```public``` 作为默认的命名空间。
-
-```properties
-Provider: namespace: 'public', dataId: '{service name}:{version}:{group}:provider:{application name}', group: 'dubbo'
-Consumer: namespace: 'public', dataId: '{service name}:{version}:{group}:consumer:{application name}', group: 'dubbo'
-```
-当 version 或者 group 不存在时`:` 依然保留:
-```properties
-Provider: namespace: 'public', dataId: '{service name}:::provider:{application name}', group: 'dubbo'
-Consumer: namespace: 'public', dataId: '{service name}:::consumer:{application name}', group: 'dubbo'
-```
-
-Providers接口元数据详情 (通过 `report-definition=true` 控制此部分数据是否需要上报):
-
-
-
-Consumers接口元信息详情(通过 `report-consumer-definition=true` 控制是否上报,默认 false):
-
-
-
-### 3.2 地址发现 - 接口-应用映射
-在上面提到,service name 和 application name 可能是一对多的,在 nacos 中,使用单个 key-value 进行保存,多个 application name 通过英文逗号`,`隔开。由于是单个 key-value 去保存数据,在多客户端的情况下可能会存在并发覆盖的问题。因此,我们使用 nacos 中 publishConfigCas 的能力去解决该问题。在 nacos 中,使用 publishConfigCas 会让用户传递一个参数 casMd5,该值的含义是之前配置内容的 md5 值。不同客户端在更新之前,先去查一次 nacos 的 content 的值,计算出 md5 值,当作本地凭证。在更新时,把凭证 md5 传到服务端比对 md5 值, 如果不一致说明在次期间被其他客户端修改过,重新获取凭证再进行重试(CAS)。目前如果重试6次都失败的话,放弃本次更新映射行为。
-
-Nacos api:
-```java
-ConfigService configService = ...
-configService.publishConfigCas(key, group, content, ticket);
-```
-
-映射信息位于 namespace: 'public', dataId: '{service name}', group: 'mapping'.
-
-
-
-### 3.3 地址发现 - 接口配置元数据
-
-要开启远程接口配置元数据注册,需在应用中增加以下配置,因为默认情况下 Dubbo3 应用级服务发现会启用服务自省模式,并不会注册数据到元数据中心。
-
-```properties
- dubbo.application.metadata-type=remote
- ```
-
-或者,在自省模式模式下仍开启中心化元数据注册
-
-```properties
-dubbo.application.metadata-type=local
-dubbo.metadata-report.report-metadata=true
-```
-
-Nacos server 中的元数据信息详情如下:
-
-
\ No newline at end of file
diff --git a/content/zh-cn/overview/what/ecosystem/metadata-center/redis.md b/content/zh-cn/overview/what/ecosystem/metadata-center/redis.md
deleted file mode 100644
index ac4d76464b..0000000000
--- a/content/zh-cn/overview/what/ecosystem/metadata-center/redis.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/metadata-center/redis/
-description: ""
-linkTitle: Redis
-title: Redis
-type: docs
-weight: 30
----
diff --git a/content/zh-cn/overview/what/ecosystem/metadata-center/zookeeper.md b/content/zh-cn/overview/what/ecosystem/metadata-center/zookeeper.md
deleted file mode 100644
index cbae19afeb..0000000000
--- a/content/zh-cn/overview/what/ecosystem/metadata-center/zookeeper.md
+++ /dev/null
@@ -1,113 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/metadata-center/zookeeper/
-description: ""
-linkTitle: Zookeeper
-title: Zookeeper
-type: docs
-weight: 10
----
-
-
-
-
-## 1 介绍
-
-Apache ZooKeeper是Apache软件基金会的一个软件项目,它为大型分布式计算提供开源的分布式配置服务、同步服务和命名注册。 ZooKeeper曾经是Hadoop的一个子项目,但现在是一个独立的顶级项目。
-
-ZooKeeper的架构通过冗余服务实现高可用性。因此,如果第一次无应答,客户端就可以询问另一台ZooKeeper主机。ZooKeeper节点将它们的数据存储于一个分层的名字空间,非常类似于一个文件系统或一个前缀树结构。客户端可以在节点读写,从而以这种方式拥有一个共享的配置服务。更新是全序的。
-
-
-## 2 使用说明 - Java
-
-在此查看[完整示例代码](https://github.com/apache/dubbo-samples/tree/master/3-extensions/registry/dubbo-samples-zookeeper)
-
-### 2.1 增加 Maven 依赖
-```xml
-<properties>
- <dubbo.version>3.1.6</dubbo.version>
-</properties>
-
-<dependencies>
- <!-- This dependency helps to introduce Curator and Zookeeper dependencies that are necessary for Dubbo to work with zookeeper as transitive dependencies -->
- <dependency>
- <groupId>org.apache.dubbo</groupId>
- <artifactId>dubbo-dependencies-zookeeper</artifactId>
- <version>${dubbo.version}</version>
- <type>pom</type>
- </dependency>
-</dependencies>
-```
-
-`dubbo-dependencies-zookeeper` 将自动为应用增加 Zookeeper 相关客户端的依赖,减少用户使用 Zookeeper 成本,如使用中遇到版本兼容问题,用户也可以不使用 `dubbo-dependencies-zookeeper`,而是自行添加 Curator、Zookeeper Client 等依赖。
-
-由于 Dubbo 使用 Curator 作为与 Zookeeper Server 交互的编程客户端,因此,要特别注意 Zookeeper Server 与 Dubbo 版本依赖的兼容性
-
-|Zookeeper Server 版本|Dubbo 版本|Dubbo Zookeeper 依赖包|说明|
-|-----|-----|-----|-----|
-|3.4.x 及以下|3.0.x 及以上|dubbo-dependencies-zookeeper|传递依赖 Curator 4.x 、Zookeeper 3.4.x|
-|3.5.x 及以上|3.0.x 及以上|dubbo-dependencies-zookeeper-curator5|传递依赖 Curator 5.x 、Zookeeper 3.7.x|
-|3.4.x 及以上|2.7.x 及以下|dubbo-dependencies-zookeeper|传递依赖 Curator 4.x 、Zookeeper 3.4.x|
-|3.5.x 及以上|2.7.x 及以下|无|须自行添加 Curator、Zookeeper 等相关客户端依赖|
-
-### 2.2 配置并启用 Zookeeper
-```yaml
-# application.yml
-dubbo:
- metadata-report:
- address: zookeeper://localhost:2181
-```
-或
-```properties
-# dubbo.properties
-dubbo.metadata-report.address=zookeeper://localhost:2181
-```
-或
-```xml
-<dubbo:metadata-report address="zookeeper://localhost:2181" />
-```
-
-`address` 是启用 zookeeper 注册中心唯一必须指定的属性,而在生产环境下,`address` 通常被指定为集群地址,如
-
-`address=zookeeper://10.20.153.10:2181?backup=10.20.153.11:2181,10.20.153.12:2181`
-
-protocol 与 address 分开配置的模式也可以,如
-
-`<dubbo:metadata-report protocol="zookeeper" address="10.20.153.10:2181,10.20.153.11:2181,10.20.153.12:2181" />`
-
-## 3 高级配置
-### 3.1 认证与鉴权
-
-如果 Zookeeper 开启认证,Dubbo 支持指定 username、password 的方式传入身份标识。
-
-```yaml
-# application.yml
-dubbo:
- metadata-report:
- address: zookeeper://localhost:2181
- username: hello
- password: 1234
-```
-
-也可以直接将参数扩展在 address 上 `address=zookeeper://hello:1234@localhost:2181`
-
-### 3.2 分组隔离
-通过指定 `group` 属性,可以在同一个 Zookeeper 集群内实现微服务地址的逻辑隔离。比如可以在一套集群内隔离出多套开发环境,在地址发现层面实现隔离。
-
-```yaml
-# application.yml
-dubbo:
- metadata-report:
- address: zookeeper://localhost:2181
- group: daily1
-```
-### 3.3 其他扩展配置
-配置连接、会话过期时间
-```yaml
-# application.yml
-dubbo:
- metadata-report:
- address: zookeeper://localhost:2181
- timeout: 30 * 1000 # 连接超时时间,默认 30s
- session: 60 * 1000 # 会话超时时间,默认 60s
-```
\ No newline at end of file
diff --git a/content/zh-cn/overview/what/ecosystem/monitoring/_index.md b/content/zh-cn/overview/what/ecosystem/monitoring/_index.md
deleted file mode 100644
index fabe2d4868..0000000000
--- a/content/zh-cn/overview/what/ecosystem/monitoring/_index.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/monitoring/
-description: ""
-linkTitle: 监控
-title: 监控
-type: docs
-weight: 110
----
diff --git a/content/zh-cn/overview/what/ecosystem/monitoring/grafana.md b/content/zh-cn/overview/what/ecosystem/monitoring/grafana.md
deleted file mode 100644
index 0c481c36b8..0000000000
--- a/content/zh-cn/overview/what/ecosystem/monitoring/grafana.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/monitoring/grafana/
-description: ""
-linkTitle: Grafana
-title: Grafana
-type: docs
-weight: 20
----
diff --git a/content/zh-cn/overview/what/ecosystem/monitoring/micrometer.md b/content/zh-cn/overview/what/ecosystem/monitoring/micrometer.md
deleted file mode 100644
index 79245b5a82..0000000000
--- a/content/zh-cn/overview/what/ecosystem/monitoring/micrometer.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/monitoring/micrometer/
-description: ""
-linkTitle: Micrometer
-title: Micrometer
-type: docs
-weight: 30
----
diff --git a/content/zh-cn/overview/what/ecosystem/monitoring/prometheus.md b/content/zh-cn/overview/what/ecosystem/monitoring/prometheus.md
deleted file mode 100644
index e64a211507..0000000000
--- a/content/zh-cn/overview/what/ecosystem/monitoring/prometheus.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/monitoring/prometheus/
-description: ""
-linkTitle: Prometheus
-title: Prometheus
-type: docs
-weight: 30
----
diff --git a/content/zh-cn/overview/what/ecosystem/protocol/_index.md b/content/zh-cn/overview/what/ecosystem/protocol/_index.md
deleted file mode 100644
index ae18d805ce..0000000000
--- a/content/zh-cn/overview/what/ecosystem/protocol/_index.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/protocol/
-description: ""
-linkTitle: 协议
-title: 协议
-type: docs
-weight: 10
----
diff --git a/content/zh-cn/overview/what/ecosystem/protocol/dubbo.md b/content/zh-cn/overview/what/ecosystem/protocol/dubbo.md
deleted file mode 100644
index 6dd5fe78c2..0000000000
--- a/content/zh-cn/overview/what/ecosystem/protocol/dubbo.md
+++ /dev/null
@@ -1,140 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/protocol/dubbo/
-description: ""
-linkTitle: Dubbo
-title: Dubbo
-type: docs
-weight: 1
----
-
-
-
-## 特性说明
-Dubbo 缺省协议采用单一长连接和 NIO 异步通讯,适合于小数据量大并发的服务调用,以及服务消费者机器数远大于服务提供者机器数的情况。
-
-反之,Dubbo 缺省协议不适合传送大数据量的服务,比如传文件,传视频等,除非请求量很低。
-
-
-
-* Transporter: mina, netty, grizzy
-* Serialization: dubbo, hessian2, java, json
-* Dispatcher: all, direct, message, execution, connection
-* ThreadPool: fixed, cached, ...
-
-
-* 连接个数:单连接
-* 连接方式:长连接
-* 传输协议:TCP
-* 传输方式:NIO 异步传输
-* 序列化:Hessian 二进制序列化
-* 适用范围:传入传出参数数据包较小(建议小于100K),消费者比提供者个数多,单一消费者无法压满提供者,尽量不要用 dubbo 协议传输大文件或超大字符串。
-* 适用场景:常规远程服务方法调用
-
-**约束**
-
-* 参数及返回值需实现 `Serializable` 接口
-* 参数及返回值不能自定义实现 `List`, `Map`, `Number`, `Date`, `Calendar` 等接口,只能用 JDK 自带的实现,因为 hessian 会做特殊处理,自定义实现类中的属性值都会丢失。
-* Hessian 序列化,只传成员属性值和值的类型,不传方法或静态变量,兼容情况**吴亚军提供**
-
-| 数据通讯 | 情况 | 结果 |
-| ------------- | ------------- | ------------- |
-| A->B | 类A多一种 属性(或者说类B少一种 属性)| 不抛异常,A多的那 个属性的值,B没有,其他正常 |
-| A->B | 枚举A多一种 枚举(或者说B少一种 枚举)| A使用多 出来的枚举进行传输 | 抛异常 |
-| A->B | 枚举A多一种 枚举(或者说B少一种 枚举)| A不使用 多出来的枚举进行传输 | 不抛异常,B正常接 收数据 |
-| A->B | A和B的属性 名相同,但类型不相同 | 抛异常 |
-| A->B | serialId 不相同 | 正常传输 |
-
-接口增加方法,对客户端无影响,如果该方法不是客户端需要的,客户端不需要重新部署。输入参数和结果集中增加属性,对客户端无影响,如果客户端并不需要新属性,不用重新部署。
-
-输入参数和结果集属性名变化,对客户端序列化无影响,但是如果客户端不重新部署,不管输入还是输出,属性名变化的属性值是获取不到的。
-
-**总结**
-- 服务器端和客户端对领域对象并不需要完全一致,而是按照最大匹配原则。
-- 会抛异常的情况:枚举值一边多一种,一边少一种,正好使用了差别的那种,或者属性名相同,类型不同。
-
-
-## 使用场景
-
-适合大并发小数据量的服务调用,服务消费者远大于服务提供者的情景。
-
-## 使用方式 - Java
-
-### 配置协议
-
-```xml
-<dubbo:protocol name="dubbo" port="20880" />
-```
-
-### 设置默认协议
-
-```xml
-<dubbo:provider protocol="dubbo" />
-```
-
-### 设置某个服务的协议
-
-```xml
-<dubbo:service interface="..." protocol="dubbo" />
-```
-
-### 多端口
-
-```xml
-<dubbo:protocol id="dubbo1" name="dubbo" port="20880" />
-<dubbo:protocol id="dubbo2" name="dubbo" port="20881" />
-```
-
-### 配置协议选项
-
-```xml
-<dubbo:protocol name=“dubbo” port=“9090” server=“netty” client=“netty” codec=“dubbo” serialization=“hessian2” charset=“UTF-8” threadpool=“fixed” threads=“100” queues=“0” iothreads=“9” buffer=“8192” accepts=“1000” payload=“8388608” />
-```
-
-### 多连接配置
-
-Dubbo 协议缺省每服务每提供者每消费者使用单一长连接,如果数据量较大,可以使用多个连接。
-
-```xml
-<dubbo:service interface="..." connections="1"/>
-<dubbo:reference interface="..." connections="1"/>
-```
-
-* `<dubbo:service connections="0">` 或 `<dubbo:reference connections="0">` 表示该服务使用 JVM 共享长连接。**缺省**
-* `<dubbo:service connections="1">` 或 `<dubbo:reference connections="1">` 表示该服务使用独立长连接。
-* `<dubbo:service connections="2">` 或`<dubbo:reference connections="2">` 表示该服务使用独立两条长连接。
-
-为防止被大量连接撑挂,可在服务提供方限制大接收连接数,以实现服务提供方自我保护。
-
-```xml
-<dubbo:protocol name="dubbo" accepts="1000" />
-```
-
-## 使用方式 - Go
-
-TBD
-
-## 使用方式 - Node.Js
-
-TBD
-
-## 使用方式 - Rust
-
-暂不支持
-
-## 常见问题
-
-### Q1
-为什么要消费者比提供者个数多?
-
-因 dubbo 协议采用单一长连接,假设网络为千兆网卡 **1024Mbit=128MByte**,根据测试经验数据每条连接最多只能压满 7MByte(不同的环境可能不一样,供参考),理论上 1 个服务提供者需要 20 个服务消费者才能压满网卡。
-
-### Q2
-为什么不能传大包?
-
-因 dubbo 协议采用单一长连接,如果每次请求的数据包大小为 500KByte,假设网络为千兆网卡 **1024Mbit=128MByte**,每条连接最大 7MByte (不同的环境可能不一样),单个服务提供者的 TPS(每秒处理事务数)最大为:128MByte / 500KByte = 262。单个消费者调用单个服务提供者的 TPS (每秒处理事务数)最大为:7MByte / 500KByte = 14。如果能接受,可以考虑使用,否则网络将成为瓶颈。
-
-### Q3
-为什么采用异步单一长连接?
-
-因为服务的现状大都是服务提供者少,通常只有几台机器,而服务的消费者多,可能整个网站都在访问该服务,比如 Morgan 的提供者只有 6 台提供者,却有上百台消费者,每天有 1.5 亿次调用,如果采用常规的 hessian 服务,服务提供者很容易就被压跨,通过单一连接,保证单一消费者不会压死提供者,长连接,减少连接握手验证等,并使用异步 IO,复用线程池,防止 C10K 问题。
diff --git a/content/zh-cn/overview/what/ecosystem/protocol/grpc.md b/content/zh-cn/overview/what/ecosystem/protocol/grpc.md
deleted file mode 100644
index 4c73ae9921..0000000000
--- a/content/zh-cn/overview/what/ecosystem/protocol/grpc.md
+++ /dev/null
@@ -1,51 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/protocol/grpc/
-description: ""
-linkTitle: gRPC
-title: gRPC
-type: docs
-weight: 4
----
-
-
-
-## 特性说明
-
-Dubbo 自 2.7.5 版本开始支持原生 gRPC 协议,对于计划使用 HTTP/2 通信,或者想利用 gRPC 带来的 Stream、反压、Reactive 编程等能力的开发者来说,
-都可以考虑启用 gRPC 协议。
-
-> 从 Dubbo 3 开始,Dubbo 提供的 Triple 协议原生支持 gRPC 协议。
-
-#### 支持 gRPC 的好处
-* 为期望使用 gRPC 协议的用户带来服务治理能力,方便接入 Dubbo 体系
-* 用户可以使用 Dubbo 风格的,基于接口的编程风格来定义和使用远程服务
-
-## 使用场景
-
-- 需要立即响应才能继续处理的同步后端微服务到微服务通信。
-- 需要支持混合编程平台的 Polyglot 环境。
-- 性能至关重要的低延迟和高吞吐量通信。
-- 点到点实时通信 - gRPC 无需轮询即可实时推送消息,并且能对双向流式处理提供出色的支持。
-- 网络受约束环境 - 二进制 gRPC 消息始终小于等效的基于文本的 JSON 消息。
-
-## 使用方式 - Java
-
-[示例](https://github.com/apache/dubbo-samples/tree/master/3-extensions/protocol/dubbo-samples-grpc)
-
-## 使用方式 - Go
-
-TBD
-
-## 使用方式 - Node.js
-
-TBD
-
-## 使用方式 - Rust
-
-暂不支持
-
-### 步骤
-1. 使用 IDL 定义服务
-2. 配置 compiler 插件,本地预编译
-3. 配置暴露/引用 Dubbo 服务
diff --git a/content/zh-cn/overview/what/ecosystem/protocol/rmi.md b/content/zh-cn/overview/what/ecosystem/protocol/rmi.md
deleted file mode 100644
index 7bdd87d088..0000000000
--- a/content/zh-cn/overview/what/ecosystem/protocol/rmi.md
+++ /dev/null
@@ -1,111 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/protocol/rmi/
-description: ""
-linkTitle: RMI
-title: RMI
-type: docs
-weight: 6
----
-
-
-
-## 特性说明
-RMI 协议采用 JDK 标准的 `java.rmi.*` 实现,采用阻塞式短连接和 JDK 标准序列化方式。
-
-* 连接个数:多连接
-* 连接方式:短连接
-* 传输协议:TCP
-* 传输方式:同步传输
-* 序列化:Java 标准二进制序列化
-* 适用范围:传入传出参数数据包大小混合,消费者与提供者个数差不多,可传文件。
-* 适用场景:常规远程服务方法调用,与原生RMI服务互操作
-
-#### 约束
-
-* 参数及返回值需实现 `Serializable` 接口
-* dubbo 配置中的超时时间对 RMI 无效,需使用 java 启动参数设置:`-Dsun.rmi.transport.tcp.responseTimeout=3000`,参见下面的 RMI 配置
-
-
-## 使用场景
-
-是 Java 的一组拥护开发分布式应用程序的 API,实现了不同操作系统之间程序的方法调用。
-
-## 使用方式 - Java
-
-### 引入依赖
-
-从 Dubbo 3 开始,RMI 协议已经不再内嵌在 Dubbo 中,需要单独引入独立的[模块](/zh-cn/download/spi-extensions/#dubbo-rpc)。
-```xml
-<dependency>
- <groupId>org.apache.dubbo.extensions</groupId>
- <artifactId>dubbo-rpc-rmi</artifactId>
- <version>1.0.0</version>
-</dependency>
-```
-
-```sh
-java -Dsun.rmi.transport.tcp.responseTimeout=3000
-```
-更多 RMI 优化参数请查看 [JDK 文档](https://docs.oracle.com/javase/6/docs/technotes/guides/rmi/sunrmiproperties.html)
-
-### 接口说明
-如果服务接口继承了 `java.rmi.Remote` 接口,可以和原生 RMI 互操作,即:
-
-* 提供者用 Dubbo 的 RMI 协议暴露服务,消费者直接用标准 RMI 接口调用,
-* 或者提供方用标准 RMI 暴露服务,消费方用 Dubbo 的 RMI 协议调用。
-
-如果服务接口没有继承 `java.rmi.Remote` 接口:
-
-* 缺省 Dubbo 将自动生成一个 `com.xxx.XxxService$Remote` 的接口,并继承 `java.rmi.Remote` 接口,并以此接口暴露服务,
-* 但如果设置了 `<dubbo:protocol name="rmi" codec="spring" />`,将不生成 `$Remote` 接口,而使用 Spring 的 `RmiInvocationHandler` 接口暴露服务,和 Spring 兼容。
-
-**定义 RMI 协议**
-
-```xml
-<dubbo:protocol name="rmi" port="1099" />
-```
-
-**设置默认协议**
-
-```xml
-<dubbo:provider protocol="rmi" />
-```
-
-**设置某个服务的协议**
-
-```xml
-<dubbo:service interface="..." protocol="rmi" />
-```
-
-**多端口**
-
-```xml
-<dubbo:protocol id="rmi1" name="rmi" port="1099" />
-<dubbo:protocol id="rmi2" name="rmi" port="2099" />
-
-<dubbo:service interface="..." protocol="rmi1" />
-```
-
-**Spring 兼容性**
-
-```xml
-<dubbo:protocol name="rmi" codec="spring" />
-```
-
-
-> - **如果正在使用 RMI 提供服务给外部访问,** 公司内网环境应该不会有攻击风险。
-> - **同时应用里依赖了老的 common-collections 包的情况下,** dubbo 不会依赖这个包,请排查自己的应用有没有使用。
-> - **存在反序列化安全风险。** 请检查应用:将 commons-collections3 请升级到 [3.2.2](https://commons.apache.org/proper/commons-collections/release_3_2_2.html);将 commons-collections4 请升级到 [4.1](https://commons.apache.org/proper/commons-collections/release_4_1.html)。新版本的 commons-collections 解决了该问题。
-
-## 使用方式 - Go
-
-暂不支持
-
-## 使用方式 - Node.js
-
-暂不支持
-
-## 使用方式 - Rust
-
-暂不支持
diff --git a/content/zh-cn/overview/what/ecosystem/protocol/thrift.md b/content/zh-cn/overview/what/ecosystem/protocol/thrift.md
deleted file mode 100644
index e8e3b51534..0000000000
--- a/content/zh-cn/overview/what/ecosystem/protocol/thrift.md
+++ /dev/null
@@ -1,63 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/protocol/thrift/
-description: ""
-linkTitle: Thrift
-title: Thrift
-type: docs
-weight: 5
----
-
-
-
-## 特性说明
-当前 dubbo 支持的 thrift 协议是对 thrift 原生协议的扩展,在原生协议的基础上添加了一些额外的头信息,比如 service name,magic number 等。`2.3.0` 以上版本支持。
-
-[Thrift](http://thrift.apache.org) 是 Facebook 捐给 Apache 的一个 RPC 框架。
-
-## 使用场景
-
-适用于 SOA 标准 RPC 框架。
-
-## 使用方式 - Java
-
-### 依赖
-
-从 Dubbo 3 开始,Thrift 协议已经不再内嵌在 Dubbo 中,需要单独引入独立的[模块](/zh-cn/download/spi-extensions/#dubbo-rpc)。
-```xml
-<dependency>
- <groupId>org.apache.dubbo.extensions</groupId>
- <artifactId>dubbo-rpc-native-thrift</artifactId>
- <version>1.0.0</version>
-</dependency>
-```
-
-
-```xml
-<dependency>
- <groupId>org.apache.thrift</groupId>
- <artifactId>libthrift</artifactId>
- <version>0.8.0</version>
-</dependency>
-```
-
-### 所有服务共用一个端口
-
-与原生 Thrift 不兼容
-```xml
-<dubbo:protocol name="thrift" port="3030" />
-```
-
-> Thrift 不支持 null 值,即:不能在协议中传递 null 值
-
-## 使用方式 - Go
-
-暂不支持
-
-## 使用方式 - Node.js
-
-暂不支持
-
-## 使用方式 - Rust
-
-暂不支持
diff --git a/content/zh-cn/overview/what/ecosystem/protocol/triple.md b/content/zh-cn/overview/what/ecosystem/protocol/triple.md
deleted file mode 100644
index 25bdd5b0ec..0000000000
--- a/content/zh-cn/overview/what/ecosystem/protocol/triple.md
+++ /dev/null
@@ -1,404 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/protocol/triple/
-description: ""
-linkTitle: Triple
-title: Triple
-type: docs
-weight: 2
----
-
-
-
-## 概述说明
-
-Triple 协议是 Dubbo3 推出的主力协议。Triple 意为第三代,通过 Dubbo1.0/ Dubbo2.0 两代协议的演进,以及云原生带来的技术标准化浪潮,Dubbo3 新协议 Triple 应运而生。
-
-### RPC 协议的选择
-
-协议是 RPC 的核心,它规范了数据在网络中的传输内容和格式。除必须的请求、响应数据外,通常还会包含额外控制数据,如单次请求的序列化方式、超时时间、压缩方式和鉴权信息等。
-
-协议的内容包含三部分
-- 数据交换格式: 定义 RPC 的请求和响应对象在网络传输中的字节流内容,也叫作序列化方式
-- 协议结构: 定义包含字段列表和各字段语义以及不同字段的排列方式
-- 协议通过定义规则、格式和语义来约定数据如何在网络间传输。一次成功的 RPC 需要通信的两端都能够按照协议约定进行网络字节流的读写和对象转换。如果两端对使用的协议不能达成一致,就会出现鸡同鸭讲,无法满足远程通信的需求。
-
-
-
-RPC 协议的设计需要考虑以下内容:
-- 通用性: 统一的二进制格式,跨语言、跨平台、多传输层协议支持
-- 扩展性: 协议增加字段、升级、支持用户扩展和附加业务元数据
-- 性能:As fast as it can be
-- 穿透性:能够被各种终端设备识别和转发:网关、代理服务器等
- 通用性和高性能通常无法同时达到,需要协议设计者进行一定的取舍。
-
-#### HTTP/1.1
-
-比于直接构建于 TCP 传输层的私有 RPC 协议,构建于 HTTP 之上的远程调用解决方案会有更好的通用性,如WebServices 或 REST 架构,使用 HTTP + JSON 可以说是一个事实标准的解决方案。
-
-选择构建在 HTTP 之上,有两个最大的优势:
-
-- HTTP 的语义和可扩展性能很好的满足 RPC 调用需求。
-- 通用性,HTTP 协议几乎被网络上的所有设备所支持,具有很好的协议穿透性。
-
-但也存在比较明显的问题:
-
-- 典型的 Request – Response 模型,一个链路上一次只能有一个等待的 Request 请求。会产生 HOL。
-- Human Readable Headers,使用更通用、更易于人类阅读的头部传输格式,但性能相当差
-- 无直接 Server Push 支持,需要使用 Polling Long-Polling 等变通模式
-
-#### gRPC
-上面提到了在 HTTP 及 TCP 协议之上构建 RPC 协议各自的优缺点,相比于 Dubbo 构建于 TCP 传输层之上,Google 选择将 gRPC 直接定义在 HTTP/2 协议之上。
-gRPC 的优势由HTTP2 和 Protobuf 继承而来。
-
-- 基于 HTTP2 的协议足够简单,用户学习成本低,天然有 server push/ 多路复用 / 流量控制能力
-- 基于 Protobuf 的多语言跨平台二进制兼容能力,提供强大的统一跨语言能力
-- 基于协议本身的生态比较丰富,k8s/etcd 等组件的天然支持协议,云原生的事实协议标准
-
-但是也存在部分问题
-
-- 对服务治理的支持比较基础,更偏向于基础的 RPC 功能,协议层缺少必要的统一定义,对于用户而言直接用起来并不容易。
-- 强绑定 protobuf 的序列化方式,需要较高的学习成本和改造成本,对于现有的偏单语言的用户而言,迁移成本不可忽视
-
-#### 最终的选择 Triple
-最终我们选择了兼容 gRPC ,以 HTTP2 作为传输层构建新的协议,也就是 Triple。
-
-容器化应用程序和微服务的兴起促进了针对负载内容优化技术的发展。 客户端中使用的传统通信协议( RESTFUL或其他基于 HTTP 的自定义协议)难以满足应用在性能、可维护性、扩展性、安全性等方便的需求。一个跨语言、模块化的协议会逐渐成为新的应用开发协议标准。自从 2017 年 gRPC 协议成为 CNCF 的项目后,包括 k8s、etcd 等越来越多的基础设施和业务都开始使用 gRPC 的生态,作为云原生的微服务化框架, Dubbo 的新协议也完美兼容了 gRPC。并且,对于 gRPC 协议中一些不完善的部分, Triple 也将进行增强和补充。
-
-那么,Triple 协议是否解决了上面我们提到的一系列问题呢?
-
-- 性能上: Triple 协议采取了 metadata 和 payload 分离的策略,这样就可以避免中间设备,如网关进行 payload 的解析和反序列化,从而降低响应时间。
-- 路由支持上,由于 metadata 支持用户添加自定义 header ,用户可以根据 header 更方便的划分集群或者进行路由,这样发布的时候切流灰度或容灾都有了更高的灵活性。
-- 安全性上,支持双向TLS认证(mTLS)等加密传输能力。
-- 易用性上,Triple 除了支持原生 gRPC 所推荐的 Protobuf 序列化外,使用通用的方式支持了 Hessian / JSON 等其他序列化,能让用户更方便的升级到 Triple 协议。对原有的 Dubbo 服务而言,修改或增加 Triple 协议 只需要在声明服务的代码块添加一行协议配置即可,改造成本几乎为 0。
-
-### Triple 协议
-
-
-
-- 现状
-
-1、完整兼容grpc、客户端/服务端可以与原生grpc客户端打通
-
-2、目前已经经过大规模生产实践验证,达到生产级别
-
-- 特点与优势
-
-1、具备跨语言互通的能力,传统的多语言多 SDK 模式和 Mesh 化跨语言模式都需要一种更通用易扩展的数据传输格式。
-
-2、提供更完善的请求模型,除了 Request/Response 模型,还应该支持 Streaming 和 Bidirectional。
-
-3、易扩展、穿透性高,包括但不限于 Tracing / Monitoring 等支持,也应该能被各层设备识别,网关设施等可以识别数据报文,对 Service Mesh 部署友好,降低用户理解难度。
-
-4、多种序列化方式支持、平滑升级
-
-5、支持 Java 用户无感知升级,不需要定义繁琐的 IDL 文件,仅需要简单的修改协议名便可以轻松升级到 Triple 协议
-
-#### Triple 协议内容介绍
-
-基于 grpc 协议进行进一步扩展
-
-- Service-Version → "tri-service-version" {Dubbo service version}
-- Service-Group → "tri-service-group" {Dubbo service group}
-- Tracing-ID → "tri-trace-traceid" {tracing id}
-- Tracing-RPC-ID → "tri-trace-rpcid" {_span id _}
-- Cluster-Info → "tri-unit-info" {cluster infomation}
-
-其中 Service-Version 跟 Service-Group 分别标识了 Dubbo 服务的 version 跟 group 信息,因为grpc的 path 申明了 service name 跟 method name,相比于 Dubbo 协议,缺少了version 跟 group 信息;Tracing-ID、Tracing-RPC-ID 用于全链路追踪能力,分别表示 tracing id 跟 span id 信息;Cluster-Info 表示集群信息,可以使用其构建一些如集群划分等路由相关的灵活的服务治理能力。
-
-#### Triple Streaming
-
-Triple协议相比传统的unary方式,多了目前提供的Streaming RPC的能力
-
-- Streaming 用于什么场景呢?
-
-在一些大文件传输、直播等应用场景中, consumer或provider需要跟对端进行大量数据的传输,由于这些情况下的数据量是非常大的,因此是没有办法可以在一个RPC的数据包中进行传输,因此对于这些数据包我们需要对数据包进行分片之后,通过多次RPC调用进行传输,如果我们对这些已经拆分了的RPC数据包进行并行传输,那么到对端后相关的数据包是无序的,需要对接收到的数据进行排序拼接,相关的逻辑会非常复杂。但如果我们对拆分了的RPC数据包进行串行传输,那么对应的网络传输RTT与数据处理的时延会是非常大的。
-
-为了解决以上的问题,并且为了大量数据的传输以流水线方式在consumer与provider之间传输,因此Streaming RPC的模型应运而生。
-
-通过Triple协议的Streaming RPC方式,会在consumer跟provider之间建立多条用户态的长连接,Stream。同一个TCP连接之上能同时存在多个Stream,其中每条Stream都有StreamId进行标识,对于一条Stream上的数据包会以顺序方式读写。
-
-## 使用方式 - Java
-
-### Protobuf 方式
-
-1. 编写 IDL 文件
- ```protobuf
- syntax = "proto3";
- option java_multiple_files = true;
- option java_package = "org.apache.dubbo.hello";
- option java_outer_classname = "HelloWorldProto";
- option objc_class_prefix = "HLW";
- package helloworld;
- // The request message containing the user's name.
- message HelloRequest {
- string name = 1;
- }
- // The response message containing the greetings
- message HelloReply {
- string message = 1;
- }
- ```
-
-2. 添加编译 protobuf 的 extension 和 plugin (以 maven 为例)
- ```xml
- <extensions>
- <extension>
- <groupId>kr.motd.maven</groupId>
- <artifactId>os-maven-plugin</artifactId>
- <version>1.6.1</version>
- </extension>
- </extensions>
- <plugins>
- <plugin>
- <groupId>org.xolstice.maven.plugins</groupId>
- <artifactId>protobuf-maven-plugin</artifactId>
- <version>0.6.1</version>
- <configuration>
- <protocArtifact>com.google.protobuf:protoc:3.7.1:exe:${os.detected.classifier}</protocArtifact>
- <pluginId>triple-java</pluginId>
- <outputDirectory>build/generated/source/proto/main/java</outputDirectory>
- </configuration>
- <executions>
- <execution>
- <goals>
- <goal>compile</goal>
- <goal>test-compile</goal>
- </goals>
- </execution>
- </executions>
- </plugin>
- </plugins>
- ```
-
-3. 构建/ 编译生成 protobuf Message 类
- ```shell
- mvn clean install
- ```
-
-### Unary 方式
-
-1. 编写 Java 接口
- ```java
- import org.apache.dubbo.hello.HelloReply;
- import org.apache.dubbo.hello.HelloRequest;
- public interface IGreeter {
- /**
- * <pre>
- * Sends a greeting
- * </pre>
- */
- HelloReply sayHello(HelloRequest request);
- }
- ```
-
-2. 创建 Provider
- ```java
- public static void main(String[] args) throws InterruptedException {
- ServiceConfig<IGreeter> service = new ServiceConfig<>();
- service.setInterface(IGreeter.class);
- service.setRef(new IGreeter1Impl());
- // 这里需要显示声明使用的协议为triple
- service.setProtocol(new ProtocolConfig(CommonConstants.TRIPLE, 50051));
- service.setApplication(new ApplicationConfig("demo-provider"));
- service.setRegistry(new RegistryConfig("zookeeper://127.0.0.1:2181"));
- service.export();
- System.out.println("dubbo service started");
- new CountDownLatch(1).await();
- }
- ```
-
-
-3. 创建 Consumer
-
- ```java
- public static void main(String[] args) throws IOException {
- ReferenceConfig<IGreeter> ref = new ReferenceConfig<>();
- ref.setInterface(IGreeter.class);
- ref.setCheck(false);
- ref.setProtocol(CommonConstants.TRIPLE);
- ref.setLazy(true);
- ref.setTimeout(100000);
- ref.setApplication(new ApplicationConfig("demo-consumer"));
- ref.setRegistry(new RegistryConfig("zookeeper://127.0.0.1:2181"));
- final IGreeter iGreeter = ref.get();
- System.out.println("dubbo ref started");
- try {
- final HelloReply reply = iGreeter.sayHello(HelloRequest.newBuilder()
- .setName("name")
- .build());
- TimeUnit.SECONDS.sleep(1);
- System.out.println("Reply:" + reply);
- } catch (Throwable t) {
- t.printStackTrace();
- }
- System.in.read();
- }
- ```
-
-4. 运行 Provider 和 Consumer ,可以看到请求正常返回
- ```java
- > Reply:message: "name"
- ```
-
-### stream 方式
-
-1. 编写 Java 接口
- ```java
- import org.apache.dubbo.hello.HelloReply;
- import org.apache.dubbo.hello.HelloRequest;
- public interface IGreeter {
- /**
- * <pre>
- * Sends greeting by stream
- * </pre>
- */
- StreamObserver<HelloRequest> sayHello(StreamObserver<HelloReply> replyObserver);
- }
- ```
-
-2. 编写实现类
- ```java
- public class IStreamGreeterImpl implements IStreamGreeter {
- @Override
- public StreamObserver<HelloRequest> sayHello(StreamObserver<HelloReply> replyObserver) {
- return new StreamObserver<HelloRequest>() {
- private List<HelloReply> replyList = new ArrayList<>();
- @Override
- public void onNext(HelloRequest helloRequest) {
- System.out.println("onNext receive request name:" + helloRequest.getName());
- replyList.add(HelloReply.newBuilder()
- .setMessage("receive name:" + helloRequest.getName())
- .build());
- }
- @Override
- public void onError(Throwable cause) {
- System.out.println("onError");
- replyObserver.onError(cause);
- }
- @Override
- public void onCompleted() {
- System.out.println("onComplete receive request size:" + replyList.size());
- for (HelloReply reply : replyList) {
- replyObserver.onNext(reply);
- }
- replyObserver.onCompleted();
- }
- };
- }
- }
- ```
-
-3. 创建 Provider
-
- ```java
- public class StreamProvider {
- public static void main(String[] args) throws InterruptedException {
- ServiceConfig<IStreamGreeter> service = new ServiceConfig<>();
- service.setInterface(IStreamGreeter.class);
- service.setRef(new IStreamGreeterImpl());
- service.setProtocol(new ProtocolConfig(CommonConstants.TRIPLE, 50051));
- service.setApplication(new ApplicationConfig("stream-provider"));
- service.setRegistry(new RegistryConfig("zookeeper://127.0.0.1:2181"));
- service.export();
- System.out.println("dubbo service started");
- new CountDownLatch(1).await();
- }
- }
- ```
-
-4. 创建 Consumer
-
- ```java
- public class StreamConsumer {
- public static void main(String[] args) throws InterruptedException, IOException {
- ReferenceConfig<IStreamGreeter> ref = new ReferenceConfig<>();
- ref.setInterface(IStreamGreeter.class);
- ref.setCheck(false);
- ref.setProtocol(CommonConstants.TRIPLE);
- ref.setLazy(true);
- ref.setTimeout(100000);
- ref.setApplication(new ApplicationConfig("stream-consumer"));
- ref.setRegistry(new RegistryConfig("zookeeper://mse-6e9fda00-p.zk.mse.aliyuncs.com:2181"));
- final IStreamGreeter iStreamGreeter = ref.get();
- System.out.println("dubbo ref started");
- try {
- StreamObserver<HelloRequest> streamObserver = iStreamGreeter.sayHello(new StreamObserver<HelloReply>() {
- @Override
- public void onNext(HelloReply reply) {
- System.out.println("onNext");
- System.out.println(reply.getMessage());
- }
- @Override
- public void onError(Throwable throwable) {
- System.out.println("onError:" + throwable.getMessage());
- }
- @Override
- public void onCompleted() {
- System.out.println("onCompleted");
- }
- });
- streamObserver.onNext(HelloRequest.newBuilder()
- .setName("tony")
- .build());
- streamObserver.onNext(HelloRequest.newBuilder()
- .setName("nick")
- .build());
- streamObserver.onCompleted();
- } catch (Throwable t) {
- t.printStackTrace();
- }
- System.in.read();
- }
- }
- ```
-
-5. 运行 Provider 和 Consumer ,可以看到请求正常返回了
- ```java
- > onNext\
- > receive name:tony\
- > onNext\
- > receive name:nick\
- > onCompleted
- ```
-
-### 其他序列化方式
-省略上文中的 1-3 步,指定 Provider 和 Consumer 使用的协议即可完成协议升级。
-
-## 使用方式 - Go
-
-TBD
-
-## 使用方式 - Node.js
-
-暂不支持
-
-## 使用方式 - Rust
-
-TBD
-
-## 常见问题
-
-### Q1
-protobuf 类找不到
-
-由于 Triple 协议底层需要依赖 protobuf 协议进行传输,即使定义的服务接口不使用 protobuf 也需要在环境中引入 protobuf 的依赖。
-
-```xml
- <dependency>
- <groupId>com.google.protobuf</groupId>
- <artifactId>protobuf-java</artifactId>
- <version>3.19.4</version>
- </dependency>
-```
-
-### Q2
-如何原生接入网关?
-
-对于需要网关接入的 Dubbo 用户,Triple 协议提供了更加原生的方式,让网关开发或者使用开源的 grpc 网关组件更加简单。网关可以选择不解析 payload ,在性能上也有很大提高。在使用 Dubbo 协议时,语言相关的序列化方式是网关的一个很大痛点,而传统的 HTTP 转 Dubbo 的方式对于跨语言序列化几乎是无能为力的。同时,由于 Triple 的协议元数据都存储在请求头中,网关可以轻松的实现定制需求,如路由和限流等功能。
-
-### 总结
-
-在API领域,最重要的趋势是标准化技术的崛起。Triple 协议是 Dubbo3 推出的主力协议。它采用分层设计,其数据交换格式基于Protobuf (Protocol Buffers) 协议开发,具备优秀的序列化/反序列化效率,当然还支持多种序列化方式,也支持众多开发语言。在传输层协议,Triple 选择了 HTTP/2,相较于 HTTP/1.1,其传输效率有了很大提升。此外HTTP/2作为一个成熟的开放标准,具备丰富的安全、流控等能力,同时拥有良好的互操作性。Triple 不仅可以用于Server端服务调用,也可以支持浏览器、移动App和IoT设备与后端服务的交互,同时 Triple协议无缝支持 Dubbo3 的全部服务治理能力。
-
-在Cloud Native的潮流下,跨平台、跨厂商、跨环境的系统间互操作性的需求必然会催生基于开放标准的RPC技术,而gRPC顺应了历史趋势,得到了越来越广泛地应用。在微服务领域,Triple协议的提出与落地,是 Dubbo3 迈向云原生微服务的一大步。
diff --git a/content/zh-cn/overview/what/ecosystem/rate-limit/_index.md b/content/zh-cn/overview/what/ecosystem/rate-limit/_index.md
deleted file mode 100644
index 57db3a22b5..0000000000
--- a/content/zh-cn/overview/what/ecosystem/rate-limit/_index.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/rate-limit/
-description: ""
-linkTitle: 限流降级
-title: 限流降级
-type: docs
-weight: 80
----
diff --git a/content/zh-cn/overview/what/ecosystem/rate-limit/polaris.md b/content/zh-cn/overview/what/ecosystem/rate-limit/polaris.md
deleted file mode 100644
index b48d8fe00b..0000000000
--- a/content/zh-cn/overview/what/ecosystem/rate-limit/polaris.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/rate-limit/polaris/
-description: ""
-linkTitle: Polaris
-title: Polaris
-type: docs
-weight: 30
----
diff --git a/content/zh-cn/overview/what/ecosystem/rate-limit/sentinel.md b/content/zh-cn/overview/what/ecosystem/rate-limit/sentinel.md
deleted file mode 100644
index 13246bdd95..0000000000
--- a/content/zh-cn/overview/what/ecosystem/rate-limit/sentinel.md
+++ /dev/null
@@ -1,140 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/rate-limit/sentinel/
-description: ""
-linkTitle: Sentinel
-title: Sentinel
-type: docs
-weight: 10
----
-
-
-
-在复杂的生产环境下可能部署着成千上万的 Dubbo 服务实例,流量持续不断地进入,服务之间进行相互调用。但是分布式系统中可能会因流量激增、系统负载过高、网络延迟等一系列问题,导致某些服务不可用,如果不进行相应的控制可能导致级联故障,影响服务的可用性,因此如何对流量进行合理的控制,成为保障服务稳定性的关键。
-
-[Sentinel](https://github.com/alibaba/Sentinel) 是阿里中间件团队开源的,面向分布式服务架构的轻量级流量控制产品,主要以流量为切入点,从**流量控制**、**熔断降级**、**系统负载保护**等多个维度来帮助用户保护服务的稳定性。本文将基于 Dubbo,看看 Sentinel 是如何进行流量控制的,并且提供 Dubbo 整合 Sentinel 的最佳实践。
-
-## 快速接入 Sentinel
-
-Sentinel 意为**哨兵**,这个命名形象的诠释了 Sentinel 在分布式系统中的工作角色和重要性。以 Sentinel 在 Dubbo 生态系统中的作用为例,Dubbo 的核心模块包括注册中心、服务提供方、服务消费方(服务调用方)和监控四个模块。Sentinel 通过对服务提供方和服务消费方的限流来进一步提升服务的可用性。接下来我们看看 Sentinel 对服务提供方和服务消费方限流的技术实现方式。
-
-
-
-Sentinel 提供了与 Dubbo 适配的模块 – [Sentinel Dubbo Adapter](https://github.com/dubbo/dubbo-sentinel-support),包括针对服务提供方的过滤器和服务消费方的过滤器(Filter)。使用时我们只需引入以下模块(以 Maven 为例):
-
-```xml
-<dependency>
- <groupId>com.alibaba.csp</groupId>
- <artifactId>sentinel-dubbo-adapter</artifactId>
- <version>x.y.z</version>
-</dependency>
-```
-
-引入此依赖后,Dubbo 的服务接口和方法(包括调用端和服务端)就会成为 Sentinel 中的资源,在配置了规则后就可以自动享受到 Sentinel 的防护能力。同时提供了灵活的配置选项,例如若不希望开启 Sentinel Dubbo Adapter 中的某个 Filter,可以手动关闭对应的 Filter。
-
-接入 Sentinel Dubbo Adapter 后,即使未配置规则,Sentinel 也会对相应的 Dubbo 服务的调用信息进行统计。那么我们怎么知道 Sentinel 接入成功了呢?这时候就要请出一大利器 —— Sentinel 控制台了。
-
-## 限流必备 - 监控管理
-
-流量具有很强的实时性,之所以需要限流,是因为我们无法对流量的到来作出精确的预判,不然的话我们完全可以通过弹性的计算资源来处理,所以这时候为了保证限流的准确性,限流框架的监控功能就非常重要了。
-
-Sentinel 的控制台(Dashboard)是流量控制、熔断降级规则统一配置和管理的入口,同时它为用户提供了多个维度的监控功能。在 Sentinel 控制台上,我们可以配置规则并实时查看流量控制效果。
-
-接入 Sentinel 控制台的步骤如下(**缺一不可**):
-
-1. 按照 [Sentinel 控制台文档](https://github.com/alibaba/Sentinel/wiki/%E6%8E%A7%E5%88%B6%E5%8F%B0) 启动控制台
-2. 应用引入 `sentinel-transport-simple-http` 依赖,以便控制台可以拉取对应应用的相关信息
-3. 给应用添加相关的启动参数,启动应用。需要配置的参数有:
- - `-Dcsp.sentinel.api.port`:客户端的 port,用于上报相关信息(默认为 8719)
- - `-Dcsp.sentinel.dashboard.server`:控制台的地址
- - `-Dproject.name`:应用名称,会在控制台中显示
-
-注意某些环境下本地运行 Dubbo 服务还需要加上 `-Djava.net.preferIPv4Stack=true` 参数。比如中 Service Provider 的启动参数可以配成:
-
-```bash
--Djava.net.preferIPv4Stack=true -Dcsp.sentinel.api.port=8720 -Dcsp.sentinel.dashboard.server=localhost:8080 -Dproject.name=dubbo-provider-demo
-```
-
-这样在启动应用后就能在控制台找到对应的应用了。以下是常用功能:
-
-- **单台设备监控**:当在机器列表中看到您的机器,就代表着已经成功接入控制台,可以查看单台设备的设备名称、IP地址、端口号、健康状态和心跳时间等信息。
-
-
-
-- **链路监控**:簇点链路实时的去拉取指定客户端资源的运行情况,它提供了两种展示模式,一种用树状结构展示资源的调用链路;另外一种则不区分调用链路展示资源的运行情况。通过链路监控,可以查看到每个资源的流控和降级的历史状态。
-
-| 树状链路| 平铺链路
-| :----: | :----
-||
-
-- **聚合监控**:同一个服务下的所有机器的簇点信息会被汇总,实现实时监控,精确度达秒级。
-
-
-
-- **规则配置**:可以查看已有的限流、降级和系统保护规则,并实时地进行配置。
-
-
-
-## Sentinel 基于 Dubbo 的最佳实践
-
-> 具体 Demo 代码请见 [sentinel-demo-dubbo](https://github.com/alibaba/Sentinel/tree/master/sentinel-demo/sentinel-demo-dubbo)。
-### Service Provider
-
-> 对服务提供方的流量控制可分为**服务提供方的自我保护能力**和**服务提供方对服务消费方的请求分配能力**两个维度。
->
-Service Provider 用于向外界提供服务,处理各个消费者的调用请求。为了保护 Provider 不被激增的流量拖垮影响稳定性,可以给 Provider 配置 **QPS 模式**的限流,这样当每秒的请求量超过设定的阈值时会自动拒绝多的请求。限流粒度可以是 *服务接口* 和 *服务方法* 两种粒度。若希望整个服务接口的 QPS 不超过一定数值,则可以为对应服务接口资源(resourceName 为**接口全限定名**)配置 QPS 阈值;若希望服务的某个方法的 QPS 不超过一定数值,则可以为对应服务方法资源(resourceName 为**接口全限定名:方法签名**)配置 QPS 阈值。有关配置详情请参考 [流量控制 | Sentinel](https://github.com/alibaba/Sentinel/wiki/%E6%B5%81%E9%87%8F%E6%8E%A7%E5%88%B6)。
-
-我们看一下这种模式的限流产生的效果。假设我们已经定义了某个服务接口 `com.alibaba.csp.sentinel.demo.dubbo.FooService`,其中有一个方法 `sayHello(java.lang.String)`,Provider 端该方法设定 QPS 阈值为 10。在 Consumer 端在 1s 之内连续发起 15 次调用,可以通过日志文件看到 Provider 端被限流。拦截日志统一记录在 `~/logs/csp/sentinel-block.log` 中:
-
-```
-2018-07-24 17:13:43|1|com.alibaba.csp.sentinel.demo.dubbo.FooService:sayHello(java.lang.String),FlowException,default,|5,0
-```
-
-在 Provider 对应的 metrics 日志中也有记录:
-
-```
-1532423623000|2018-07-24 17:13:43|com.alibaba.csp.sentinel.demo.dubbo.FooService|15|0|15|0|3
-1532423623000|2018-07-24 17:13:43|com.alibaba.csp.sentinel.demo.dubbo.FooService:sayHello(java.lang.String)|10|5|10|0|0
-```
-
-根据**调用方**的需求来分配服务提供方的处理能力也是常见的限流方式。比如有两个服务 A 和 B 都向 Service Provider 发起调用请求,我们希望只对来自服务 B 的请求进行限流,则可以设置限流规则的 `limitApp` 为服务 B 的名称。Sentinel Dubbo Adapter 会自动解析 Dubbo 消费者(调用方)的 application name 作为调用方名称(`origin`),在进行资源保护的时候都会带上调用方名称。若限流规则未配置调用方(`default`),则该限流规则对所有调用方生效。若限流规则配置了调用方则限流规则将仅对指定调用方生效。
-
-> 注:Dubbo 默认通信不携带对端 application name 信息,因此需要开发者在调用端手动将 application name 置入 attachment 中,provider 端进行相应的解析。Sentinel Dubbo Adapter 实现了一个 Filter 用于自动从 consumer 端向 provider 端透传 application name。若调用端未引入 Sentinel Dubbo Adapter,又希望根据调用端限流,可以在调用端手动将 application name 置入 attachment 中,key 为 `dubboApplication`。
-在限流日志中会也会记录调用方的名称,如下面的日志中的 `demo-consumer` 即为调用方名称:
-
-```
-2018-07-25 16:26:48|1|com.alibaba.csp.sentinel.demo.dubbo.FooService:sayHello(java.lang.String),FlowException,default,demo-consumer|5,0
-```
-
-### Service Consumer
-
-> 对服务提供方的流量控制可分为**控制并发线程数**和**服务降级**两个维度。
-#### 并发线程数限流
-
-Service Consumer 作为客户端去调用远程服务。每一个服务都可能会依赖几个下游服务,若某个服务 A 依赖的下游服务 B 出现了不稳定的情况,服务 A 请求 服务 B 的响应时间变长,从而服务 A 调用服务 B 的线程就会产生堆积,最终可能耗尽服务 A 的线程数。我们通过用并发线程数来控制对下游服务 B 的访问,来保证下游服务不可靠的时候,不会拖垮服务自身。基于这种场景,推荐给 Consumer 配置**线程数模式**的限流,来保证自身不被不稳定服务所影响。采用基于线程数的限流模式后,我们不需要再显式地去进行线程池隔离,Sentinel 会控制资源的线程数,超出的请求直接拒绝,直到堆积的线程处理完成,可以达到**信号量隔离**的效果。
-
-我们看一下这种模式的效果。假设当前服务 A 依赖两个远程服务方法 `sayHello(java.lang.String)` 和 `doAnother()`。前者远程调用的响应时间 为 1s-1.5s 之间,后者 RT 非常小(30 ms 左右)。服务 A 端设两个远程方法 thread count 为 5。然后每隔 50 ms 左右向线程池投入两个任务,作为消费者分别远程调用对应方法,持续 10 次。可以看到 `sayHello` 方法被限流 5 次,因为后面调用的时候前面的远程调用还未返回(RT 高);而 `doAnother()` 调用则不受影响。线程数目超出时快速失败能够有效地防止自己被慢调用所影响。
-
-#### 服务降级
-
-当服务依赖于多个下游服务,而某个下游服务调用非常慢时,会严重影响当前服务的调用。这里我们可以利用 Sentinel 熔断降级的功能,为调用端配置基于平均 RT 的[降级规则](https://github.com/alibaba/Sentinel/wiki/%E7%86%94%E6%96%AD%E9%99%8D%E7%BA%A7)。这样当调用链路中某个服务调用的平均 RT 升高,在一定的次数内超过配置的 RT 阈值,Sentinel 就会对此调用资源进行降级操作,接下来的调用都会立刻拒绝,直到过了一段设定的时间后才恢复,从而保护服务不被调用端短板所影响。同时可以配合 fallback 功能使用,在被降级的时候提供相应的处理逻辑。
-
-### Fallback
-
-从 0.1.1 版本开始,Sentinel Dubbo Adapter 还支持配置全局的 fallback 函数,可以在 Dubbo 服务被限流/降级/负载保护的时候进行相应的 fallback 处理。用户只需要实现自定义的 [`DubboFallback`](https://github.com/alibaba/Sentinel/blob/master/sentinel-adapter/sentinel-dubbo-adapter/src/main/java/com/alibaba/csp/sentinel/adapter/dubbo/fallback/DubboFallback.java) 接口,并通过 `DubboFallbackRegistry` 注册即可。默认情况会直接将 `BlockException` 包装后抛出。同时,我们还可以配合 [Dubbo 的 fallback 机制](/zh-cn/docsv2.7/user/examples/local-mock/) 来为降级的服务提供替代的实现。
-
-## Sentinel 与 Hystrix 的比较
-
-目前业界常用的熔断降级/隔离的库是 Netflix 的 [Hystrix](https://github.com/Netflix/Hystrix),那么 Sentinel 与 Hystrix 有什么异同呢?Hystrix 的关注点在于以 *隔离* 和 *熔断* 为主的容错机制,而 Sentinel 的侧重点在于多样化的流量控制、熔断降级、系统负载保护、实时监控和控制台,可以看到解决的问题还是有比较大的不同的。
-
-Hystrix 采用命令模式封装资源调用逻辑,并且资源的定义与隔离规则是强依赖的,即在创建 HystrixCommand 的时候就要指定隔离规则(因其执行模型依赖于隔离模式)。Sentinel 的设计更为简单,不关注资源是如何执行的,资源的定义与规则的配置相分离。用户可以先定义好资源,然后在需要的时候配置规则即可。Sentinel 的原则非常简单:根据对应资源配置的规则来为资源执行相应的限流/降级/负载保护策略,若规则未配置则仅进行统计。从 0.1.1 版本开始,Sentinel 还引入了[注解支持](https://github.com/alibaba/Sentinel/wiki/%E6%B3%A8%E8%A7%A3%E6%94%AF%E6%8C%81),可以更方便地定义资源。
-
-隔离是 Hystrix 的核心功能。Hystrix 通过线程池或信号量的方式来对依赖(即 Sentinel 中对应的资源)进行隔离,其中最常用的是资源隔离。Hystrix 线程池隔离的好处是比较彻底,但是不足之处在于要开很多线程池,在应用本身线程数目比较多的时候上下文切换的 overhead 会非常大;Hystrix 的信号量隔离模式可以限制调用的并发数而不显式创建线程,这样的方式比较轻量级,但缺点是无法对慢调用自动进行降级,只能等待客户端自己超时,因此仍然可能会出现级联阻塞的情况。Sentinel 可以通过并发线程数模式的流量控制来提供信号量隔离的功能。并且结合基于响应时间的熔断降级模式,可以在不稳定资源的平均响应时间比较高的时候自动降级,防止过多的慢调用占满并发数,影响整个系统。
-
-Hystrix 熔断降级功能采用熔断器模式,在某个服务失败比率高时自动进行熔断。Sentinel 的熔断降级功能更为通用,支持平均响应时间与失败比率两个指标。Sentinel 还提供各种调用链路关系和流量控制效果支持,同时还可以根据系统负载去实时地调整流量来保护系统,应用场景更为丰富。同时,Sentinel 还提供了实时的监控 API 和控制台,可以方便用户快速了解目前系统的状态,对服务的稳定性了如指掌。
-
-更详细的对比请参见 [Sentinel 与 Hystrix 的对比](https://github.com/alibaba/Sentinel/wiki/Sentinel-%E4%B8%8E-Hystrix-%E7%9A%84%E5%AF%B9%E6%AF%94)。
-
-## 总结
-
-以上介绍的只是 Sentinel 的一个最简单的场景 —— 限流。Sentinel 还可以处理更复杂的各种情况,比如超时熔断、冷启动、请求匀速等。可以参考 [Sentinel 文档](https://github.com/alibaba/Sentinel/wiki/%E4%B8%BB%E9%A1%B5),更多的场景等待你去挖掘!
diff --git a/content/zh-cn/overview/what/ecosystem/registry/_index.md b/content/zh-cn/overview/what/ecosystem/registry/_index.md
deleted file mode 100644
index 47dc6a2cfa..0000000000
--- a/content/zh-cn/overview/what/ecosystem/registry/_index.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/registry/
-description: ""
-linkTitle: 注册中心
-title: 注册中心
-type: docs
-weight: 30
----
diff --git a/content/zh-cn/overview/what/ecosystem/registry/consul.md b/content/zh-cn/overview/what/ecosystem/registry/consul.md
deleted file mode 100644
index 2d7f546236..0000000000
--- a/content/zh-cn/overview/what/ecosystem/registry/consul.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/registry/consul/
-description: ""
-linkTitle: Consul
-title: Consul
-type: docs
-weight: 30
----
diff --git a/content/zh-cn/overview/what/ecosystem/registry/etcd.md b/content/zh-cn/overview/what/ecosystem/registry/etcd.md
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/content/zh-cn/overview/what/ecosystem/registry/eureka.md b/content/zh-cn/overview/what/ecosystem/registry/eureka.md
deleted file mode 100644
index 2e3625d4d6..0000000000
--- a/content/zh-cn/overview/what/ecosystem/registry/eureka.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/registry/eureka/
-description: ""
-linkTitle: Eureka
-title: Eureka
-type: docs
-weight: 40
----
diff --git a/content/zh-cn/overview/what/ecosystem/registry/nacos.md b/content/zh-cn/overview/what/ecosystem/registry/nacos.md
deleted file mode 100644
index 4eaeb2dc2f..0000000000
--- a/content/zh-cn/overview/what/ecosystem/registry/nacos.md
+++ /dev/null
@@ -1,186 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/registry/nacos/
-description: ""
-linkTitle: Nacos
-title: Nacos
-type: docs
-weight: 20
----
-
-
-
-## 1 介绍
-
-Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。
-
-Nacos 致力于帮助您发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。
-
-Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。 Nacos 是构建以“服务”为中心的现代应用架构 (例如微服务范式、云原生范式) 的服务基础设施。
-
-参考文档:https://nacos.io/zh-cn/docs/v2/what-is-nacos.html
-
-
-## 2 使用说明 - Java
-在此查看[完整示例代码](https://github.com/apache/dubbo-samples/tree/master/3-extensions/registry/dubbo-samples-nacos/dubbo-samples-nacos-registry)
-
-### 2.1 增加依赖
-```xml
-<dependencies>
- <dependency>
- <groupId>com.alibaba.nacos</groupId>
- <artifactId>nacos-client</artifactId>
- <version>2.1.2</version>
- </dependency>
-</dependencies>
-```
-增加 Dubbo 与 Nacos 依赖
-
-> Dubbo `3.0.0` 及以上版本需 nacos-client `2.0.0` 及以上版本
-
-### 2.2 配置并启用 Nacos
-
-```yaml
-# application.yml (Spring Boot)
-dubbo
- registry
- address: nacos://localhost:8848
-```
-或
-```properties
-# dubbo.properties
-dubbo.registry.address=nacos://localhost:8848
-```
-或
-```xml
-<dubbo:registry address="nacos://localhost:8848" />
-```
-
-启用应用,查看注册后的效果或工作原理,请查看 [工作原理](#4-工作原理)。
-
-## 3 高级配置
-
-### 3.1 认证
-
-```yaml
-# application.yml (Spring Boot)
-dubbo
- registry
- address: nacos://localhost:8848?username=nacos&password=nacos
-```
-
-或
-
-```properties
-# dubbo.properties
-dubbo.registry.address: nacos://nacos:nacos@localhost:8848
-```
-
-### 3.2 自定义命名空间
-
-```yaml
-# application.yml (Spring Boot)
-dubbo:
- registry:
- address: nacos://localhost:8848?namespace=5cbb70a5-xxx-xxx-xxx-d43479ae0932
-```
-
-或者
-
-```yaml
-# application.yml (Spring Boot)
-dubbo:
- registry:
- address: nacos://localhost:8848
- parameters.namespace: 5cbb70a5-xxx-xxx-xxx-d43479ae0932
-```
-
-### 3.3 自定义分组
-
-```yaml
-# application.yml
-dubbo:
- registry:
- address: nacos://localhost:8848
- group: dubbo
-```
-
-> 如果不配置的话,group 是由 Nacos 默认指定。group 和 namespace 在 Nacos 中代表不同的隔离层次,通常来说 namespace 用来隔离不同的用户或环境,group 用来对同一环境内的数据做进一步归组。
-### 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 | 该实例在不发送心跳后,从健康到不健康的时间(毫秒) | 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,如
-
- ```properties
- dubbo.registry.parameters.preserved.heart.beat.timeout=5000
- ```
-
-## 4 工作原理
-
-以下仅为展示 Nacos 作为 Dubbo 注册中心的工作原理,Dubbo 服务运维建议使用 [Dubbo Admin](https://github.com/apache/dubbo-admin)
-
-### 4.1 Dubbo2 注册数据
-
-随后,重启您的 Dubbo 应用,Dubbo 的服务提供和消费信息在 Nacos 控制台中可以显示:
-
-
-
-如图所示,服务名前缀为 `providers:` 的信息为服务提供者的元信息,`consumers:` 则代表服务消费者的元信息。点击“**详情**”可查看服务状态详情:
-
-
-
-### 4.2 Dubbo3 注册数据
-应用级服务发现的 "服务名" 为应用名
-
-
-
-> Dubbo3 默认采用 "应用级服务发现 + 接口级服务发现" 的双注册模式,因此会发现应用级服务(应用名)和接口级服务(接口名)同时出现在 Nacos 控制台,可以通过配置 `dubbo.registry.register-mode=instance/interface/all` 来改变注册行为。
\ No newline at end of file
diff --git a/content/zh-cn/overview/what/ecosystem/registry/polaris.md b/content/zh-cn/overview/what/ecosystem/registry/polaris.md
deleted file mode 100644
index 98aa587f9f..0000000000
--- a/content/zh-cn/overview/what/ecosystem/registry/polaris.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/registry/polaris/
-description: ""
-linkTitle: Polaris
-title: Polaris
-type: docs
-weight: 50
----
diff --git a/content/zh-cn/overview/what/ecosystem/registry/sofa.md b/content/zh-cn/overview/what/ecosystem/registry/sofa.md
deleted file mode 100644
index 1568843eca..0000000000
--- a/content/zh-cn/overview/what/ecosystem/registry/sofa.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/registry/sofa/
-description: ""
-linkTitle: Sofa
-title: Sofa
-type: docs
-weight: 60
----
diff --git a/content/zh-cn/overview/what/ecosystem/registry/zookeeper.md b/content/zh-cn/overview/what/ecosystem/registry/zookeeper.md
deleted file mode 100644
index ec44304961..0000000000
--- a/content/zh-cn/overview/what/ecosystem/registry/zookeeper.md
+++ /dev/null
@@ -1,133 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/registry/zookeeper/
-description: ""
-linkTitle: Zookeeper
-title: Zookeeper
-type: docs
-weight: 10
----
-
-
-
-## 1 介绍
-
-Apache ZooKeeper是Apache软件基金会的一个软件项目,它为大型分布式计算提供开源的分布式配置服务、同步服务和命名注册。 ZooKeeper曾经是Hadoop的一个子项目,但现在是一个独立的顶级项目。
-
-ZooKeeper的架构通过冗余服务实现高可用性。因此,如果第一次无应答,客户端就可以询问另一台ZooKeeper主机。ZooKeeper节点将它们的数据存储于一个分层的名字空间,非常类似于一个文件系统或一个前缀树结构。客户端可以在节点读写,从而以这种方式拥有一个共享的配置服务。更新是全序的。
-
-
-## 2 使用说明 - Java
-
-在此查看[完整示例代码](https://github.com/apache/dubbo-samples/tree/master/3-extensions/registry/dubbo-samples-zookeeper)
-
-### 2.1 增加 Maven 依赖
-```xml
-<properties>
- <dubbo.version>3.1.6</dubbo.version>
-</properties>
-
-<dependencies>
- <!-- This dependency helps to introduce Curator and Zookeeper dependencies that are necessary for Dubbo to work with zookeeper as transitive dependencies -->
- <dependency>
- <groupId>org.apache.dubbo</groupId>
- <artifactId>dubbo-dependencies-zookeeper</artifactId>
- <version>${dubbo.version}</version>
- <type>pom</type>
- </dependency>
-</dependencies>
-```
-
-`dubbo-dependencies-zookeeper` 将自动为应用增加 Zookeeper 相关客户端的依赖,减少用户使用 Zookeeper 成本,如使用中遇到版本兼容问题,用户也可以不使用 `dubbo-dependencies-zookeeper`,而是自行添加 Curator、Zookeeper Client 等依赖。
-
-由于 Dubbo 使用 Curator 作为与 Zookeeper Server 交互的编程客户端,因此,要特别注意 Zookeeper Server 与 Dubbo 版本依赖的兼容性
-
-|Zookeeper Server 版本|Dubbo 版本|Dubbo Zookeeper 依赖包|说明|
-|-----|-----|-----|-----|
-|3.4.x 及以下|3.0.x 及以上|dubbo-dependencies-zookeeper|传递依赖 Curator 4.x 、Zookeeper 3.4.x|
-|3.5.x 及以上|3.0.x 及以上|dubbo-dependencies-zookeeper-curator5|传递依赖 Curator 5.x 、Zookeeper 3.7.x|
-|3.4.x 及以上|2.7.x 及以下|dubbo-dependencies-zookeeper|传递依赖 Curator 4.x 、Zookeeper 3.4.x|
-|3.5.x 及以上|2.7.x 及以下|无|须自行添加 Curator、Zookeeper 等相关客户端依赖|
-
-### 2.2 配置并启用 Zookeeper
-```yaml
-# application.yml
-dubbo:
- registry:
- address: zookeeper://localhost:2181
-```
-或
-```properties
-# dubbo.properties
-dubbo.registry.address=zookeeper://localhost:2181
-```
-或
-```xml
-<dubbo:registry address="zookeeper://localhost:2181" />
-```
-
-`address` 是启用 zookeeper 注册中心唯一必须指定的属性,而在生产环境下,`address` 通常被指定为集群地址,如
-
-`address=zookeeper://10.20.153.10:2181?backup=10.20.153.11:2181,10.20.153.12:2181`
-
-protocol 与 address 分开配置的模式也可以,如
-
-`<dubbo:registry protocol="zookeeper" address="10.20.153.10:2181,10.20.153.11:2181,10.20.153.12:2181" />`
-
-## 3 高级配置
-### 3.1 认证与鉴权
-
-如果 Zookeeper 开启认证,Dubbo 支持指定 username、password 的方式传入身份标识。
-
-```yaml
-# application.yml
-dubbo:
- registry:
- address: zookeeper://localhost:2181
- username: hello
- password: 1234
-```
-
-也可以直接将参数扩展在 address 上 `address=zookeeper://hello:1234@localhost:2181`
-
-### 3.2 分组隔离
-通过指定 `group` 属性,可以在同一个 Zookeeper 集群内实现微服务地址的逻辑隔离。比如可以在一套集群内隔离出多套开发环境,在地址发现层面实现隔离。
-
-```yaml
-# application.yml
-dubbo:
- registry:
- address: zookeeper://localhost:2181
- group: daily1
-```
-### 3.3 其他扩展配置
-配置连接、会话过期时间
-```yaml
-# application.yml
-dubbo:
- registry:
- address: zookeeper://localhost:2181
- timeout: 30 * 1000 # 连接超时时间,默认 30s
- session: 60 * 1000 # 会话超时时间,默认 60s
-```
-
-## 4 工作原理
-
-### 4.1 Dubbo2 节点结构
-
-
-
-流程:
-* 服务提供者启动时: 向 `/dubbo/com.foo.BarService/providers` 目录下写入自己的 URL 地址。
-* 服务消费者启动时: 订阅 `/dubbo/com.foo.BarService/providers` 目录下的提供者 URL 地址。并向 `/dubbo/com.foo.BarService/consumers` 目录下写入自己的 URL 地址
-* 监控中心启动时: 订阅 `/dubbo/com.foo.BarService` 目录下的所有提供者和消费者 URL 地址。
-
-支持以下功能:
-
-* 当提供者出现断电等异常停机时,注册中心能自动删除提供者信息
-* 当注册中心重启时,能自动恢复注册数据,以及订阅请求
-* 当会话过期时,能自动恢复注册数据,以及订阅请求
-* 当设置 `<dubbo:registry check="false" />` 时,记录失败注册和订阅请求,后台定时重试
-* 可通过 `<dubbo:registry username="admin" password="1234" />` 设置 zookeeper 登录信息
-* 可通过 `<dubbo:registry group="dubbo" />` 设置 zookeeper 的根节点,不配置将使用默认的根节点。
-* 支持 `*` 号通配符 `<dubbo:reference group="*" version="*" />`,可订阅服务的所有分组和所有版本的提供者
\ No newline at end of file
diff --git a/content/zh-cn/overview/what/ecosystem/service-mesh/_index.md b/content/zh-cn/overview/what/ecosystem/service-mesh/_index.md
deleted file mode 100644
index fa6b71e797..0000000000
--- a/content/zh-cn/overview/what/ecosystem/service-mesh/_index.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/service-mesh/
-description: ""
-linkTitle: Service Mesh
-title: Service Mesh
-type: docs
-weight: 70
----
diff --git a/content/zh-cn/overview/what/ecosystem/service-mesh/aeraki.md b/content/zh-cn/overview/what/ecosystem/service-mesh/aeraki.md
deleted file mode 100644
index 1957fb3392..0000000000
--- a/content/zh-cn/overview/what/ecosystem/service-mesh/aeraki.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/service-mesh/aeraki/
-description: ""
-linkTitle: Aeraki
-title: Aeraki
-type: docs
-weight: 20
----
diff --git a/content/zh-cn/overview/what/ecosystem/service-mesh/istio.md b/content/zh-cn/overview/what/ecosystem/service-mesh/istio.md
deleted file mode 100644
index 50d4659fe7..0000000000
--- a/content/zh-cn/overview/what/ecosystem/service-mesh/istio.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/service-mesh/istio/
-description: ""
-linkTitle: istio
-title: istio
-type: docs
-weight: 10
----
diff --git a/content/zh-cn/overview/what/ecosystem/tracing/_index.md b/content/zh-cn/overview/what/ecosystem/tracing/_index.md
deleted file mode 100644
index 63d6377ea8..0000000000
--- a/content/zh-cn/overview/what/ecosystem/tracing/_index.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/tracing/
-description: ""
-linkTitle: 链路追踪
-title: 链路追踪
-type: docs
-weight: 100
----
diff --git a/content/zh-cn/overview/what/ecosystem/tracing/micrometer.md b/content/zh-cn/overview/what/ecosystem/tracing/micrometer.md
deleted file mode 100644
index eb96de5014..0000000000
--- a/content/zh-cn/overview/what/ecosystem/tracing/micrometer.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/tracing/micrometer/
-description: ""
-linkTitle: Micrometer
-title: Micrometer
-type: docs
-weight: 30
----
diff --git a/content/zh-cn/overview/what/ecosystem/tracing/opentelemetry.md b/content/zh-cn/overview/what/ecosystem/tracing/opentelemetry.md
deleted file mode 100644
index 3de1f29d24..0000000000
--- a/content/zh-cn/overview/what/ecosystem/tracing/opentelemetry.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/tracing/opentelemetry/
-description: ""
-linkTitle: OpenTelemetry
-title: OpenTelemetry
-type: docs
-weight: 40
----
diff --git a/content/zh-cn/overview/what/ecosystem/tracing/skywalking.md b/content/zh-cn/overview/what/ecosystem/tracing/skywalking.md
deleted file mode 100644
index 7f98efdb61..0000000000
--- a/content/zh-cn/overview/what/ecosystem/tracing/skywalking.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/tracing/skywalking/
-description: ""
-linkTitle: Skywalking
-title: Skywalking
-type: docs
-weight: 10
----
diff --git a/content/zh-cn/overview/what/ecosystem/tracing/zipkin.md b/content/zh-cn/overview/what/ecosystem/tracing/zipkin.md
deleted file mode 100644
index 29942f33b0..0000000000
--- a/content/zh-cn/overview/what/ecosystem/tracing/zipkin.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/tracing/zipkin/
-description: ""
-linkTitle: Zipkin
-title: Zipkin
-type: docs
-weight: 20
----
diff --git a/content/zh-cn/overview/what/ecosystem/transaction/_index.md b/content/zh-cn/overview/what/ecosystem/transaction/_index.md
deleted file mode 100644
index e755c11cc1..0000000000
--- a/content/zh-cn/overview/what/ecosystem/transaction/_index.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/transaction/
-description: ""
-linkTitle: 全局事务
-title: 全局事务
-type: docs
-weight: 90
----
diff --git a/content/zh-cn/overview/what/ecosystem/transaction/seata.md b/content/zh-cn/overview/what/ecosystem/transaction/seata.md
deleted file mode 100644
index 8aab7ac2dd..0000000000
--- a/content/zh-cn/overview/what/ecosystem/transaction/seata.md
+++ /dev/null
@@ -1,217 +0,0 @@
----
-aliases:
- - /zh/overview/what/ecosystem/transaction/seata/
-description: ""
-linkTitle: Seata
-title: Seata
-type: docs
-weight: 10
----
-
-
-
-## 案例
-
-用户采购商品业务,整个业务包含3个微服务:
-
-- 库存服务: 扣减给定商品的库存数量。
-- 订单服务: 根据采购请求生成订单。
-- 账户服务: 用户账户金额扣减。
-
-### 业务结构图
-
-
-
-
-### StorageService
-
-```java
-public interface StorageService {
- /**
- * 扣除存储数量
- */
- void deduct(String commodityCode, int count);
-}
-```
-
-### OrderService
-
-```java
-public interface OrderService {
- /**
- * 创建订单
- */
- Order create(String userId, String commodityCode, int orderCount);
-}
-```
-
-### AccountService
-
-```java
-public interface AccountService {
- /**
- * 从用户账户中借出
- */
- void debit(String userId, int money);
-}
-```
-
-### 主要的业务逻辑:
-
-```java
-public class BusinessServiceImpl implements BusinessService {
- private StorageService storageService;
- private OrderService orderService;
- /**
- * 采购
- */
- public void purchase(String userId, String commodityCode, int orderCount) {
- storageService.deduct(commodityCode, orderCount);
- orderService.create(userId, commodityCode, orderCount);
- }
-}
-```
-
-```java
-public class StorageServiceImpl implements StorageService {
- private StorageDAO storageDAO;
-
- @Override
- public void deduct(String commodityCode, int count) {
- Storage storage = new Storage();
- storage.setCount(count);
- storage.setCommodityCode(commodityCode);
- storageDAO.update(storage);
- }
-}
-```
-
-```java
-public class OrderServiceImpl implements OrderService {
- private OrderDAO orderDAO;
- private AccountService accountService;
- public Order create(String userId, String commodityCode, int orderCount) {
- int orderMoney = calculate(commodityCode, orderCount);
- accountService.debit(userId, orderMoney);
- Order order = new Order();
- order.userId = userId;
- order.commodityCode = commodityCode;
- order.count = orderCount;
- order.money = orderMoney;
- return orderDAO.insert(order);
- }
-}
-```
-
-## Seata 分布式事务解决方案
-
-
-
-此处仅仅需要一行注解 `@GlobalTransactional` 写在业务发起方的方法上:
-
-```java
- @GlobalTransactional
- public void purchase(String userId, String commodityCode, int orderCount) {
- ......
- }
-```
-
-## Dubbo 与 Seata 结合的例子
-
-### Step 1: 安装数据库
-
-- 要求: MySQL (InnoDB 存储引擎)。
-
-**提示:** 事实上例子中3个微服务需要3个独立的数据库,但为了方便我们使用同一物理库并配置3个逻辑连接串。
-
-更改以下xml文件中的数据库url、username和password
-
-dubbo-account-service.xml
-dubbo-order-service.xml
-dubbo-storage-service.xml
-
-```xml
- <property name="url" value="jdbc:mysql://x.x.x.x:3306/xxx" />
- <property name="username" value="xxx" />
- <property name="password" value="xxx" />
-```
-### Step 2: 为 Seata 创建 undo_log 表
-
-`UNDO_LOG` 此表用于 Seata 的AT模式。
-
-```sql
--- 注意当 Seata 版本升级至 0.3.0+ 将由之前的普通索引变更为唯一索引。
-CREATE TABLE `undo_log` (
- `id` bigint(20) NOT NULL AUTO_INCREMENT,
- `branch_id` bigint(20) NOT NULL,
- `xid` varchar(100) NOT NULL,
- `context` varchar(128) NOT NULL,
- `rollback_info` longblob NOT NULL,
- `log_status` int(11) NOT NULL,
- `log_created` datetime NOT NULL,
- `log_modified` datetime NOT NULL,
- `ext` varchar(100) DEFAULT NULL,
- PRIMARY KEY (`id`),
- UNIQUE KEY `ux_undo_log` (`xid`,`branch_id`)
-) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;
-```
-
-### Step 3: 创建相关业务表
-
-```sql
-DROP TABLE IF EXISTS `storage_tbl`;
-CREATE TABLE `storage_tbl` (
- `id` int(11) NOT NULL AUTO_INCREMENT,
- `commodity_code` varchar(255) DEFAULT NULL,
- `count` int(11) DEFAULT 0,
- PRIMARY KEY (`id`),
- UNIQUE KEY (`commodity_code`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8;
-DROP TABLE IF EXISTS `order_tbl`;
-CREATE TABLE `order_tbl` (
- `id` int(11) NOT NULL AUTO_INCREMENT,
- `user_id` varchar(255) DEFAULT NULL,
- `commodity_code` varchar(255) DEFAULT NULL,
- `count` int(11) DEFAULT 0,
- `money` int(11) DEFAULT 0,
- PRIMARY KEY (`id`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8;
-DROP TABLE IF EXISTS `account_tbl`;
-CREATE TABLE `account_tbl` (
- `id` int(11) NOT NULL AUTO_INCREMENT,
- `user_id` varchar(255) DEFAULT NULL,
- `money` int(11) DEFAULT 0,
- PRIMARY KEY (`id`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8;
-```
-### Step 4: 启动 Seata-Server 服务
-
-- 下载[服务器软件包](https://github.com/seata/seata/releases),将其解压缩。
-
-```shell
-Usage: sh seata-server.sh(for linux and mac) or cmd seata-server.bat(for windows) [options]
- Options:
- --host, -h
- The host to bind.
- Default: 0.0.0.0
- --port, -p
- The port to listen.
- Default: 8091
- --storeMode, -m
- log store mode : file、db
- Default: file
- --help
-e.g.
-sh seata-server.sh -p 8091 -h 127.0.0.1 -m file
-```
-
-### Step 5: 运行例子
-
-- 启动账户服务 ([DubboAccountServiceStarter](https://github.com/apache/dubbo-samples/blob/master/99-integration/dubbo-samples-transaction/src/main/java/org/apache/dubbo/samples/starter/DubboAccountServiceStarter.java)).
-- 启动库存服务 ([DubboStorageServiceStarter](https://github.com/apache/dubbo-samples/blob/master/99-integration/dubbo-samples-transaction/src/main/java/org/apache/dubbo/samples/starter/DubboStorageServiceStarter.java)).
-- 启动订单服务 ([DubboOrderServiceStarter](https://github.com/apache/dubbo-samples/blob/master/99-integration/dubbo-samples-transaction/src/main/java/org/apache/dubbo/samples/starter/DubboOrderServiceStarter.java)).
-- 运行BusinessService入口 ([DubboBusinessTester](https://github.com/apache/dubbo-samples/blob/master/99-integration/dubbo-samples-transaction/src/main/java/org/apache/dubbo/samples/starter/DubboBusinessTester.java)).
-
-### 相关项目
-* Seata: https://github.com/seata/seata
-* Seata Samples : https://github.com/seata/seata-samples
\ No newline at end of file
diff --git a/content/zh-cn/overview/what/overview.md b/content/zh-cn/overview/what/overview.md
index 861de7fd5e..15f5ace878 100644
--- a/content/zh-cn/overview/what/overview.md
+++ b/content/zh-cn/overview/what/overview.md
@@ -1,6 +1,9 @@
---
aliases:
- /zh/overview/what/overview/
+ - /zh/docs3-v2/java-sdk/concepts-and-architecture/overall-architecture/
+ - /zh-cn/docs3-v2/java-sdk/concepts-and-architecture/overall-architecture/
+ - /zh-cn/overview/mannual/java-sdk/concepts-and-architecture/overall-architecture/
description: ""
linkTitle: 概念与架构
title: 了解 Dubbo 核心概念和架构
diff --git a/data/i18n/en/en.toml b/data/i18n/en/en.toml
index da6256d324..8f6a8a466e 100755
--- a/data/i18n/en/en.toml
+++ b/data/i18n/en/en.toml
@@ -193,6 +193,9 @@ other = "Options"
[outdated_blog__message]
other = "This article is more than one year old. Older articles may contain outdated content. Check that the information in the page has not become incorrect since its publication."
+[working_in_progress_message]
+other = "Attention: The feature described in this doc is still under development or is in a very early stage, please keep updated!"
+
[post_create_issue]
other = "Create an issue"
diff --git a/data/i18n/zh-cn/zh.toml b/data/i18n/zh-cn/zh.toml
index 26e8a5e208..a698afc176 100755
--- a/data/i18n/zh-cn/zh.toml
+++ b/data/i18n/zh-cn/zh.toml
@@ -201,6 +201,9 @@ other = "选项"
[outdated_blog__message]
other = "该文章内容发布已经超过一年,请注意检查文章中内容是否过时"
+[working_in_progress_message]
+other = "注意:此文档描述的内容正在建设中或处于功能早期阶段,请持续关注文档更新!"
+
[outdated_blog__title]
other = "过时的文章"
diff --git a/i18n/en.toml b/i18n/en.toml
index 5b7d507e0e..666b6f2eec 100755
--- a/i18n/en.toml
+++ b/i18n/en.toml
@@ -192,6 +192,9 @@ other = "Options"
[outdated_blog__message]
other = "This article is more than one year old. Older articles may contain outdated content. Check that the information in the page has not become incorrect since its publication."
+[working_in_progress_message]
+other = "Attention: The feature described in this doc is still under development or is in a very early stage, please keep updated!"
+
[post_create_issue]
other = "Create an issue"
diff --git a/i18n/zh-cn.toml b/i18n/zh-cn.toml
index b0265191f2..82fc597c73 100755
--- a/i18n/zh-cn.toml
+++ b/i18n/zh-cn.toml
@@ -201,6 +201,9 @@ other = "选项"
[outdated_blog__message]
other = "该文章内容发布已经超过一年,请注意检查文章中内容是否过时。"
+[working_in_progress_message]
+other = "注意:此文档描述的内容正在建设中或处于功能早期阶段,请持续关注文档更新!"
+
[outdated_blog__title]
other = "过时的文章"
diff --git a/layouts/blog/baseof.html b/layouts/blog/baseof.html
index 11c8255dd6..296c02e1a4 100755
--- a/layouts/blog/baseof.html
+++ b/layouts/blog/baseof.html
@@ -8,11 +8,11 @@
{{ partial "navbar.html" . }}
{{ partial "announcement.html" . }}
{{ block "hero" . }}
-<!-- <section class="header-hero text-white pb-4 light-text ">-->
+ <section class="header-hero text-white pb-0 light-text ">
<!-- {{ if not .Params.notitle }}-->
<!-- <h1>{{ .Title }}</h1>-->
<!-- {{ end }}-->
-<!-- </section>-->
+ </section>
{{ block "hero-more" . }}{{ end }}
{{ end }}
</header>
diff --git a/layouts/docs/baseof.html b/layouts/docs/baseof.html
index 170aa25aa4..e2cbe533b7 100755
--- a/layouts/docs/baseof.html
+++ b/layouts/docs/baseof.html
@@ -8,11 +8,11 @@
{{ partial "navbar.html" . }}
{{ partial "announcement.html" . }}
{{ block "hero" . }}
-<!-- <section class="header-hero text-white pb-4 light-text ">-->
-<!-- {{ if not .Params.notitle }}-->
-<!-- <h1>{{ .Title }}</h1>-->
-<!-- {{ end }}-->
-<!-- </section>-->
+ <section class="header-hero text-white pb-0 light-text ">
+ <!-- {{ if not .Params.notitle }}-->
+ <!-- <h1>{{ .Title }}</h1>-->
+ <!-- {{ end }}-->
+ </section>
{{ block "hero-more" . }}{{ end }}
{{ end }}
</header>
@@ -26,6 +26,9 @@
{{ if not .Site.Params.ui.breadcrumb_disable }}{{ partial "breadcrumb.html" . }}{{ end }}
{{ block "deprecated" . }}
{{ partial "deprecation-warning.html" . }}
+ {{ end }}
+ {{ block "workingInProgress" . }}
+ {{ partial "working_in_progress.html" . }}
{{ end }}
{{ block "main" . }}{{ end }}
{{- if .HasShortcode "thirdparty-content" -}}
diff --git a/layouts/partials/working_in_progress.html b/layouts/partials/working_in_progress.html
new file mode 100644
index 0000000000..2a090fcf82
--- /dev/null
+++ b/layouts/partials/working_in_progress.html
@@ -0,0 +1,7 @@
+{{ if (.Page.Params.working_in_progress) }}
+<section id="deprecation-warning">
+ <div class="content deprecation-warning pageinfo outdated-blog">
+ <p>{{ T "working_in_progress_message" }}</p>
+ </div>
+</section>
+{{ end }}
\ No newline at end of file
diff --git a/static/imgs/blog/2023/2/introduction/1-overview.png b/static/imgs/blog/2023/2/introduction/1-overview.png
deleted file mode 100644
index f60b0845bb..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/1-overview.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/10-mesh.png b/static/imgs/blog/2023/2/introduction/10-mesh.png
deleted file mode 100644
index 0bf011f440..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/10-mesh.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/11-initializer.png b/static/imgs/blog/2023/2/introduction/11-initializer.png
index 285be67448..2c9a165c7a 100644
Binary files a/static/imgs/blog/2023/2/introduction/11-initializer.png and b/static/imgs/blog/2023/2/introduction/11-initializer.png differ
diff --git a/static/imgs/blog/2023/2/introduction/12-interface.png b/static/imgs/blog/2023/2/introduction/12-interface.png
deleted file mode 100644
index 83f31f1492..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/12-interface.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/13-impl.png b/static/imgs/blog/2023/2/introduction/13-impl.png
deleted file mode 100644
index 6ef6bf37b3..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/13-impl.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/14-reference.png b/static/imgs/blog/2023/2/introduction/14-reference.png
deleted file mode 100644
index 05dfdeaeef..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/14-reference.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/15-deploy.png b/static/imgs/blog/2023/2/introduction/15-deploy.png
deleted file mode 100644
index 652bcf4919..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/15-deploy.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/16-admin.png b/static/imgs/blog/2023/2/introduction/16-admin.png
deleted file mode 100644
index 103e158c3b..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/16-admin.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/17-grafana1.jpg b/static/imgs/blog/2023/2/introduction/17-grafana1.jpg
deleted file mode 100644
index 7fae235d37..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/17-grafana1.jpg and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/17-grafana1.png b/static/imgs/blog/2023/2/introduction/17-grafana1.png
index 12a849fcdf..9833d1fff4 100644
Binary files a/static/imgs/blog/2023/2/introduction/17-grafana1.png and b/static/imgs/blog/2023/2/introduction/17-grafana1.png differ
diff --git a/static/imgs/blog/2023/2/introduction/18-grafana2.jpg b/static/imgs/blog/2023/2/introduction/18-grafana2.jpg
deleted file mode 100644
index d834523641..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/18-grafana2.jpg and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/18-grafana2.png b/static/imgs/blog/2023/2/introduction/18-grafana2.png
deleted file mode 100644
index f1b481ecb0..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/18-grafana2.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/19-gray.png b/static/imgs/blog/2023/2/introduction/19-gray.png
deleted file mode 100644
index fdb95b929b..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/19-gray.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/2-arc.png b/static/imgs/blog/2023/2/introduction/2-arc.png
deleted file mode 100644
index 852f37791d..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/2-arc.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/20-region.png b/static/imgs/blog/2023/2/introduction/20-region.png
deleted file mode 100644
index 2ba72f8e9f..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/20-region.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/21-region.png b/static/imgs/blog/2023/2/introduction/21-region.png
deleted file mode 100644
index e92480964e..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/21-region.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/3-usecase.png b/static/imgs/blog/2023/2/introduction/3-usecase.png
deleted file mode 100644
index 629b08c7f6..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/3-usecase.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/4-usecase-alibaba.png b/static/imgs/blog/2023/2/introduction/4-usecase-alibaba.png
deleted file mode 100644
index afbe0370e5..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/4-usecase-alibaba.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/5-framework.png b/static/imgs/blog/2023/2/introduction/5-framework.png
deleted file mode 100644
index 414a988898..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/5-framework.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/6-extensibility.png b/static/imgs/blog/2023/2/introduction/6-extensibility.png
deleted file mode 100644
index 97ea459b64..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/6-extensibility.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/7-protocol.png b/static/imgs/blog/2023/2/introduction/7-protocol.png
deleted file mode 100644
index 9439a72ba7..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/7-protocol.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/8-extensibility.png b/static/imgs/blog/2023/2/introduction/8-extensibility.png
deleted file mode 100644
index e035e220a3..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/8-extensibility.png and /dev/null differ
diff --git a/static/imgs/blog/2023/2/introduction/9-ecosystem.png b/static/imgs/blog/2023/2/introduction/9-ecosystem.png
deleted file mode 100644
index 174c329eee..0000000000
Binary files a/static/imgs/blog/2023/2/introduction/9-ecosystem.png and /dev/null differ
diff --git a/static/imgs/docs3-v2/java-sdk/observability/micrometer-bridge.png b/static/imgs/docs3-v2/java-sdk/observability/micrometer-bridge.png
new file mode 100644
index 0000000000..77a95babaa
Binary files /dev/null and b/static/imgs/docs3-v2/java-sdk/observability/micrometer-bridge.png differ
diff --git a/static/imgs/v3/advantages/initializer.png b/static/imgs/v3/advantages/initializer.png
index ec10cfcf26..2c9a165c7a 100644
Binary files a/static/imgs/v3/advantages/initializer.png and b/static/imgs/v3/advantages/initializer.png differ
diff --git a/static/imgs/v3/feature/circuit-breaking/consumer-circuit-breaking.png b/static/imgs/v3/feature/circuit-breaking/consumer-circuit-breaking.png
new file mode 100644
index 0000000000..ec2cd066f7
Binary files /dev/null and b/static/imgs/v3/feature/circuit-breaking/consumer-circuit-breaking.png differ
diff --git a/static/imgs/v3/feature/circuit-breaking/provider-rate-limit.png b/static/imgs/v3/feature/circuit-breaking/provider-rate-limit.png
new file mode 100644
index 0000000000..232660749b
Binary files /dev/null and b/static/imgs/v3/feature/circuit-breaking/provider-rate-limit.png differ
diff --git a/static/imgs/v3/feature/observability/provider-rt.png b/static/imgs/v3/feature/observability/provider-rt.png
deleted file mode 100644
index 38758d37e1..0000000000
Binary files a/static/imgs/v3/feature/observability/provider-rt.png and /dev/null differ
diff --git a/static/imgs/v3/feature/observability/provider-stat.png b/static/imgs/v3/feature/observability/provider-stat.png
index 7cd701b6a2..9833d1fff4 100644
Binary files a/static/imgs/v3/feature/observability/provider-stat.png and b/static/imgs/v3/feature/observability/provider-stat.png differ
diff --git a/static/imgs/v3/performance/rpc-dubbo.png b/static/imgs/v3/performance/rpc-dubbo.png
new file mode 100644
index 0000000000..a7e9c4e6eb
Binary files /dev/null and b/static/imgs/v3/performance/rpc-dubbo.png differ
diff --git a/static/imgs/v3/performance/rpc-triple.png b/static/imgs/v3/performance/rpc-triple.png
new file mode 100644
index 0000000000..a8581f48b6
Binary files /dev/null and b/static/imgs/v3/performance/rpc-triple.png differ
diff --git a/static/imgs/v3/tasks/develop/initializer-choose-version.png b/static/imgs/v3/tasks/develop/initializer-choose-version.png
new file mode 100644
index 0000000000..022b7e4fa6
Binary files /dev/null and b/static/imgs/v3/tasks/develop/initializer-choose-version.png differ
diff --git a/static/imgs/v3/tasks/develop/initializer-dependencies.png b/static/imgs/v3/tasks/develop/initializer-dependencies.png
new file mode 100644
index 0000000000..1d938f8382
Binary files /dev/null and b/static/imgs/v3/tasks/develop/initializer-dependencies.png differ
diff --git a/static/imgs/v3/tasks/develop/initializer-preview.png b/static/imgs/v3/tasks/develop/initializer-preview.png
new file mode 100644
index 0000000000..2f3a5933dc
Binary files /dev/null and b/static/imgs/v3/tasks/develop/initializer-preview.png differ
diff --git a/static/imgs/v3/tasks/develop/initializer-project-architecture.png b/static/imgs/v3/tasks/develop/initializer-project-architecture.png
new file mode 100644
index 0000000000..1225d5a31c
Binary files /dev/null and b/static/imgs/v3/tasks/develop/initializer-project-architecture.png differ
diff --git a/static/imgs/v3/tasks/develop/initializer-project-info.png b/static/imgs/v3/tasks/develop/initializer-project-info.png
new file mode 100644
index 0000000000..32e0c65499
Binary files /dev/null and b/static/imgs/v3/tasks/develop/initializer-project-info.png differ
diff --git a/static/js/script.js b/static/js/script.js
index 840d76f83b..9d4ca70414 100755
--- a/static/js/script.js
+++ b/static/js/script.js
@@ -478,9 +478,9 @@ var pushmenu = (function(){
$(function() {
// If vendor strip doesn't exist add className
- if ( !$('#vendorStrip').length > 0 ) {
- $('.header-hero').addClass('bot-bar');
- }
+ // if ( !$('#vendorStrip').length > 0 ) {
+ // $('.header-hero').addClass('bot-bar');
+ // }
// If is not homepage add class to hero section
if (!$('.td-home').length > 0 ) {