This is an automated email from the ASF dual-hosted git repository. alexstocks pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/dubbo-go-samples.git
commit c364e405b2ae1a52612e0bb78220c2e5dcf30181 Author: AlexStocks <[email protected]> AuthorDate: Thu Sep 8 18:49:24 2022 +0800 update readme --- README.md | 4 ++++ README_zh.md => README_cn.md | 2 ++ mesh/README.md | 10 +++++----- proxyless/README.md | 16 ++++++++-------- 4 files changed, 19 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index c8f9648d..dc7f8d2d 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,8 @@  +[中文 🇨🇳](./README_CN.md) + ## What It Contains * apisix: apache/apisix and Dubbo-go example @@ -16,8 +18,10 @@ * helloworld: A 101 example * integrate_test: dubbogo github action integrate test use cases * logger: dubbogo logging +* mesh: give an proxy service mesh example which shows how to deploy the dubbo-go services with envoy on kubernetes platform * metrics: show how to collect dubbogo prometheus metrics * otel/trace: show how to use opentelemetry as dubbogo tracing tool +* proxyless: give an proxyless service mesh example which shows how to deploy the dubbo-go services on kubernetes platform * registry: show how to use etcd/nacos/polaris/zookeeper as dubbogo registry * rpc: dubbo directory display dubbo protocol communication * seata: A seata example diff --git a/README_zh.md b/README_cn.md similarity index 85% rename from README_zh.md rename to README_cn.md index 2bb99c45..174d66fa 100644 --- a/README_zh.md +++ b/README_cn.md @@ -16,8 +16,10 @@ * helloworld: 入门例子 * integrate_test: dubbogo github action 集成测试用例 * logger: dubbogo logging +* mesh: 这个示例演示了如何将 dubbo-go 开发的应用部署在 Istio 体系下，以实现 Envoy 对 dubbo/dubbo-go 服务的自动代理 * metrics: 使用 prometheus 收集 dubbogo 的 metrics * otel/trace: 使用 opentelemetry 进行 tracing +* proxyless: 这个示例演示了如何将 dubbo-go 开发的应用部署在 Istio 体系下，以实现 Envoy 对 dubbo/dubbo-go 服务的自动代理 * registry: 把 etcd/nacos/polaris/zookeeper 当做 dubbogo 注册中心示例 * rpc: 使用 Dubbogo 框架启动 rpc 服务，发起调用 * seata: 在 dubbogo 中如何基于 seata 实现分布式事务 diff --git a/mesh/README.md b/mesh/README.md index b2cf5383..9bbda13e 100644 --- a/mesh/README.md +++ b/mesh/README.md @@ -1,4 +1,4 @@ -# Dubbo Go Proxy Mesh Using Istio +# dubbo-go Proxy Mesh Using Istio 可以按照下文步骤，将 Demo 部署到本地集群。 @@ -15,20 +15,20 @@ <h2 id="target">1 总体目标</h2> -* 部署 Dubbo Go 应用到 Kubernetes +* 部署 dubbo-go 应用到 Kubernetes * Istio 自动注入 Envoy 并实现流量拦截 * 基于 Istio 规则进行流量治理 <h2 id="basic">2 基本流程与工作原理</h2> -这个示例演示了如何将 Dubbo Go 开发的应用部署在 Istio 体系下，以实现 Envoy 对 Dubbo 服务的自动代理，示例总体架构如下图所示。 +这个示例演示了如何将 dubbo-go 开发的应用部署在 Istio 体系下，以实现 Envoy 对 Dubbo 服务的自动代理，示例总体架构如下图所示。 [thinsdk](./assets/thinsdk.png) 完成示例将需要的步骤如下： -1. 创建一个 Dubbo Go 应用，可直接使用( [dubbo-go-samples](https://github.com/apache/dubbo-go-samples/tree/master/mesh) ) +1. 创建一个 dubbo-go 应用，可直接使用( [dubbo-go-samples](https://github.com/apache/dubbo-go-samples/tree/master/mesh) ) 2. 构建容器镜像并推送到镜像仓库，可直接使用 ([本示例官方镜像](https://hub.docker.com/r/apache/dubbo-demo/tags)) -3. 分别部署 Dubbo Go Provider 与 Dubbo Go Consumer 到 Kubernetes 并验证 Envoy 代理注入成功 +3. 分别部署 dubbo-go Provider 与 dubbo-go Consumer 到 Kubernetes 并验证 Envoy 代理注入成功 4. 验证 Envoy 发现服务地址、正常拦截 RPC 流量并实现负载均衡 5. 优化并配置健康检查流程 diff --git a/proxyless/README.md b/proxyless/README.md index 0b62957b..be44d6db 100644 --- a/proxyless/README.md +++ b/proxyless/README.md @@ -17,7 +17,7 @@ <h2 id="target">1 总体目标</h2> -* 部署 Dubbo Go 应用到 Kubernetes +* 部署 dubbo-go 应用到 Kubernetes * Istio 自动注入 Envoy 并实现流量拦截 * 基于 Istio 规则进行流量治理 @@ -28,7 +28,7 @@ 完成示例将需要的步骤如下： -1. 创建一个 Dubbo Go 应用，可直接使用( [dubbo-go-samples](https://github.com/apache/dubbo-go-samples/tree/master/mesh) ) +1. 创建一个 dubbo-go 应用，可直接使用( [dubbo-go-samples](https://github.com/apache/dubbo-go-samples/tree/master/mesh) ) 2. 构建容器镜像并推送到镜像仓库，可直接使用 ([本示例官方镜像](https://hub.docker.com/u/dubboteam)) 3. 分别部署 Dubbo Provider 与 Dubbo Consumer 到 Kubernetes 并验证 Envoy 代理注入成功 4. 验证 Envoy 发现服务地址、正常拦截 RPC 流量并实现负载均衡 @@ -142,9 +142,9 @@ kubectl logs your-pod-id -c istio-proxy consumer istio-proxy 日志输出如下: ```shell -[2022-07-15T05:35:14.418Z] "POST /org.apache.dubbo.samples.Greeter/greet HTTP/2" 200 -- via_upstream - "-" 19 160 2 1 "-" "-" "6b8a5a03-5783-98bf-9bee-f93ea6e3d68e" -"dubbo-samples-mesh-provider:50052" "172.17.0.4:50052" +[2022-07-15T05:35:14.418Z] "POST /org.apache.dubbo.samples.Greeter/greet HTTP/2" 200 +- via_upstream - "-" 19 160 2 1 "-" "-" "6b8a5a03-5783-98bf-9bee-f93ea6e3d68e" +"dubbo-samples-mesh-provider:50052" "172.17.0.4:50052" outbound|50052||dubbo-samples-mesh-provider.dubbo-demo.svc.cluster.local 172.17.0.7:52768 10.101.172.129:50052 172.17.0.7:38488 - default ``` @@ -159,8 +159,8 @@ outbound|50052||dubbo-samples-mesh-provider.dubbo-demo.svc.cluster.local 172.17. provider istio-proxy 日志输出如下: ```shell -[2022-07-15T05:25:34.061Z] "POST /org.apache.dubbo.samples.Greeter/greet HTTP/2" 200 -- via_upstream - "-" 19 162 1 1 "-" "-" "201e6976-da10-96e1-8da7-ad032e58db47" +[2022-07-15T05:25:34.061Z] "POST /org.apache.dubbo.samples.Greeter/greet HTTP/2" 200 +- via_upstream - "-" 19 162 1 1 "-" "-" "201e6976-da10-96e1-8da7-ad032e58db47" "dubbo-samples-mesh-provider:50052" "172.17.0.10:50052" inbound|50052|| 127.0.0.6:47013 172.17.0.10:50052 172.17.0.7:60244 outbound_.50052_._.dubbo-samples-mesh-provider.dubbo-demo.svc.cluster.local default @@ -282,4 +282,4 @@ kubectl label namespace ${your namespace} istio-injection=enabled --overwrite # 关闭自动注入sidecar kubectl label namespace ${your namespace} istio-injection=disabled --overwrite -``` \ No newline at end of file +```
