@@ -50,9 +40,9 @@ weight: 6
-
演示如何在一个应用内发布多个使用不同协议的服务，并通过唯一的一个端口对外发布。
+
演示 Dubbo 如何简化 gRPC 服务开发。
diff --git a/content/zh-cn/overview/tasks/protocols/dubbo.md b/content/zh-cn/overview/tasks/protocols/dubbo.md
deleted file mode 100644
index 539f63c38998..000000000000
--- a/content/zh-cn/overview/tasks/protocols/dubbo.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-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 a7eb9a05ec6c..7ff276266479 100644
--- a/content/zh-cn/overview/tasks/protocols/grpc.md
+++ b/content/zh-cn/overview/tasks/protocols/grpc.md
@@ -1,11 +1,53 @@
---
aliases:
- /zh/overview/tasks/protocols/grpc/
-description: "使用 Dubbo 开发 gRPC 服务"
-linkTitle: 开发 gRPC 服务
+description: "使用 Dubbo 开发与 gRPC 互通的服务"
+linkTitle: 开发gRPC兼容的服务
title: 使用 Dubbo 开发 gRPC 服务
type: docs
weight: 1
---
-文档编写中...
\ No newline at end of file
+这个示例演示了如何使用 Triple 协议实现 Dubbo 服务与标准 gRPC 服务的互相调用。
+> 本示例用 Java 语言编写。对于 Go、Node.js、Rust 等其他 Dubbo 语言实现，同样具备与 gRPC 协议互通的能力，具体请参见相应 sdk 文档。
+
+其他相关示例：
+* [基于 IDL 的 Triple 协议编码方式](../triple/)
+* [无 IDL 的 Triple 协议编码方式](/zh-cn/overview/quickstart/rpc/java/)
+
+
+
+就像在 [Triple协议规范](https://dubbo.apache.org/zh-cn/overview/reference/protocols/triple/) 中所描述的，Triple 协议与 gRPC 协议保持 100% 兼容，同时在易用性方面有了非常大的提升（比如支持 cURL、浏览器直接访问等），可以说 Triple 是一个更好用的 gRPC 设计与实现。
+
+## 作为标准的 gRPC Server
+在这一部分，我们会发布一个 Dubbo Triple Server，然后启动一个标准的 gRPC 消费端（采用 grpc-java 编码）来调用 Triple 服务。示例源码在 [dubbo-samples-triple-grpc](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-triple-grpc)，请下载源码并依照以下命令体验。
+
+### 启动 Dubbo server
+Make sure you are in `dubbo-samples-triple-grpc` directory and then run the following command:
+
+```shell
+$ mvn compile exec:java -Dexec.mainClass="org.apache.dubbo.samples.tri.grpc.interop.server.TriOpServer"
+```
+
+### 使用标准 gRPC client 调用 Triple 服务
+Open a new terminal, enter `dubbo-samples-triple-grpc` directory and then run the following command:
+
+```shell
+$ mvn compile exec:java -Dexec.mainClass="org.apache.dubbo.samples.tri.grpc.interop.server.GrpcClient"
+```
+
+## 调用标准的 gRPC Server
+This part showcases how Triple client written with Dubbo consumes gRPC service written with standard gRPC-java.
+
+### 启动标准 gRPC server
+```shell
+$ mvn compile exec:java -Dexec.mainClass="org.apache.dubbo.samples.tri.grpc.interop.client.GrpcServer"
+```
+
+### 使用 Dubbo client 调用标准 gRPC 服务
+```shell
+$ mvn compile exec:java -Dexec.mainClass="org.apache.dubbo.samples.tri.grpc.interop.client.TriOpClient"
+```
+
+
+
diff --git a/content/zh-cn/overview/tasks/protocols/multi-protocols.md b/content/zh-cn/overview/tasks/protocols/multi-protocols.md
deleted file mode 100644
index f8257244ea6d..000000000000
--- a/content/zh-cn/overview/tasks/protocols/multi-protocols.md
+++ /dev/null
@@ -1,132 +0,0 @@
----
-aliases:
- - /zh/overview/tasks/protocols/multi-protocols/
-description: ""
-linkTitle: 单端口多协议
-title: 发布使用不同协议的多个服务，通过单端口监听
-type: docs
-weight: 4
----
-
-
-
-## 特性说明
-通过对protocol进行配置，dubbo3可以支持端口的协议复用。
-比如使用Triple协议启动端口复用后，可以在相同的端口上为服务增加
-Dubbo协议支持，以及Qos协议支持。这些协议的识别都是由一个统一的端口复用
-服务器进行处理的，可以用于服务的协议迁移，并且可以节约端口以及相关的资源，减少运维的复杂性。
-
-
-
-- 在服务的创建阶段，通过从Config层获取到服务导出的协议配置从而创建不同的Protocol对象进行导出。在导出的过程
-中，如果不是第一次创建端口复用的Server，那么Exchanger会将Protcol层传递的数据保存到Server，用于后续处理该协议类型的消息。
-
-- 当客户端的消息传递过来后，首先会通过Server传递给ProtocolDetector，如果完成了识别，那么就会标记该客户端为对应的协议。并通过WireProtocol配置对应的处理逻辑，最后交给ChannelOperator完成底层的IO框架和对应的Dubbo框架的处理逻辑的绑定。
-
-- 以上的协议识别完成之后，Channel已经确定了如何处理远程的客户端消息，通过对应的ServerPipeline进行处理即可（在处理的过程中也会根据配置信息决定消息的处理线程）。
-
-## 使用方式
-在同一主机上部署多个服务或需要通过负载均衡器访问多个服务。
-
-## 参考用例
-[https://github.com/apache/dubbo-samples/tree/master/dubbo-samples-port-unification](https://github.com/apache/dubbo-samples/tree/master/3-extensions/protocol/dubbo-samples-port-unification)
-
-
-## 配置方式
-
-关于Dubbo支持的配置方式，可以参考[配置说明](/zh-cn/overview/mannual/java-sdk/reference-manual/config/)
-
-### 服务多协议导出
-
-ext-protocol参数支持配置多个不同的协议，协议之间通过","进行分隔。
-
-#### xml 配置
-
-```xml
-
-
-
-
-
-
-```
-
-#### API 配置
-
-```java
-ProtocolConfig config = new ProtocolConfig(CommonConstants.TRIPLE, -1);
-
-config.setExtProtocol(CommonConstants.DUBBO+",");
-```
-
-#### yaml 配置
-
-``` yaml
-dubbo:
- application:
- name: dubbo-springboot-demo-provider
- protocol:
- name: tri
- port: -1
- ext-protocol: dubbo,
-```
-
-#### properties 配置
-```properties
-dubbo.protocol.name=tri
-dubbo.protocol.ext-protocol=dubbo,
-dubbo.protocol.port=20880
-```
-
-### Qos接入
-
-#### Qos模块导入
-
-```xml
-
- org.apache.dubbo
- dubbo-qos
-
-```
-
-完成Qos模块的导入之后，相关的配置项可参考[Qos操作手册](/zh-cn/overview/mannual/java-sdk/reference-manual/qos/overview/)进行配置。
-
-默认情况下，基于端口复用的Qos服务在模块导入后是启动的。
-
-## 使用方式
-
-### Qos使用
-
-将Qos协议接入到端口复用的场景下，需要在建立连接之后，客户端先向服务端发送消息，对比将Qos协议通过单个端口提供服务，端口复用版的Qos协议在处理telnet连接的情况下需要用户执行一些操作，完成协议识别（二选一）。
-
-1. 直接调用命令
-
- 直接调用telnet支持的命令也可以完成识别，在用户不熟悉的情况下可以调用help指令完成识别
-
- 
-
-2. 发送telnet命令识别
-
- 通过telnet命令建立连接之后，执行以下几个步骤：
-
- 1. 使用 crtl + "]" 进入到telnet交互界面(telnet默认的escape character)
- 2. 调用 "send ayt" 向服务端发送特殊识别字段(为telnet协议的一个特殊字段)
- 3. 回车完成消息发送并进入到dubbo的交互界面
-
- 
-
-
-### 服务引用
-
-以[dubbo-samples-port-unification](https://github.com/apache/dubbo-samples/tree/master/3-extensions/protocol/dubbo-samples-port-unification)中的例子作为基础, 引用不同协议的服务和非端口复用情况下的配置是一致的，下面通过Consumer端的InvokerListener输出调用过程中的URL信息。
-
-```java
-ReferenceConfig
reference = new ReferenceConfig<>();
-reference.setInterface(GreetingService.class);
-reference.setListener("consumer");
-reference.setProtocol(this.protocol);
-// reference.setProtocol(CommonConstants.DUBBO);
-// reference.setProtocol(CommonConstants.TRIPLE);
-```
-
-
diff --git a/content/zh-cn/overview/tasks/protocols/springcloud.md b/content/zh-cn/overview/tasks/protocols/springcloud.md
index 50c39d526cea..3be50c7e75bd 100644
--- a/content/zh-cn/overview/tasks/protocols/springcloud.md
+++ b/content/zh-cn/overview/tasks/protocols/springcloud.md
@@ -2,11 +2,205 @@
aliases:
- /zh/overview/tasks/protocols/springcloud/
description: ""
-linkTitle: 调用 Spring Cloud
+linkTitle: 调用Spring Cloud服务
title: 使用 Dubbo 作为消费端调用 Spring Cloud 服务
type: docs
weight: 3
---
+> 本示例仅支持 Dubbo 3.3.0 及以上版本！
+本示例使用 Nacos 作为注册中心，演示如何实现 Dubbo 与 Spring Cloud 体系的自动地址发现与服务调用。在注册中心方面，你也可以选用 Zookeeper、Consul 等两种体系都支持的注册中心。
-最新版本的 Dubbo3、Spring Cloud 体系互通方案已经设计完成，相关示例文档将在随后发布。
+
+
+借助 Dubbo3 内置的 rest 编程范式支持，可以做到基本不改动任何代码的情况下实现 Dubbo 与 Spring Cloud 体系的互相调用。
+* 关于这一部分的使用场景及理论阐述请参见这里的[博客文章](https://dubbo.apache.org/zh-cn/blog/2023/01/05/dubbo-%E8%BF%9E%E6%8E%A5%E5%BC%82%E6%9E%84%E5%BE%AE%E6%9C%8D%E5%8A%A1%E4%BD%93%E7%B3%BB-%E5%A4%9A%E5%8D%8F%E8%AE%AE%E5%A4%9A%E6%B3%A8%E5%86%8C%E4%B8%AD%E5%BF%83/)。
+* 关于 Dubbo rest 的更多配置方式请参见[rest 使用参考手册](/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/rest/)
+
+## Dubbo 调用 Spring Cloud
+设想你已经有一套 Spring Cloud 的微服务体系，现在我们将引入 Dubbo 框架，让 Dubbo 应用能够正常的调用到 Spring Cloud 发布的服务。本示例的相关源码在[samples/dubbo-call-sc](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-springcloud/dubbo-call-sc)。
+
+### 启动 Spring Cloud Server
+示例中 Spring Cloud 应用的结构如下
+
+
+
+应用配置文件如下：
+```yaml
+server:
+ port: 8099
+spring:
+ application:
+ name: spring-cloud-provider-for-dubbo
+ cloud:
+ nacos:
+ serverAddr: 127.0.0.1:8848 #注册中心
+```
+
+以下是一个非常简单的 Controller 定义
+
+```java
+@RestController
+@RequestMapping("/users")
+public class UserController {
+ @GetMapping("/list")
+ public List getUser() {
+ return Collections.singletonList(new User(1L, "spring cloud server"));
+ }
+}
+```
+
+启动 `SpringCloudApplication`，通过 `http://localhost:8099/users/list` 可以测试应用启动成功。
+
+### 使用 Dubbo Client 调用服务
+Dubbo client 也是一个标准的 Dubbo 应用，项目基本结构如下：
+
+
+
+其中，一个比较关键的是如下接口定义，正常情况下，以下接口可以直接从原有的 Spring Cloud client 应用中原样拷贝过来即可，无需做任何修改。
+> 如果之前没有基于 OpenFeign 的 Spring Cloud 消费端应用，那么就需要自行定义一个接口，使用 Spring MVC 标准注解即可。
+
+```java
+@FeignClient(name = "spring-cloud-provider-for-dubbo")
+public interface UserServiceFeign {
+ @RequestMapping(value="/users/list", method = RequestMethod.GET, produces = "application/json")
+ List users();
+}
+```
+
+通过 `DubboReference` 注解将 UserServiceFeign 注册为 Dubbo 服务
+
+```java
+@DubboReference
+private UserServiceFeign userService;
+```
+
+接下来，我们就可以对服务发起调用了
+
+```java
+List users = userService.users();
+```
+
+通过 `DubboConsumerApplication` 启动 Dubbo 应用，验证可以成功调用到 Spring Cloud 服务。
+
+## Spring Cloud 调用 Dubbo
+在接下来的示例中，我们将展示如何将 Dubbo server 发布的服务开放给 Spring Cloud client 调用。示例的相关源码在[samples/sc-call-dubbo](https://github.com/apache/dubbo-samples/tree/master/2-advanced/dubbo-samples-springcloud/sc-call-dubbo)
+
+### 启动 Dubbo Server
+Dubbo server 应用的代码结构非常简单，是一个典型的 Dubbo 应用。
+
+
+
+相比于普通的 Dubbo 服务定义，我们要在接口上加上如下标准 Spring MVC 注解：
+
+```java
+@RestController
+@RequestMapping("/users")
+public interface UserService {
+ @GetMapping(value = "/list")
+ List getUsers();
+}
+```
+
+除了以上注解之外，其他服务发布等流程都一致，使用 `DubboService` 注解发布服务即可：
+
+```java
+@DubboService
+public class UserServiceImpl implements UserService {
+ @Override
+ public List getUsers() {
+ return Collections.singletonList(new User(1L, "Dubbo provider!"));
+ }
+}
+```
+
+在服务配置上，特别注意我们需要将服务的协议配置为 rest `protocol: rest`，地址发现模式使用 `register-mode: instance`：
+
+```yaml
+dubbo:
+ registry:
+ address: nacos://127.0.0.1:8848
+ register-mode: instance
+ protocol:
+ name: rest
+ port: 8090
+```
+
+启动 Dubbo 应用，此时访问以下地址可以验证服务运行正常：`http://localhost:8090/users/list`
+
+### 使用 Spring Cloud 调用 Dubbo
+使用 OpenFeign 开发一个标准的 Spring Cloud 应用，即可调用以上发布的 Dubbo 服务，项目代码结构如下：
+
+
+
+其中，我们定义了一个 OpenFeign 接口，用于调用上面发布的 Dubbo rest 服务。
+```java
+@FeignClient(name = "dubbo-provider-for-spring-cloud")
+public interface UserServiceFeign {
+ @RequestMapping(value = "/users/list", method = RequestMethod.GET)
+ List getUsers();
+}
+```
+
+定义以下 controller 作为 OpenFeign 和 RestTemplate 测试入口。
+
+```java
+public class UserController {
+
+ private final RestTemplate restTemplate;
+ private final UserServiceFeign userServiceFeign;
+
+ public UserController(RestTemplate restTemplate,
+ UserServiceFeign userServiceFeign) {
+ this.restTemplate = restTemplate;
+ this.userServiceFeign = userServiceFeign;
+ }
+
+ @RequestMapping("/rest/test1")
+ public String doRestAliveUsingEurekaAndRibbon() {
+ String url = "http://dubbo-provider-for-spring-cloud/users/list";
+ System.out.println("url: " + url);
+ return restTemplate.getForObject(url, String.class);
+ }
+
+ @RequestMapping("/rest/test2")
+ public List doRestAliveUsingFeign() {
+ return userServiceFeign.getUsers();
+ }
+}
+```
+
+可以分别访问以下地址进行验证：
+* OpenFeign 方式：`http://localhost:8099/dubbo/rest/test1`、
+* RestTemplage 方式：`http://localhost:8099/dubbo/rest/test1`
+
+### 为 Dubbo Server 发布更多的服务
+我们可以利用 Dubbo 的多协议发布机制，为一些服务配置多协议发布。接下来，我们就为上面提到的 Dubbo server 服务增加 triple 协议发布，从而达到以下部署效果，让这个 Dubbo 应用同时服务 Dubbo 微服务体系和 Spring Cloud 微服务体系。
+
+
+
+为了实现这个效果，我们只需要在配置中增加多协议配置即可：
+```yaml
+dubbo:
+ protocols:
+ - id: rest
+ name: rest
+ port: 8090
+ - id: dubbo
+ name: dubbo
+ port: 50051
+```
+
+服务注解中配置为多协议发布
+
+```java
+@DubboService(protocol="rest,dubbo")
+public class UserServiceImpl implements UserService {}
+```
+
+这样，我们就成功的将 UserService 服务以 dubbo 和 rest 两种协议发布了出去（多端口多协议的方式），dubbo 协议为 Dubbo 体系服务，rest 协议为 Spring Cloud 体系服务。
+
+> **注意：**Dubbo 为多协议发布提供了单端口、多端口两种方式，这样的灵活性对于不同部署环境下的服务会有比较大的帮助。在确定您需要的多协议发布方式前，请提仔细阅读以下 [多协议配置](/zh-cn/overview/mannual/java-sdk/advanced-features-and-usage/service/multi-protocols) 文档。
+
+## 总结
+基于 Dubbo 的 rest 编程范式、多协议发布等特性，可以帮助你轻松的实现从 Dubbo 到 Spring Cloud 或者从 Spring Cloud 到 Dubbo 的平滑迁移（无改造成本），同时也可以实现 Dubbo 与 Spring Cloud 两套体系的共存。
diff --git a/content/zh-cn/overview/tasks/protocols/triple.md b/content/zh-cn/overview/tasks/protocols/triple.md
index 84f49fdf76e3..26ea53ebb0d6 100644
--- a/content/zh-cn/overview/tasks/protocols/triple.md
+++ b/content/zh-cn/overview/tasks/protocols/triple.md
@@ -1,9 +1,261 @@
---
description: "使用 Dubbo 开发 Triple 协议通信服务"
-linkTitle: 开发 Triple 服务
+linkTitle: 使用IDL开发Triple服务
title: 使用 Dubbo 开发 Triple 协议通信服务
type: docs
weight: 1
---
-文档编写中...
+本示例演示如何使用 Protocol Buffers 定义服务，并将其发布为对外可调用的 Triple 协议服务。示例采用 Java 语言编写，其他语言的 Triple 协议方式请参考快速开始部分，更多详细说明可参考多语言sdk。
+
+* 考虑到对过往版本的兼容性，Dubbo 当前的各个发行版本均默认使用 `dubbo` 通信协议（基于 TCP 的高性能私有协议），老用户请参考文档了解[如何实现协议的平滑迁移](/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/triple/migration)。对于没有特殊诉求的新用户，建议在一开始就通过配置开启 `triple` 协议。
+* 更多 Triple 协议使用请参见
+ * [流式通信 Streaming RPCs](/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/triple/streaming)
+ * [实现与标准 gRPC 协议互调](../grpc)
+ * [基于 Java Interface 的开发模式(无 IDL 模式)](/zh-cn/overview/mannual/java-sdk/reference-manual/protocol/triple/pojo)
+ * [如何在其他语言和浏览器上使用 Triple 协议](/zh-cn/overview/quickstart/rpc)
+
+
+## 运行示例
+可在此查看[本示例的完整代码](https://github.com/apache/dubbo-samples/tree/master/1-basic/dubbo-samples-triple-unary)。
+
+首先可通过以下命令下载示例源码
+```shell
+git clone https://github.com/apache/dubbo-samples.git
+```
+
+编译项目，由 IDL 生成代码
+```shell
+cd dubbo-samples/1-basic/dubbo-samples-triple-unary
+mvn clean compile
+```
+
+### 启动 Server
+运行以下命令启动 server。
+```shell
+mvn compile exec:java -Dexec.mainClass="org.apache.dubbo.samples.tri.unary.TriUnaryServer"
+```
+
+### 访问服务
+有两种方式可以访问 Triple 服务：
+* 以标准 HTTP 工具访问
+* 以 Dubbo client sdk 访问
+
+#### cURL 访问
+
+```shell
+curl \
+ --header "Content-Type: application/json" \
+ --data '[{"name": "Dubbo"}]' \
+ http://localhost:50052/org.apache.dubbo.samples.tri.unary.Greeter/greet/
+```
+
+#### Dubbo client 访问
+运行以下命令，启动 Dubbo client 并完成服务调用
+```shell
+mvn compile exec:java -Dexec.mainClass="org.apache.dubbo.samples.tri.unary.TriUnaryClient"
+```
+
+## 示例讲解
+可在此查看 [完整示例代码](https://github.com/apache/dubbo-samples/tree/master/1-basic/dubbo-samples-triple-unary)。
+
+### 项目依赖
+由于使用 IDL 开发模式，因此要添加 dubbo、protobuf-java 等依赖，同时还要配置 protobuf-maven-plugin 等插件，用于生成桩代码。
+
+```xml
+
+
+
+ org.apache.dubbo
+ dubbo
+ ${dubbo.version}
+
+
+ com.google.protobuf
+ protobuf-java
+ 3.19.6
+
+
+ org.apache.dubbo
+ dubbo-dependencies-zookeeper-curator5
+ ${dubbo.version}
+ pom
+
+
+
+
+
+
+ kr.motd.maven
+ os-maven-plugin
+ 1.6.1
+
+
+
+
+ org.xolstice.maven.plugins
+ protobuf-maven-plugin
+ 0.6.1
+
+ com.google.protobuf:protoc:${protoc.version}:exe:${os.detected.classifier}
+
+
+ dubbo
+ org.apache.dubbo
+ dubbo-compiler
+ ${dubbo.version}
+ org.apache.dubbo.gen.tri.Dubbo3TripleGenerator
+
+
+
+
+
+
+ compile
+
+
+
+
+
+ org.apache.maven.plugins
+ maven-compiler-plugin
+ ${maven-compiler-plugin.version}
+
+ ${source.level}
+ ${target.level}
+
+
+
+ org.codehaus.mojo
+ build-helper-maven-plugin
+ 3.3.0
+
+
+ generate-sources
+
+ add-source
+
+
+
+ target/generated-sources/protobuf/java
+
+
+
+
+
+
+
+
+```
+
+### 服务定义
+使用 Protocol Buffers 定义服务
+
+```protobuf
+syntax = "proto3";
+
+option java_multiple_files = true;
+
+package org.apache.dubbo.samples.tri.unary;
+
+message GreeterRequest {
+ string name = 1;
+}
+
+message GreeterReply {
+ string message = 1;
+}
+
+service Greeter{
+ rpc greet(GreeterRequest) returns (GreeterReply);
+}
+```
+
+### 代码生成
+执行 `mvn clean compile` 后，生成代码如下
+
+```text
+└── org
+ └── apache
+ └── dubbo
+ └── samples
+ └── tri
+ └── unary
+ ├── DubboGreeterTriple.java
+ ├── Greeter.java
+ ├── GreeterOuterClass.java
+ ├── GreeterReply.java
+ ├── GreeterReplyOrBuilder.java
+ ├── GreeterRequest.java
+ └── GreeterRequestOrBuilder.java
+```
+
+### 服务实现
+继承生成的基础类 `DubboGreeterTriple.GreeterImplBase`，以下具体的业务逻辑实现。
+
+```java
+public class GreeterImpl extends DubboGreeterTriple.GreeterImplBase {
+ @Override
+ public GreeterReply greet(GreeterRequest request) {
+ LOGGER.info("Server {} received greet request {}", serverName, request);
+ return GreeterReply.newBuilder()
+ .setMessage("hello," + request.getName())
+ .build();
+ }
+}
+```
+
+注册服务到 server，其中 protocol 设置为 tri 代表开启 triple 协议。
+
+```java
+public class TriUnaryServer {
+ public static void main(String[] args) throws IOException {
+ new EmbeddedZooKeeper(TriSampleConstants.ZK_PORT, false).start();
+ ServiceConfig service = new ServiceConfig<>();
+ service.setInterface(Greeter.class);
+ service.setRef(new GreeterImpl("tri-stub"));
+ ApplicationConfig applicationConfig = new ApplicationConfig("tri-stub-server");
+ applicationConfig.setQosEnable(false);
+ DubboBootstrap bootstrap = DubboBootstrap.getInstance();
+ bootstrap.application(applicationConfig)
+ .registry(new RegistryConfig(TriSampleConstants.ZK_ADDRESS))
+ .protocol(new ProtocolConfig(CommonConstants.TRIPLE, TriSampleConstants.SERVER_PORT))
+ .service(service)
+ .start();
+ System.out.println("Dubbo triple unary server started, port=" + TriSampleConstants.SERVER_PORT);
+ }
+}
+```
+
+### 编写 client 逻辑
+```java
+public class TriUnaryClient {
+ private static final Logger LOGGER = LoggerFactory.getLogger(TriUnaryClient.class);
+
+ public static void main(String[] args) throws IOException {
+ DubboBootstrap bootstrap = DubboBootstrap.getInstance();
+ ReferenceConfig ref = new ReferenceConfig<>();
+ ref.setInterface(Greeter.class);
+ ref.setProtocol(CommonConstants.TRIPLE);
+ ref.setProxy(CommonConstants.NATIVE_STUB);
+ ref.setTimeout(3000);
+
+ ApplicationConfig applicationConfig = new ApplicationConfig("tri-stub-consumer");
+ applicationConfig.setQosEnable(false);
+ bootstrap.application(applicationConfig).reference(ref).registry(new RegistryConfig(TriSampleConstants.ZK_ADDRESS)).start();
+ Greeter greeter = ref.get();
+
+ //sync
+ unarySync(greeter);
+ }
+
+ private static void unarySync(Greeter greeter) {
+ LOGGER.info("{} Start unary", "tri-unary-client");
+ final GreeterReply reply = greeter.greet(GreeterRequest.newBuilder().setName("name").build());
+ LOGGER.info("{} Unary reply <-{}", "tri-unary-client", reply);
+ }
+}
+```
+
+
+
diff --git a/content/zh-cn/overview/tasks/protocols/web.md b/content/zh-cn/overview/tasks/protocols/web.md
deleted file mode 100644
index 955210fc7020..000000000000
--- a/content/zh-cn/overview/tasks/protocols/web.md
+++ /dev/null
@@ -1,50 +0,0 @@
----
-aliases:
- - /zh/overview/tasks/protocols/web/
-description: ""
-linkTitle: 开发 Web 应用
-title: 使用 Dubbo 开发 Web 应用
-type: docs
-weight: 2
----
-
-文档编写中...
-
-Dubbo3 HTTP 协议支持仍在建设中，目前最新的 3.3 开发分支已经有初版原型供体验。正式的生产可用版本预计会在 3.4/3.4 的某个正式版本发布。
-
-以下是 Dubbo3 HTTP 协议与编程模式计划支持的几种业务场景：
-* 调用 http 协议的微服务体系
-* 发布 http 协议的服务
-* 多协议发布，一个服务同时发布 http&dubbo 协议
-
-## 调用 http 协议的微服务体系
-一个典型的应用场景是 Dubbo 调用 Spring Cloud 开发的微服务体系。
-
-不同体系的互通，最关键的两点便是地址格式与编码协议的兼容，只要 Dubbo 能自动发现 SpringCloud 体系的地址并能基于 HTTP 协议进行通信即可。Dubbo3 可以做到：
-* 支持 SpringCloud 体系的服务发现地址格式
-* 支持 HTTP+JSON 的数据传输格式
-
-
-
-基于以上分析，当我们需要调用 Spring Cloud 体系的服务时，只需要在 Dubbo 侧编写标准的 Dubbo Reference 服务引用就可以。同时，为了简化开发工作，**Dubbo 支持标准的 Spring Web 注解**，因此，如果你可以直接在 Dubbo 中复用 Spring Cloud 中的接口定义：
-
-Spring Cloud 侧的服务定义：
-```java
-interface SpringCloudRestService {
- //xxx
-}
-```
-
-在 Dubbo 侧唯一要做的工作就是定义 Dubbo Reference：
-
-```java
-@DubboReference
-private SpringCloudRestService restService;
-```
-
-## 发布 http 协议的服务
-
-
-## 多协议发布
-
-
diff --git a/content/zh-cn/overview/tasks/traffic-management/_index.md b/content/zh-cn/overview/tasks/traffic-management/_index.md
index 4c82de14e9ed..8ed4c8bd336f 100755
--- a/content/zh-cn/overview/tasks/traffic-management/_index.md
+++ b/content/zh-cn/overview/tasks/traffic-management/_index.md
@@ -9,8 +9,6 @@ type: docs
weight: 3
---
-
-
此任务基于一个简单的线上商城微服务系统演示了 Dubbo 的流量管控能力。
线上商城的架构图如下：
diff --git a/content/zh-cn/overview/what/_index.md b/content/zh-cn/overview/what/_index.md
index bc462548b785..6555d8619e85 100644
--- a/content/zh-cn/overview/what/_index.md
+++ b/content/zh-cn/overview/what/_index.md
@@ -1,7 +1,7 @@
---
aliases:
- /zh/overview/what/
-description: ""
+description: "Apache Dubbo 是一款 RPC 服务开发框架，用于解决微服务架构下的服务治理与通信问题，官方提供了 Java、Golang 等多语言 SDK 实现。使用 Dubbo 开发的微服务原生具备相互之间的远程地址发现与通信能力，利用 Dubbo 提供的丰富服务治理特性，可以实现诸如服务发现、负载均衡、流量调度等服务治理诉求。Dubbo 被设计为高度可扩展，用户可以方便的实现流量拦截、选址的各种定制逻辑。"
hide_summary: true
linkTitle: 介绍
no_list: true
diff --git a/content/zh-cn/overview/what/advantages/governance.md b/content/zh-cn/overview/what/advantages/governance.md
index 7f7a2d6d17bc..3cef3bbb36c1 100644
--- a/content/zh-cn/overview/what/advantages/governance.md
+++ b/content/zh-cn/overview/what/advantages/governance.md
@@ -1,7 +1,7 @@
---
aliases:
- /zh/overview/what/advantages/governance/
-description: 服务治理
+description: "在地址发现和负载均衡机制之外，Dubbo 丰富的流量管控规则可以控制服务间的流量走向和 API 调用，基于这些规则可以实现在运行期动态的调整服务行为如超时时间、重试次数、限流参数等，通过控制流量分布可以实现 A/B 测试、金丝雀发布、多版本按比例流量分配、条件匹配路由、黑白名单等，提高系统稳定性。"
linkTitle: 服务治理
title: 服务治理
type: docs
diff --git a/content/zh-cn/overview/what/advantages/performance.md b/content/zh-cn/overview/what/advantages/performance.md
index 0066495d2edd..56833878abde 100644
--- a/content/zh-cn/overview/what/advantages/performance.md
+++ b/content/zh-cn/overview/what/advantages/performance.md
@@ -1,7 +1,7 @@
---
aliases:
- /zh/overview/what/advantages/performance/
-description: 超高性能
+description: "Dubbo 被设计用于解决阿里巴巴超大规模的电商微服务集群实践，并在各个行业头部企业经过多年的十万、百万规模的微服务实践检验，因此，Dubbo 在通信性能、稳定性方面具有无可比拟的优势，非常适合构建近乎无限水平伸缩的微服务集群，这也是 Dubbo 从实践层面优于业界很多同类的产品的巨大优势。"
linkTitle: 超高性能
title: 超高性能
type: docs
diff --git a/content/zh-cn/overview/what/advantages/production-ready.md b/content/zh-cn/overview/what/advantages/production-ready.md
index 7cab89010be0..f20c37066320 100644
--- a/content/zh-cn/overview/what/advantages/production-ready.md
+++ b/content/zh-cn/overview/what/advantages/production-ready.md
@@ -1,7 +1,7 @@
---
aliases:
- /zh/overview/what/advantages/production-ready/
-description: 生产环境验证
+description: "Apache Dubbo 是一款有着数以万计企业用户的国际化开源项目，经过了多年大规模集群生产环境的检验，影响了数百万开发者，带动了大量微服务开源生态发展。Dubbo 从企业实践中孵化并走向开源，又迅速在开源社区获得了成功，大量的生产实践用户是 Dubbo 长期保持先进性、稳定性和活跃度的核心驱动力。"
linkTitle: 生产环境验证
title: 生产环境验证
type: docs
diff --git a/content/zh-cn/overview/what/advantages/usability.md b/content/zh-cn/overview/what/advantages/usability.md
index 822400230ad5..5fdcae53e9aa 100644
--- a/content/zh-cn/overview/what/advantages/usability.md
+++ b/content/zh-cn/overview/what/advantages/usability.md
@@ -1,7 +1,7 @@
---
aliases:
- /zh/overview/what/advantages/usability/
-description: 快速易用
+description: "无论你是计划采用微服务架构开发一套全新的业务系统，还是准备将已有业务从单体架构迁移到微服务架构，Dubbo 框架都可以帮助到你。Dubbo 让微服务开发变得非常容易，它允许你选择多种编程语言、使用任意通信协议，并且它还提供了一系列针对微服务场景的开发、测试工具帮助提升研发效率"
linkTitle: 快速易用
title: 快速易用
type: docs
diff --git a/content/zh-cn/overview/what/xyz-difference.md b/content/zh-cn/overview/what/advantages/xyz-difference.md
similarity index 95%
rename from content/zh-cn/overview/what/xyz-difference.md
rename to content/zh-cn/overview/what/advantages/xyz-difference.md
index 1e12b8f08439..a5653f286205 100644
--- a/content/zh-cn/overview/what/xyz-difference.md
+++ b/content/zh-cn/overview/what/advantages/xyz-difference.md
@@ -1,11 +1,12 @@
---
aliases:
- /zh/overview/what/xyz-difference/
-description: ""
+ - /zh-cn/overview/what/xyz-difference/
+description: "很多开发者经常会问到 Apache Dubbo 与 Spring Cloud、gRPC 以及一些 Service Mesh 项目如 Istio 的关系，要解释清楚它们的关系并不困难，你只需要跟随这篇文章和 Dubbo 文档做一些更深入的了解，但总的来说，它们之间有些能力是重合的，但在一些场景你可以把它们放在一起使用。"
linkTitle: 与 gRPC、Spring Cloud、Istio 关系
title: 与 gRPC、Spring Cloud、Istio 的关系
type: docs
-weight: 2
+weight: 5
---
diff --git a/content/zh-cn/overview/core-features/_index.md b/content/zh-cn/overview/what/core-features/_index.md
similarity index 80%
rename from content/zh-cn/overview/core-features/_index.md
rename to content/zh-cn/overview/what/core-features/_index.md
index 04b79971c1ae..39fca832de3b 100755
--- a/content/zh-cn/overview/core-features/_index.md
+++ b/content/zh-cn/overview/what/core-features/_index.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/
+ - /zh-cn/overview/core-features/
description: Dubbo 核心特性
linkTitle: 功能
title: Dubbo 核心特性
diff --git a/content/zh-cn/overview/core-features/ecosystem.md b/content/zh-cn/overview/what/core-features/ecosystem.md
similarity index 96%
rename from content/zh-cn/overview/core-features/ecosystem.md
rename to content/zh-cn/overview/what/core-features/ecosystem.md
index bbc0e7f8dbd7..644925a864b4 100644
--- a/content/zh-cn/overview/core-features/ecosystem.md
+++ b/content/zh-cn/overview/what/core-features/ecosystem.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh-cn/overview/what/ecosystem/
+ - /zh-cn/overview/core-features/ecosystem/
description: 微服务生态
feature:
description: |
@@ -14,7 +15,7 @@ weight: 10
Dubbo 社区和众多优秀的开源项目一起围绕 Dubbo 建立了丰富的微服务生态支持，这让开发者从选型 Dubbo 作为开发框架的第一天，就无需担心后续的服务治理诉求，Dubbo 对每一个常见问题均提供了生产级的解决方案。
-以下表格为基于最新 Dubbo Java 3.2.x 版本统计的生态组件支持情况，后续将根据开发进展持续更新。同时每个语言支持的组件完善度会有一定差异，具体请参见各个 [语言参考手册](../../mannual/) 内的详细说明
+以下表格为基于最新 Dubbo Java 3.2.x 版本统计的生态组件支持情况，后续将根据开发进展持续更新。同时每个语言支持的组件完善度会有一定差异，具体请参见各个 [语言参考手册](/zh-cn/overview/mannual/) 内的详细说明
| 功能 | 组件列表 | 组件列表 | 组件列表 | 组件列表 | 组件列表 |
| --- | --- | --- | --- | --- | --- |
diff --git a/content/zh-cn/overview/core-features/extensibility.md b/content/zh-cn/overview/what/core-features/extensibility.md
similarity index 99%
rename from content/zh-cn/overview/core-features/extensibility.md
rename to content/zh-cn/overview/what/core-features/extensibility.md
index dd13e4cda213..38c1b3b9a5aa 100644
--- a/content/zh-cn/overview/core-features/extensibility.md
+++ b/content/zh-cn/overview/what/core-features/extensibility.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/extensibility/
+ - /zh-cn/overview/core-features/extensibility/
description: 扩展适配
feature:
description: |
diff --git a/content/zh-cn/overview/core-features/load-balance.md b/content/zh-cn/overview/what/core-features/load-balance.md
similarity index 99%
rename from content/zh-cn/overview/core-features/load-balance.md
rename to content/zh-cn/overview/what/core-features/load-balance.md
index 5392d2eb5aa8..fb888d68931c 100644
--- a/content/zh-cn/overview/core-features/load-balance.md
+++ b/content/zh-cn/overview/what/core-features/load-balance.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/load-balance/
+ - /zh-cn/overview/core-features/load-balance/
description: 负载均衡
linkTitle: 负载均衡
title: 负载均衡
diff --git a/content/zh-cn/overview/core-features/more.md b/content/zh-cn/overview/what/core-features/more.md
similarity index 97%
rename from content/zh-cn/overview/core-features/more.md
rename to content/zh-cn/overview/what/core-features/more.md
index b1bb6cfc01fa..17f44509b4e3 100644
--- a/content/zh-cn/overview/core-features/more.md
+++ b/content/zh-cn/overview/what/core-features/more.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/more/
+ - /zh-cn/overview/core-features/more/
description: 高级功能指南
linkTitle: 更多高级功能
title: 更多高级功能
diff --git a/content/zh-cn/overview/core-features/observability.md b/content/zh-cn/overview/what/core-features/observability.md
similarity index 98%
rename from content/zh-cn/overview/core-features/observability.md
rename to content/zh-cn/overview/what/core-features/observability.md
index c61cfe430ca9..230bae6d754e 100644
--- a/content/zh-cn/overview/core-features/observability.md
+++ b/content/zh-cn/overview/what/core-features/observability.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/observability/
+ - /zh-cn/overview/core-features/observability/
description: 观测服务
feature:
description: |
diff --git a/content/zh-cn/overview/core-features/protocols.md b/content/zh-cn/overview/what/core-features/protocols.md
similarity index 99%
rename from content/zh-cn/overview/core-features/protocols.md
rename to content/zh-cn/overview/what/core-features/protocols.md
index 9ea8d86242f6..169e6215f4e8 100644
--- a/content/zh-cn/overview/core-features/protocols.md
+++ b/content/zh-cn/overview/what/core-features/protocols.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/protocols/
+ - /zh-cn/overview/core-features/protocols/
description: 通信协议
feature:
description: |
diff --git a/content/zh-cn/overview/core-features/security.md b/content/zh-cn/overview/what/core-features/security.md
similarity index 99%
rename from content/zh-cn/overview/core-features/security.md
rename to content/zh-cn/overview/what/core-features/security.md
index dbc8052372e9..cc133bf260de 100644
--- a/content/zh-cn/overview/core-features/security.md
+++ b/content/zh-cn/overview/what/core-features/security.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/security/
+ - /zh-cn/overview/core-features/security/
description: 认证鉴权
feature:
description: |
diff --git a/content/zh-cn/overview/what/core-features/service-definition.md b/content/zh-cn/overview/what/core-features/service-definition.md
new file mode 100644
index 000000000000..3ae68b82438b
--- /dev/null
+++ b/content/zh-cn/overview/what/core-features/service-definition.md
@@ -0,0 +1,44 @@
+---
+aliases:
+ - /zh/overview/core-features/service-definition/
+ - /zh-cn/overview/core-features/service-definition/
+description: 微服务开发
+linkTitle: 微服务开发
+title: 微服务开发
+type: docs
+weight: 1
+---
+
+## 使用在线脚手架创建项目
+
+对于 Java 体系的微服务开发，Dubbo 提供了项目脚手架来方便项目开发。开发者可以使用脚手架在 1 分钟内创建一个基于 Dubbo Spring Boot Starter 的项目。
+
+脚手架支持 在线 web 页面 和 IntelliJ IDEA 插件 两种形式。
+
+1. 在线 web 页面
+
+ 
+
+2. IntelliJ IDEA 官方插件
+
+ 
+
+关于脚手架的具体操作讲解，请参见 [使用脚手架快速创建模板项目](/zh-cn/overview/tasks/develop/template/)。
+
+## 使用 dubboctl 命令行创建项目
+
+你也可以使用 dubboctl 来加速项目开发，dubboctl 支持 java、go、node.js、web、rust 等多种语言类型的项目模板创建。
+
+1. 首先，使用以下命令下载并安装 `dubboctl` 工具。
+
+ ```shell
+
+ ````
+
+2. 执行以下命令即可快速创建项目
+
+ ```shell
+ dubboctl create -l go hello
+ ```
+
+关于 dubboctl 的更多使用方式，请参考 [dubboctl 说明文档]()。
diff --git a/content/zh-cn/overview/core-features/service-discovery.md b/content/zh-cn/overview/what/core-features/service-discovery.md
similarity index 99%
rename from content/zh-cn/overview/core-features/service-discovery.md
rename to content/zh-cn/overview/what/core-features/service-discovery.md
index a5f904a24f91..1771284ad6d8 100644
--- a/content/zh-cn/overview/core-features/service-discovery.md
+++ b/content/zh-cn/overview/what/core-features/service-discovery.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/service-discovery/
+ - /zh-cn/overview/core-features/service-discovery/
- /zh-cn/overview/mannual/java-sdk/concepts-and-architecture/service-discovery/
description: 服务发现
feature:
diff --git a/content/zh-cn/overview/core-features/service-mesh.md b/content/zh-cn/overview/what/core-features/service-mesh.md
similarity index 99%
rename from content/zh-cn/overview/core-features/service-mesh.md
rename to content/zh-cn/overview/what/core-features/service-mesh.md
index d92e94b4a1e7..dc7323023f9c 100644
--- a/content/zh-cn/overview/core-features/service-mesh.md
+++ b/content/zh-cn/overview/what/core-features/service-mesh.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/service-mesh/
+ - /zh-cn/overview/core-features/service-mesh/
- /zh-cn/overview/mannual/java-sdk/concepts-and-architecture/mesh/
description: 服务网格
feature:
diff --git a/content/zh-cn/overview/core-features/traffic/_index.md b/content/zh-cn/overview/what/core-features/traffic/_index.md
similarity index 99%
rename from content/zh-cn/overview/core-features/traffic/_index.md
rename to content/zh-cn/overview/what/core-features/traffic/_index.md
index 9a35369dd502..5f8e84925c9d 100755
--- a/content/zh-cn/overview/core-features/traffic/_index.md
+++ b/content/zh-cn/overview/what/core-features/traffic/_index.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/traffic/
+ - /zh-cn/overview/core-features/traffic/
description: 流量管控
feature:
description: |
diff --git a/content/zh-cn/overview/core-features/traffic/circuit-breaking.md b/content/zh-cn/overview/what/core-features/traffic/circuit-breaking.md
similarity index 98%
rename from content/zh-cn/overview/core-features/traffic/circuit-breaking.md
rename to content/zh-cn/overview/what/core-features/traffic/circuit-breaking.md
index 4b1444cd9955..f5a2ba37971d 100644
--- a/content/zh-cn/overview/core-features/traffic/circuit-breaking.md
+++ b/content/zh-cn/overview/what/core-features/traffic/circuit-breaking.md
@@ -1,4 +1,6 @@
---
+aliases:
+ - /zh-cn/overview/core-features/traffic/circuit-breaking/
description: ""
linkTitle: 限流 & 熔断
title: 限流 & 熔断
diff --git a/content/zh-cn/overview/core-features/traffic/condition-rule.md b/content/zh-cn/overview/what/core-features/traffic/condition-rule.md
similarity index 99%
rename from content/zh-cn/overview/core-features/traffic/condition-rule.md
rename to content/zh-cn/overview/what/core-features/traffic/condition-rule.md
index 618f0c09b4b5..8856c1c892fa 100644
--- a/content/zh-cn/overview/core-features/traffic/condition-rule.md
+++ b/content/zh-cn/overview/what/core-features/traffic/condition-rule.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/traffic/condition-rule/
+ - /zh-cn/overview/core-features/traffic/condition-rule/
description: ""
linkTitle: 条件路由
title: 条件路由规则
diff --git a/content/zh-cn/overview/core-features/traffic/configuration-rule.md b/content/zh-cn/overview/what/core-features/traffic/configuration-rule.md
similarity index 98%
rename from content/zh-cn/overview/core-features/traffic/configuration-rule.md
rename to content/zh-cn/overview/what/core-features/traffic/configuration-rule.md
index dd58e2911b5a..0eec2d23e523 100644
--- a/content/zh-cn/overview/core-features/traffic/configuration-rule.md
+++ b/content/zh-cn/overview/what/core-features/traffic/configuration-rule.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/traffic/configuration-rule/
+ - /zh-cn/overview/core-features/traffic/configuration-rule/
description: ""
linkTitle: 动态配置
title: 动态配置规则
diff --git a/content/zh-cn/overview/core-features/traffic/mesh-rule.md.bak b/content/zh-cn/overview/what/core-features/traffic/mesh-rule.md.bak
similarity index 100%
rename from content/zh-cn/overview/core-features/traffic/mesh-rule.md.bak
rename to content/zh-cn/overview/what/core-features/traffic/mesh-rule.md.bak
diff --git a/content/zh-cn/overview/core-features/traffic/script-rule.md b/content/zh-cn/overview/what/core-features/traffic/script-rule.md
similarity index 97%
rename from content/zh-cn/overview/core-features/traffic/script-rule.md
rename to content/zh-cn/overview/what/core-features/traffic/script-rule.md
index 63c43b48ccf7..96cf57f40340 100644
--- a/content/zh-cn/overview/core-features/traffic/script-rule.md
+++ b/content/zh-cn/overview/what/core-features/traffic/script-rule.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/traffic/script-rule/
+ - /zh-cn/overview/core-features/traffic/script-rule/
description: ""
linkTitle: 脚本路由
title: 脚本路由规则
diff --git a/content/zh-cn/overview/core-features/traffic/tag-rule.md b/content/zh-cn/overview/what/core-features/traffic/tag-rule.md
similarity index 98%
rename from content/zh-cn/overview/core-features/traffic/tag-rule.md
rename to content/zh-cn/overview/what/core-features/traffic/tag-rule.md
index 8d36a5fbaf59..6e382f401106 100644
--- a/content/zh-cn/overview/core-features/traffic/tag-rule.md
+++ b/content/zh-cn/overview/what/core-features/traffic/tag-rule.md
@@ -1,6 +1,7 @@
---
aliases:
- /zh/overview/core-features/traffic/tag-rule/
+ - /zh-cn/overview/core-features/traffic/tag-rule/
description: ""
linkTitle: 标签路由
title: 标签路由规则
diff --git a/content/zh-cn/overview/what/overview.md b/content/zh-cn/overview/what/overview.md
index 15f5ace8782d..10227fe28090 100644
--- a/content/zh-cn/overview/what/overview.md
+++ b/content/zh-cn/overview/what/overview.md
@@ -4,7 +4,7 @@ aliases:
- /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: ""
+description: "本文介绍了 Dubbo 的基本工作原理，涵盖了服务治理控制面、数据面、通信协议、服务发现、服务治理能力、流量管控等"
linkTitle: 概念与架构
title: 了解 Dubbo 核心概念和架构
type: docs
diff --git a/data/download/zh/1javaReleases.yaml b/data/download/zh/1javaReleases.yaml
index b9930691236f..e54de0c5bf95 100644
--- a/data/download/zh/1javaReleases.yaml
+++ b/data/download/zh/1javaReleases.yaml
@@ -1,7 +1,8 @@
title: Java SDK Releases
type: java
-extra_message:
-extra_link:
+extra_message: >
+ 社区共发布有三个主要版本：3.x、2.7.x 和 2.6.x及以下。其中, 3.x 版本是当前社区长期稳定维护版本，2.7.x 目前处于维护状态只会进行 bugfix，而 2.6.x 及以下版本已经进入 EOL 并停止维护。由于 2.7.x 与 3.x 在设计上完全兼容，我们建议这部分用户直接升级到 3.x 的最新稳定版本；2.6.x 及以下是 Dubbo 捐献 Apache 之前的版本，因此升级 3.x 过程中要注意包名等潜在兼容性问题检查。
+extra_link: "https://dubbo.apache.org/zh-cn/overview/mannual/java-sdk/upgrades-and-compatibility/"
list:
- name: 3.2.4
description: >
@@ -17,3 +18,11 @@ list:
archive: https://www.apache.org/dyn/closer.lua/dubbo/3.1.11/apache-dubbo-3.1.11-src.zip
hash: https://www.apache.org/dyn/closer.lua/dubbo/3.1.11/apache-dubbo-3.1.11-src.zip.sha512
signature: https://www.apache.org/dyn/closer.lua/dubbo/3.1.11/apache-dubbo-3.1.11-src.zip.asc
+ - name: 2.7.21
+ description: >
+ 2.7.x 最新 bugfix 版本，短期计划停留在 2.7 版本的用户请直接升级到该版本。
+ changelog: https://github.com/apache/dubbo/releases/tag/dubbo-2.7.21
+ archive: https://www.apache.org/dyn/closer.lua/dubbo/2.7.21/apache-dubbo-2.7.21-src.zip
+ hash: https://www.apache.org/dyn/closer.lua/dubbo/2.7.21/apache-dubbo-2.7.21-src.zip.sha512
+ signature: https://www.apache.org/dyn/closer.lua/dubbo/2.7.21/apache-dubbo-2.7.21-src.zip.asc
+
diff --git a/layouts/partials/navbar-version-selector.html b/layouts/partials/navbar-version-selector.html
index 48424056950f..8dbca27a24b4 100755
--- a/layouts/partials/navbar-version-selector.html
+++ b/layouts/partials/navbar-version-selector.html
@@ -3,7 +3,7 @@
+
diff --git a/content/zh-cn/overview/quickstart/go/install.md b/content/zh-cn/overview/quickstart/go/install.md
deleted file mode 100644
index 9bc307968d50..000000000000
--- a/content/zh-cn/overview/quickstart/go/install.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-aliases:
- - /zh/overview/quickstart/go/install/
-description: 1 - 安装 Dubbo-go 开发环境
-title: 安装 Dubbo-go 开发环境
-type: docs
-weight: 1
----
-
-
-### 1. 安装Go语言环境
-
-> go version >= go 1.15。建议使用最新版 go 1.19
-
-[【Go 语言官网下载地址】](https://golang.google.cn/)
-
-安装成功后将 `$GOPATH/bin` 加入环境变量
-
-### 2. 安装序列化工具protoc
-
-[【protoc 下载地址】](https://github.com/protocolbuffers/protobuf/releases)
-
-### 3. 安装 dubbogo-cli 以及相关插件
-
-执行以下指令安装dubbogo-cli 至 `$GOPATH/bin`
-
-```bash
-$ export GOPROXY="https://goproxy.cn"
-$ go install github.com/dubbogo/dubbogo-cli@latest
-$ dubbogo-cli
-hello
-```
-
-安装依赖的工具插件
-
-```bash
-$ dubbogo-cli install all
-```
-
-确保上述安装的工具位于在系统环境变量内
-
-```bash
-$ protoc --version
-libprotoc 3.14.0
-$ protoc-gen-go --version
-protoc-gen-go v1.26.0
-$ protoc-gen-go-triple --version
-protoc-gen-go-triple 1.0.8
-```
\ No newline at end of file
diff --git a/content/zh-cn/overview/quickstart/go/quickstart_triple.md b/content/zh-cn/overview/quickstart/go/quickstart_triple.md
deleted file mode 100644
index 57371295c7c8..000000000000
--- a/content/zh-cn/overview/quickstart/go/quickstart_triple.md
+++ /dev/null
@@ -1,124 +0,0 @@
----
-aliases:
- - /zh/overview/quickstart/go/quickstart_triple/
-description: 2 - 完成一次 RPC 调用
-title: 完成一次 RPC 调用
-type: docs
-weight: 2
----
-
-
-
-
-## 1. 生成 Demo 项目
-
-使用安装好的 dubbogo-cli 工具，创建demo工程。
-
-```bash
-$ mkdir quickstart
-$ cd quickstart
-$ dubbogo-cli newDemo .
-$ tree .
-.
-├── api
-│ ├── samples_api.pb.go
-│ ├── samples_api.proto
-│ └── samples_api_triple.pb.go
-├── go-client
-│ ├── cmd
-│ │ └── client.go
-│ └── conf
-│ └── dubbogo.yaml
-├── go-server
-│ ├── cmd
-│ │ └── server.go
-│ └── conf
-│ └── dubbogo.yaml
-└── go.mod
-```
-
-可看到生成的项目中包含一个 client 项目和一个 server 项目，以及相关的配置文件。
-
-### 1.1 查看接口描述文件 helloworld.proto
-
-```protobuf
-syntax = "proto3";
-package api;
-
-option go_package = "./;api";
-
-// The greeting service definition.
-service Greeter {
- // Sends a greeting
- rpc SayHello (HelloRequest) returns (User) {}
- // Sends a greeting via stream
- rpc SayHelloStream (stream HelloRequest) returns (stream User) {}
-}
-
-// The request message containing the user's name.
-message HelloRequest {
- string name = 1;
-}
-
-// The response message containing the greetings
-message User {
- string name = 1;
- string id = 2;
- int32 age = 3;
-}
-```
-
-demo项目中，默认生成了一个接口描述文件，接口服务名为 api.Greeter, 包含两个 RPC 方法，入参为 HelloRequest，返回值为 User，两个方法分别为普通 RPC 方法和 Streaming 类型 RPC 方法。
-
-### 1.2 (*可选) 使用安装好的编译工具编译 pb 接口
-
-```bash
-$ cd api
-$ protoc --go_out=. --go-triple_out=. ./samples_api.proto
-```
-
-参数意义：`--go_out=.` 使用上述安装的 `protoc-gen-go` 插件，生成文件到当前目录，`--go-triple_out=.`使用上述安装的 `protoc-gen-go-triple` 插件，生成文件到当前目录。
-
-执行该指令后，会生成两个文件，分别是helloworld.pb (包含 proto 结构) 和 helloworld_triple.pb.go (包含 triple 协议接口)。
-
-在 demo 工程中，预先生成好了这两个文件，修改 .proto 文件后重新执行命令生成，即可覆盖。
-
-## 2. 开启一次RPC调用
-
-项目根目录执行
-
-```
-$ go mod tidy
-```
-
-拉取到最新的框架依赖：
-
-```go
-module helloworld
-
-go 1.17
-
-require (
- dubbo.apache.org/dubbo-go/v3 v3.0.1
- github.com/dubbogo/grpc-go v1.42.9
- github.com/dubbogo/triple v1.1.8
- google.golang.org/protobuf v1.27.1
-)
-
-require (
- ...
-)
-
-```
-
-先后启动服务端和客户端: 开启两个终端，在 go-server/cmd 和 go-client/cmd 文件夹下分别执行 `go run .` , 可在客户端看到输出：
-
-```shell
-client response result: name:"Hello laurence" id:"12345" age:21
-```
-
-获得调用结果成功
-
-## 3. 更多
-
-细心的读者可以发现，以上例子编写的的服务端可以接受来自客户端的普通RPC、流式RPC调用请求。目前只编写了普通调用的Client，读者可以根据 samples 库中的例子来尝试编写流式客户端和服务端。
\ No newline at end of file
diff --git a/content/zh-cn/overview/quickstart/go/quickstart_triple_with_customize.md b/content/zh-cn/overview/quickstart/go/quickstart_triple_with_customize.md
deleted file mode 100644
index e0dea332f874..000000000000
--- a/content/zh-cn/overview/quickstart/go/quickstart_triple_with_customize.md
+++ /dev/null
@@ -1,212 +0,0 @@
----
-aliases:
- - /zh/overview/quickstart/go/quickstart_triple_with_customize/
-description: 3 - 完成一次 RPC 调用自己定义接口的版本
-title: 完成一次自己定义接口的 RPC 调用
-type: docs
-weight: 3
----
-
-
-
-## 1.概述
-我们本章来实现一个简单的小需求，实现一个分布式ID生成服务，通过该服务可以获取分布式ID
-（假设的分布式ID，我们不探讨ID的生成方案和算法，这里直接使用uuid代替，只为演示自定义服务的创建）
-
-## 2. 服务端实现
-首先使用 dubbogo-cli 创建 IDC 服务
-```bash
-dubbogo-cli newApp IDC
-cd IDC
-tree .
-
-.
-├── Makefile
-├── api
-│ ├── api.pb.go
-│ ├── api.proto
-│ └── api_triple.pb.go
-├── build
-│ └── Dockerfile
-├── chart
-│ ├── app
-│ │ ├── Chart.yaml
-│ │ ├── templates
-│ │ │ ├── _helpers.tpl
-│ │ │ ├── deployment.yaml
-│ │ │ ├── service.yaml
-│ │ │ └── serviceaccount.yaml
-│ │ └── values.yaml
-│ └── nacos_env
-│ ├── Chart.yaml
-│ ├── templates
-│ │ ├── _helpers.tpl
-│ │ ├── deployment.yaml
-│ │ └── service.yaml
-│ └── values.yaml
-├── cmd
-│ └── app.go
-├── conf
-│ └── dubbogo.yaml
-├── go.mod
-├── go.sum
-└── pkg
- └── service
- └── service.go
-
-```
-
-我们编辑proto定义我们的接口
-
-```protobuf
-syntax = "proto3";
-package api;
-
-option go_package = "./;api";
-
-service Generator {
- rpc GetID (GenReq) returns (GenResp) {}
-}
-
-message GenReq {
- string appId = 1;
-}
-
-message GenResp {
- string id = 1;
-}
-```
-
-生成代码
-
-```bash
-$ cd api
-$ protoc --go_out=. --go-triple_out=. ./api.proto
-```
-
-我们来调整service
-目录：pkg/service/service.go
-修改后的代码如下
-
-```go
-type GeneratorServerImpl struct {
- api.UnimplementedGeneratorServer
-}
-
-func (s *GeneratorServerImpl) GetID(ctx context.Context, in *api.GenReq) (*api.GenResp, error) {
- logger.Infof("Dubbo-go GeneratorProvider AppId = %s\n", in.AppId)
- uuid, err := uuid.NewV4()
- if err != nil {
- logger.Infof("Dubbo-go GeneratorProvider get id err = %v\n", err)
- return nil, err
- }
- return &api.GenResp{Id: uuid.String()}, nil
-}
-
-func init() {
- config.SetProviderService(&GeneratorServerImpl{})
-}
-```
-同时，我们调整conf/dubbogo.yaml中的provider部分，
-```yaml
-dubbo:
- registries:
- nacos:
- protocol: nacos
- address: 127.0.0.1:8848
- protocols:
- triple:
- name: tri
- port: 20000
- provider:
- services:
- GeneratorServerImpl:
- interface: "" # read from stub
-```
-我们需要拉起一个依赖的注册中心，nacos，如果你有现成的，本步骤可以忽略，我们使用docker来快速启动一个nacos，
-
-```bash
-git clone https://github.com/nacos-group/nacos-docker.git
-cd nacos-docker
-docker-compose -f example/standalone-derby.yaml up
-```
-
-最后，我们启动服务端。
-```go
-export DUBBO_GO_CONFIG_PATH=conf/dubbogo.yaml
-go run cmd/app.go
-```
-打开nacos的控制台，可以看到服务已经注册
-
-
-
-## 2. 客户端使用
-首先，我们可以共享我们的服务端的api给客户端，并生成相关的代码（这里可以根据实际项目需要，共享共享proto，每个consumer自行生成代码，或统一生成sdk后给依赖的服务引入）
-客户端目录如下：
-```bash
-.
-├── api
-│ ├── api.pb.go
-│ ├── api.proto
-│ └── api_triple.pb.go
-├── cmd
-│ └── client.go
-├── conf
-│ └── dubbogo.yml
-├── go.mod
-├── go.sum
-
-```
-api目录同服务端的api目录
-client.go 代码如下
-```go
-
-var grpcGeneratorImpl = new(api.GeneratorClientImpl)
-
-func main() {
- config.SetConsumerService(grpcGeneratorImpl)
- if err := config.Load(); err != nil {
- panic(err)
- }
-
- logger.Info("start to test dubbo")
- req := &api.GenReq{
- AppId: "laurence",
- }
- reply, err := grpcGeneratorImpl.GetID(context.Background(), req)
- if err != nil {
- logger.Error(err)
- }
- logger.Infof("get id result: %v\n", reply.Id)
-}
-
-```
-
-dubbogo.yml 如下
-```yaml
-dubbo:
- registries:
- nacos:
- protocol: nacos
- address: 127.0.0.1:8848
- consumer:
- references:
- GeneratorClientImpl:
- protocol: tri
- interface: ""
-```
-
-运行client，获取id，如下：
-
-```bash
-export DUBBO_GO_CONFIG_PATH=conf/dubbogo.yml
-go run cmd/client.go
-……
-……
-2022-12-30T20:59:19.971+0800 INFO cmd/client.go:44 start to test dubbo
-2022-12-30T20:59:19.982+0800 INFO cmd/client.go:52 get id result: aafd9c73-4014-4d67-a67f-5d107105647b
-
-```
-## 3. 更多
-
-可以发现注册中心我们是使用nacos，当然，我们也可以使用其他的注册中心，更多的使用方式，可以参考[注册中心](/zh-cn/overview/mannual/golang-sdk/tutorial/develop/registry/)
diff --git a/content/zh-cn/overview/quickstart/java/_index.md b/content/zh-cn/overview/quickstart/java/_index.md
deleted file mode 100755
index 64e5814c6646..000000000000
--- a/content/zh-cn/overview/quickstart/java/_index.md
+++ /dev/null
@@ -1,42 +0,0 @@
----
-aliases:
- - /zh/overview/quickstart/java/
-description: Java 微服务开发入门
-linkTitle: Java
-no_list: true
-title: Java 微服务开发入门
-type: docs
-weight: 1
----
-
-
-
-{{< blocks/section color="white" height="auto">}}
-
+ 
+