diff --git a/README.md b/README.md index 50fde5eab6..034a8721e5 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Apache Dubbo-go +# Apache Dubbo for Golang [![Build Status](https://github.com/apache/dubbo-go/workflows/CI/badge.svg)](https://travis-ci.org/apache/dubbo-go) [![codecov](https://codecov.io/gh/apache/dubbo-go/branch/master/graph/badge.svg)](https://codecov.io/gh/apache/dubbo-go) @@ -8,103 +8,65 @@ --- -[中文 🇨🇳](./README_CN.md) +Apache Dubbo is an easy-to-use Web and RPC framework that provides multiple +language implementations(Go, [Java](https://github.com/apache/dubbo), [Rust](https://github.com/apache/dubbo-rust), [Node.js](https://github.com/apache/dubbo-js), [Web](https://github.com/apache/dubbo-js)) for communication, service discovery, traffic management, +observability, security, tools, and best practices for building enterprise-ready microservices. -Apache Dubbo-go, a Dubbo implementation written in Golang, is born to bridge the gap between Java/Dubbo and Go/X. Please visit our [Dubbo official website](https://dubbo.apache.org/zh/docs3-v2/golang-sdk/) for the quick start and documentation. +Dubbo-go is the Go implementation of [triple protocol](https://dubbo.apache.org/zh-cn/overview/reference/protocols/triple-spec/)(a fully gRPC compatible and HTTP-friendly protocol) and the various features for building microservice architecture designed by Dubbo. -## RPC invocation - - - -Dubbo-go has supported many RPC protocols, like Triple, Dubbo, JSONRPC, gRPC, HTTP, HTTP2. The Triple, Dubbo and gRPC protocols supported security connections via TLS. - -- Triple is the supported protocol of Dubbo3 ecology, and is gRPC extended protocol based on HTTP2, which is compatible with gRPC service.In other words, **on the basis of gRPC's reliable invocation, it adds Dubbo's service governance capability.** -- Dubbo protocol is tradition Dubbo ecology protocol, which is compatible with Dubbo 2.x, and is a good choice for cross-language invocation between GO and Java legacy service. -- HTTP support: As you can see in the figure above, you can invoke Triple/Dubbo service using HTTP protocol through [dubbo-go-pixiu](https://github.com/apache/dubbo-go-pixiu) gateway. - -## Service governance capability - - - -- **Registry**: Nacos, Zookeeper, ETCD, Polaris-mesh, Consul. -- **ConfigCenter**: Nacos, Zookeeper -- **Cluster Strategy**: Failover, [Failfast](https://github.com/apache/dubbo-go/pull/140), [Failsafe/Failback](https://github.com/apache/dubbo-go/pull/136), [Available](https://github.com/apache/dubbo-go/pull/155), [Broadcast](https://github.com/apache/dubbo-go/pull/158), [Forking](https://github.com/apache/dubbo-go/pull/161) -- **Load Balance**: [AdaptiveService](https://github.com/apache/dubbo-go/pull/1649), Random, [RoundRobin](https://github.com/apache/dubbo-go/pull/66), [LeastActive](https://github.com/apache/dubbo-go/pull/65), [ConsistentHash](https://github.com/apache/dubbo-go/pull/261) -- [**Filter**](./filter): Echo, Hystrix, Token, AccessLog, TpsLimiter, ExecuteLimit, Generic, Auth/Sign, Metrics, Tracing, Active, Seata, Sentinel -- **[Generic Invoke](https://github.com/apache/dubbo-go/pull/122)** -- **Monitor**: [Prometheus](https://github.com/apache/dubbo-go/pull/342) -- **Tracing**: Jaeger, Zipkin -- **Router**: [Dubbo3 Router](https://github.com/apache/dubbo-go/pull/1187) +Visit [the official website](https://dubbo.apache.org/) for more information. ## Getting started -- Dubbo-go Quick Start: [中文 🇨🇳](https://dubbogo.github.io/zh-cn/docs/user/quickstart/3.0/quickstart_triple.html), [English 🇺🇸](https://dubbogo.github.io/en-us/docs/user/quickstart/3.0/quickstart_triple.html) -- [Dubbo-go Samples](https://github.com/apache/dubbo-go-samples): The project gives a series of samples that show each feature available for Dubbo-go and help you know how to integrate Dubbo-go with your system. -- [Dubbo-go Benchmark](https://github.com/dubbogo/dubbo-go-benchmark) -- [Dubbo-go Wiki](https://github.com/apache/dubbo-go/wiki) - -## Tools - - * [imports-formatter](https://github.com/dubbogo/tools/blob/master/cmd/imports-formatter/main.go) formatting dubbo-go project import code block. - * [dubbo-go-cli](https://github.com/dubbogo/tools/blob/master/cmd/dubbogo-cli/main.go) dubbo-go command line tools, by which you can define your own request pkg and gets rsp struct of your server, test your service as telnet and generate hessian.POJO register method body. - * [dubbo-go-cli-v2](https://github.com/dubbogo/tools/blob/master/cmd/dubbogo-cli-v2/README_CN.md) new dubbo-go line tools, you can get services from register center, create a demo , create application templates, one-click installation of protoc-gen-go-triple and imports-formatter tools,and has the same features with [dubbo-go-cli](https://github.com/dubbogo/tools/blob/master/cmd/dubbogo-cli/main.go). - * [protoc-gen-go-triple](https://github.com/dubbogo/tools/blob/master/cmd/protoc-gen-go-triple/main.go) tripe protocol pb file generation tool. - * [protoc-gen-dubbo3grpc](https://github.com/dubbogo/tools/blob/master/cmd/protoc-gen-dubbo3grpc/main.go) dubbo3 grpc pb file generation tool. +You can learn how to develop a dubbo-go RPC application step by step in 5 minutes by following our [Quick Start](https://github.com/apache/dubbo-go-samples/tree/main/helloworld) demo. +It's as simple as the code shown below, you define a service with Protobuf, provide your own service implementation, register it to a server, and start the server. -If you want to know more about dubbogo tools, please visit https://github.com/apache/dubbo-go/blob/master/dubbogo-cli and read its readme carefully. +```go +func (s *GreeterServer) SayHello(ctx context.Context, in *greet.HelloRequest) (*greet.User, error) { + return &greet.User{Name: "Hello " + in.Name, Id: "12345", Age: 21}, nil +} -## Intellij plugin +func main() { + s := config.NewServer() + s.RegisterService(&GreeterServer{}) + s.Serve(net.Listen("tcp", ":50051")) +} +``` -* Windows: File > Settings > Plugins > Browse repositories... > Search for "Dubbo Go" > Install Plugin -* MacOS: Preferences > Settings > Plugins > Browse repositories... > Search for "Dubbo Go" > Install Plugin -* Manually: - * Download the [latest release](https://plugins.jetbrains.com/plugin/18581-dubbo-go) and install it manually using Preferences > Plugins > Install plugin from disk... - * From official jetbrains store from download +After the server is up and running, call your service via cURL: +``` +curl -XPOST \ + -H 'Content-Type: application/json' \ + -H 'Micro-Endpoint: Helloworld.Greeting' \ + -d '{"name": "alice"}' \ + http://localhost:8080 +``` -### Features -| Feature | IDEA | GoLand | -|:------------------:|:----:|:------:| -| Hessian2 Generator | ✅️ | ✅️ | -| New Project/Module | ✅️ | ✅️ | +See the [samples](https://github.com/apache/dubbo-go-samples) for detailed information on usage. Next, learn how to deploy, monitor and manage the traffic of your dubbo-go application by visiting the official website. -#### Project/module templates -| Project/Module Template | Progress | -|:-----------------------:|:--------:| -| Sample | ✅️ | -| Empty Project | ✅️ | +## Features -##### Empty project template middleware -| Middleware | Module | Support | -|:------------:|:-------------------------------------:|:-------:| -| Web Service | [Gin](github.com/gin-gonic/gin) | ✅️ | -| Memory Cache | [Redis](github.com/go-redis/redis/v8) | ✅️ | -| Database | [Gorm](gorm.io/gorm) | ✅️ | +![dubbo-go-architecture](./doc/imgs/arc.png) - -If you want to know more about the Intellij Plugin for Dubbo-go, you may -refer to [https://gitee.com/changeden/intellij-plugin-dubbo-go-generator](https://gitee.com/changeden/intellij-plugin-dubbo-go-generator). +- **RPC Protocols**: Triple, gRPC compatible and HTTP-friendly +- **Service Discovery**: Nacos, Zookeeper, Etcd, Polaris-mesh, Consul. +- **Load Balance**: Adaptive, Random, RoundRobin, LeastActive, ConsistentHash +- **Traffic Management**: traffic split, timeout, rate limiting, canary release +- **Configuration**: yaml file, dynamic configuration(Nacos, Zookeeper, etc.). +- **Observability**: metrics(Prometheus, Grafana) and tracing(Jaeger, Zipkin). +- **HA Strategy**: Failover, Failfast, Failsafe/Failback, Available, Broadcast, Forking ## Ecosystem - -* [Dubbo Ecosystem Entry](https://github.com/apache?utf8=%E2%9C%93&q=dubbo&type=&language=) - A GitHub group `dubbo` to gather all Dubbo relevant projects not appropriate in [apache](https://github.com/apache) group yet. -* [dubbo-go-pixiu](https://github.com/apache/dubbo-go-pixiu) - A dynamic, high-performance API gateway solution for Dubbo and Http services. -* [dubbo-go-samples](https://github.com/apache/dubbo-go-samples) - Samples for Apache Dubbo-go. -* [dubbo-getty](https://github.com/apache/dubbo-getty) - A netty like asynchronous network I/O library which supports tcp/udp/websocket network protocol. -* [triple](https://github.com/dubbogo/triple) - A golang network package that based on http2, used by Dubbo-go 3.0. -* [dubbo-go-hessian2](https://github.com/apache/dubbo-go-hessian2) - A golang hessian library used by Apache/dubbo-go. -* [gost](https://github.com/dubbogo/gost) - A go sdk for Apache Dubbo-go. - +- [Console](https://github.com/apache/dubbo-kubernetes), under development +- [Samples](https://github.com/apache/dubbo-go-samples) +- [Interoperability with Dubbo Java](https://dubbo-next.staged.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/interop-dubbo/) ## Contributing Please visit [CONTRIBUTING](./CONTRIBUTING.md) for details on submitting patches and the contribution workflow. -## Reporting bugs - -Please use the [bug report template](issues/new?template=bug-report.md) to report bugs, use the [enhancement template](issues/new?template=enhancement.md) to provide suggestions for improvement. - ## Contact - [DingTalk Group](https://www.dingtalk.com/en): 23331795 @@ -121,27 +83,27 @@ If you are using [apache/dubbo-go](https://github.com/apache/dubbo-go) and think - + - + - + - + - + @@ -149,27 +111,27 @@ If you are using [apache/dubbo-go](https://github.com/apache/dubbo-go) and think - + - - + + - - + + - + - - + + @@ -177,27 +139,27 @@ If you are using [apache/dubbo-go](https://github.com/apache/dubbo-go) and think - + - - + + - + - + - + @@ -205,27 +167,27 @@ If you are using [apache/dubbo-go](https://github.com/apache/dubbo-go) and think - + - + - - + + - - + + - - + + @@ -238,4 +200,4 @@ If you are using [apache/dubbo-go](https://github.com/apache/dubbo-go) and think ## License -Apache Dubbo-go software is licenced under the Apache License Version 2.0. See the LICENSE file for details. +Apache Dubbo-go software is licensed under the Apache License Version 2.0. See the LICENSE file for details. diff --git a/README_CN.md b/README_CN.md deleted file mode 100644 index 66e3d74d68..0000000000 --- a/README_CN.md +++ /dev/null @@ -1,246 +0,0 @@ -# Apache Dubbo-go - -[![Build Status](https://github.com/apache/dubbo-go/workflows/CI/badge.svg)](https://travis-ci.org/apache/dubbo-go) -[![codecov](https://codecov.io/gh/apache/dubbo-go/branch/master/graph/badge.svg)](https://codecov.io/gh/apache/dubbo-go) -[![go.dev reference](https://img.shields.io/badge/go.dev-reference-007d9c?logo=go&logoColor=white&style=flat-square)](https://pkg.go.dev/github.com/apache/dubbo-go?tab=doc) -[![Go Report Card](https://goreportcard.com/badge/github.com/apache/dubbo-go)](https://goreportcard.com/report/github.com/apache/dubbo-go) -![license](https://img.shields.io/badge/license-Apache--2.0-green.svg) - ---- - -[English 🇺🇸](./README.md) - -Apache Dubbo Go 语言实现,架起 Java 和 Golang 之间的桥梁,与 gRPC/Dubbo/SpringCloud 生态互联互通,带领 Java 生态享受云原生时代的技术红利。请访问[Dubbo 官网](https://dubbo.apache.org/zh/docs3-v2/golang-sdk/)查看快速开始和文档。 - -## RPC 调用 - -![](https://dubbo-go-pixiu.github.io/img/pixiu-dubbo-ecosystem.png) - -Dubbo-go 生态覆盖多种网络协议:Triple、Dubbo、JSONRPC、gRPC、HTTP、HTTP2 等。Triple、Dubbo 和 gRPC 协议支持基于 TLS 的安全通信。 - -- Triple 协议是 Dubbo3 生态主推的协议,是基于 gRPC 的扩展协议,底层为HTTP2,可与 gRPC 服务互通。**相当于在 gRPC 可靠的传输基础上,增加了 Dubbo 的服务治理能力。** -- Dubbo 协议是 Dubbo 生态的传统协议,dubbo-go 支持的 dubbo 协议与dubbo2.x 版本兼容,是 Go 语言和旧版本 Dubbo 服务互通的不错选择。 -- 我们支持通过[貔貅](https://github.com/apache/dubbo-go-pixiu)网关暴露 Triple/Dubbo 协议到集群外部,调用者可以直接通过HTTP 协议调用 Dubbo-go 服务。 - -## 服务治理 - -![](https://dubbogo.github.io/img/devops.png) - -- **注册中心**: - - 支持 Nacos(阿里开源) 、Zookeeper、ETCD、Consul、Polaris-mesh(腾讯开源) 等服务注册中间件,并拥有可扩展能力。我们也会根据用户使用情况,进一步扩展出用户需要的实现。 - -- **配置中心** - - 开发者可以使用Nacos、Zookeeper 进行框架/用户的配置的发布和拉取。 - -- **集群策略**: Failover, [Failfast](https://github.com/apache/dubbo-go/pull/140), [Failsafe/Failback](https://github.com/apache/dubbo-go/pull/136), [Available](https://github.com/apache/dubbo-go/pull/155), [Broadcast](https://github.com/apache/dubbo-go/pull/158), [Forking](https://github.com/apache/dubbo-go/pull/161) 等 - -- **负载均衡策略**: [柔性服务](https://github.com/apache/dubbo-go/pull/1649), Random, [RoundRobin](https://github.com/apache/dubbo-go/pull/66), [LeastActive](https://github.com/apache/dubbo-go/pull/65), [ConsistentHash](https://github.com/apache/dubbo-go/pull/261) 等 - -- [**过滤器**](./filter): Echo, Hystrix, Token, AccessLog, TpsLimiter, ExecuteLimit, Generic, Auth/Sign, Metrics, Tracing, Active, Seata, Sentinel 等 - -- **泛化调用** - -- **监控**: [Prometheus](https://github.com/apache/dubbo-go/pull/342) - -- **链路追踪**: Jaeger, Zipkin - -- **路由器**: [Dubbo3 Router](https://github.com/apache/dubbo-go/pull/1187) - -## 快速开始 - -- Dubbo-go 快速开始: [中文 🇨🇳](https://dubbogo.github.io/zh-cn/docs/user/quickstart/3.0/quickstart_triple.html), [English 🇺🇸](https://dubbogo.github.io/en-us/docs/user/quickstart/3.0/quickstart_triple.html) -- [Dubbo-go 样例](https://github.com/apache/dubbo-go-samples): 该项目提供了一系列的样例,以展示Dubbo-go的每一项特性以及帮助你将Dubbo-go集成到你的系统中。 -- [Dubbo-go 百科](https://github.com/apache/dubbo-go/wiki) - -## 工具 - - * [imports-formatter](https://github.com/dubbogo/tools/blob/master/cmd/imports-formatter/main.go) dubbo-go 工程 import 代码块格式化工具 - * [dubbo-go-cli](https://github.com/dubbogo/tools/blob/master/cmd/dubbogo-cli/main.go) dubbo-go 命令行工具、支持展示服务、发起服务调用、定义 dubbogo 服务 struct 等功能、生成 hessian.POJO 方法体 - * [dubbo-go-cli-v2](https://github.com/dubbogo/tools/blob/master/cmd/dubbogo-cli-v2/README_CN.md) 新 dubbo-go 命令行工具, 支持创建 demo、创建应用模版、一键安装 protoc-gen-go-triple 及 imports-formatter 工具,从注册中心获取服务列表以及兼容 [dubbo-go-cli](https://github.com/dubbogo/tools/blob/master/cmd/dubbogo-cli/main.go) 的所有功能 - * [protoc-gen-go-triple](https://github.com/dubbogo/tools/blob/master/cmd/protoc-gen-go-triple/main.go) tripe 协议 pb 生成工具 - * [protoc-gen-dubbo3grpc](https://github.com/dubbogo/tools/blob/master/cmd/protoc-gen-dubbo3grpc/main.go) dubbo3 grpc 生成工具 - -如果想知道 dubbogo 工具集更多更详细的使用细节,请访问 https://github.com/apache/dubbo-go/blob/master/dubbogo-cli 并仔细阅读其 raedme。 - -## Intellij 插件 - -* Windows: File > Settings > Plugins > Browse repositories... > 搜索 "Dubbo Go" > Install Plugin -* MacOS: Preferences > Settings > Plugins > Browse repositories... > 搜索 "Dubbo Go" > Install Plugin -* 手动安装: - * 下载[最新版插件](https://plugins.jetbrains.com/plugin/18581-dubbo-go) 并且尝试手动安装, Preferences > Plugins > Install plugin from disk... - * 插件市场[https://plugins.jetbrains.com/plugin/18581-dubbo-go](https://plugins.jetbrains.com/plugin/18581-dubbo-go) - - -### 功能特性 -| 特性 | IDEA | GoLand | -|:------------:|:----:|:------:| -| Hessian2 生成器 | ✅️ | ✅️ | -| 创建项目/模块 | ✅️ | ✅️ | - -#### 创建新项目 -| 项目/模块模板 | 进度 | -|:-------:|:---:| -| 官方例子 | ✅️ | -| 空项目 | ✅️ | - -##### 空项目模板中间件 -| 中间件类型 | 可选模块 | 是否支持 | -|:-----:|:-------------------------------------:|:----:| -| 网络服务 | [Gin](github.com/gin-gonic/gin) | ✅️ | -| 内存缓存 | [Redis](github.com/go-redis/redis/v8) | ✅️ | -| 数据库 | [Gorm](gorm.io/gorm) | ✅️ | - -如果想知道 dubbogo 工具集更多更详细的使用细节,请访问 [https://gitee.com/changeden/intellij-plugin-dubbo-go-generator](https://gitee.com/changeden/intellij-plugin-dubbo-go-generator) 并仔细阅读其 raedme。 - -## 生态 - -* [Dubbo Ecosystem Entry](https://github.com/apache?utf8=%E2%9C%93&q=dubbo&type=&language=) - Apache Dubbo 群组的相关开源项目 -* [dubbo-go-pixiu](https://github.com/apache/dubbo-go-pixiu) - 动态高性能 API 网关,支持 Dubbo 和 Http 等多种协议 -* [dubbo-go-samples](https://github.com/apache/dubbo-go-samples) - Dubbo-go 项目案例 -* [dubbo-getty](https://github.com/apache/dubbo-getty) - Netty 风格的异步网络 IO 库,支持 tcp、udp 和 websocket 等协议 -* [triple](https://github.com/dubbogo/triple) - 基于 HTTP2 的 Dubbo-go 3.0 协议网络库 -* [dubbo-go-hessian2](https://github.com/apache/dubbo-go-hessian2) - 供 Dubbo-go 使用的 hessian2 库 -* [gost](https://github.com/dubbogo/gost) - 供 Dubbo-go 使用的基础代码库 - -## 如何贡献 - -请访问[CONTRIBUTING](./CONTRIBUTING.md)来了解如何提交更新以及贡献工作流。 - -## 报告问题 - -请使用[bug report 模板](issues/new?template=bug-report.md)报告错误,使用[enhancement 模版](issues/new?template=enhancement.md)提交改进建议。 - -## 联系 - -- [钉钉群](https://www.dingtalk.com/): 23331795 - -## [用户列表](https://github.com/apache/dubbo-go/issues/2) - -若你正在使用 [apache/dubbo-go](https://github.com/apache/dubbo-go) 且认为其有用或者想对其做改进,请添列贵司信息于 [用户列表](https://github.com/apache/dubbo-go/issues/2),以便我们知晓。 - -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - - - - - - - - - - - - - - - - - - -
- - - - - - - - - - - - - - - - - - - -
- - - - - - - - - - - - - - - - - - - -
- - - - - - - - - - - - - - - - - - - -
-
-[查看更多用户示例](https://github.com/apache/dubbo-go/issues/2) - -## 许可证 - -Apache Dubbo-go使用Apache许可证2.0版本,请参阅LICENSE文件了解更多。 diff --git a/doc/imgs/arc.png b/doc/imgs/arc.png new file mode 100644 index 0000000000..d0ea10991e Binary files /dev/null and b/doc/imgs/arc.png differ diff --git a/doc/imgs/usecase-autohome.png b/doc/imgs/usecase-autohome.png new file mode 100644 index 0000000000..9093b7b0ea Binary files /dev/null and b/doc/imgs/usecase-autohome.png differ diff --git a/doc/imgs/usecase-beike.png b/doc/imgs/usecase-beike.png new file mode 100644 index 0000000000..3b6350420f Binary files /dev/null and b/doc/imgs/usecase-beike.png differ diff --git a/doc/imgs/usecase-eht.png b/doc/imgs/usecase-eht.png new file mode 100644 index 0000000000..3d93a77db2 Binary files /dev/null and b/doc/imgs/usecase-eht.png differ diff --git a/doc/imgs/usecase-gaode.png b/doc/imgs/usecase-gaode.png new file mode 100644 index 0000000000..70b21f7a36 Binary files /dev/null and b/doc/imgs/usecase-gaode.png differ diff --git a/doc/imgs/usecase-genshuixue.png b/doc/imgs/usecase-genshuixue.png new file mode 100644 index 0000000000..aaa0f00dbd Binary files /dev/null and b/doc/imgs/usecase-genshuixue.png differ diff --git a/doc/imgs/usecase-jd.png b/doc/imgs/usecase-jd.png new file mode 100644 index 0000000000..fbb9ad19d0 Binary files /dev/null and b/doc/imgs/usecase-jd.png differ diff --git a/doc/imgs/usecase-kaikele.png b/doc/imgs/usecase-kaikele.png new file mode 100644 index 0000000000..3dbca32ff1 Binary files /dev/null and b/doc/imgs/usecase-kaikele.png differ diff --git a/doc/imgs/usecase-mgtv.png b/doc/imgs/usecase-mgtv.png new file mode 100644 index 0000000000..a938841b00 Binary files /dev/null and b/doc/imgs/usecase-mgtv.png differ diff --git a/doc/imgs/usecase-mi.png b/doc/imgs/usecase-mi.png new file mode 100644 index 0000000000..f2a3538453 Binary files /dev/null and b/doc/imgs/usecase-mi.png differ diff --git a/doc/imgs/usecase-mosn.png b/doc/imgs/usecase-mosn.png new file mode 100644 index 0000000000..2bf325d8ba Binary files /dev/null and b/doc/imgs/usecase-mosn.png differ diff --git a/doc/imgs/usecase-pdd.png b/doc/imgs/usecase-pdd.png new file mode 100644 index 0000000000..9f576f85c7 Binary files /dev/null and b/doc/imgs/usecase-pdd.png differ diff --git a/doc/imgs/usecase-sohu.png b/doc/imgs/usecase-sohu.png new file mode 100644 index 0000000000..8430217672 Binary files /dev/null and b/doc/imgs/usecase-sohu.png differ diff --git a/doc/imgs/usecase-tianyi.png b/doc/imgs/usecase-tianyi.png new file mode 100644 index 0000000000..3828cd546a Binary files /dev/null and b/doc/imgs/usecase-tianyi.png differ diff --git a/doc/imgs/usecase-tiger-brokers.png b/doc/imgs/usecase-tiger-brokers.png new file mode 100644 index 0000000000..babf6e38a5 Binary files /dev/null and b/doc/imgs/usecase-tiger-brokers.png differ diff --git a/doc/imgs/usecase-tuya.png b/doc/imgs/usecase-tuya.png new file mode 100644 index 0000000000..afce9c8d7d Binary files /dev/null and b/doc/imgs/usecase-tuya.png differ diff --git a/doc/imgs/usecase-vivo.png b/doc/imgs/usecase-vivo.png new file mode 100644 index 0000000000..d0618a8123 Binary files /dev/null and b/doc/imgs/usecase-vivo.png differ diff --git a/doc/imgs/usecase-xiecheng.png b/doc/imgs/usecase-xiecheng.png new file mode 100644 index 0000000000..4be1445fd6 Binary files /dev/null and b/doc/imgs/usecase-xiecheng.png differ diff --git a/doc/imgs/usecase-zhanzhang.png b/doc/imgs/usecase-zhanzhang.png new file mode 100644 index 0000000000..076c0f645d Binary files /dev/null and b/doc/imgs/usecase-zhanzhang.png differ diff --git a/doc/imgs/usecase-zonghengwenxue.png b/doc/imgs/usecase-zonghengwenxue.png new file mode 100644 index 0000000000..eb2d1ba03d Binary files /dev/null and b/doc/imgs/usecase-zonghengwenxue.png differ diff --git a/doc/imgs/usecase-zto.png b/doc/imgs/usecase-zto.png new file mode 100644 index 0000000000..e2289fbc3d Binary files /dev/null and b/doc/imgs/usecase-zto.png differ