gRPC-WebDemo: Go微服务与Web客户端通信实战

gRPC-WebDemo: Go微服务与Web客户端通信实战

grpc-web-demo Dockerized Go microservices and their envoy proxies for a flow which showcases gRPC for Web Clients. Check the medium story!!! 项目地址: https://gitcode.com/gh_mirrors/gr/grpc-web-demo

1. 项目介绍

本项目名为gRPC-Web Demo，展示了如何通过gRPC-Web技术让一个Angular前端应用与Go语言编写的gRPC服务进行直接通信。它包括了多个以Go语言实现的微服务（如Catalog µS, Offer µS, Order µS），这些服务支持gRPC的Unary及Server-side Streaming模式，并且利用Envoy代理来适配gRPC-Web协议，以便于Web客户端无需修改即可调用gRPC服务。

此外，还有justrandomdev/go-grpc-web-demo作为参考，这是一个更简化版本的示例，演示了在不使用任何代理的情况下，Angular客户端与Golang gRPC服务器的直接集成。

2. 快速启动

环境准备

确保你的开发环境中已安装Docker。

步骤

1. 克隆项目:

   git clone https://github.com/uid4oe/grpc-web-demo.git
   

2. 创建网络并启动服务: 在项目根目录下执行以下命令来创建网络并部署所有必要的容器。

   docker network create grpc-web-demo-alva-net
   docker-compose up -d
   

此时，项目应已成功部署运行。

本地运行UI（可选）

如果希望单独本地运行UI部分，首先需要停止UI容器，然后遵循gRPC-Web Demo UI的说明进行操作。

3. 应用案例和最佳实践

这个项目展示了几个关键的最佳实践：

• 微服务架构: 通过独立的Go微服务展示服务拆分的清晰结构。
• gRPC-Web桥接: 使用Envoy作为代理，解决了Web客户端与gRPC服务间协议不兼容的问题。
• 多模式服务: 实现了gRPC的Unary和Server-side Streaming，适用于不同数据交互场景。

在实际应用中，开发者应该关注服务的解耦、安全性以及性能优化，比如合理配置Envoy以最小化延迟。

4. 典型生态项目

• justrandomdev/go-grpc-web-demo: 这个项目提供了一个简化的视角，无须Envoy代理直接实现了Angular与gRPC服务的通信，适合快速上手gRPC-Web的基本概念。
• grpc-ecosystem/grpc-gateway: 另一个常见的生态组件，它允许将gRPC服务暴露为REST API，增加了服务的可访问性。

---

以上就是基于gRPC-Web Demo项目的简单介绍与快速启动指南，以及相关最佳实践和生态推荐。通过这个项目，开发者可以深入理解如何在现代全栈开发中利用gRPC-Web技术。

grpc-web-demo Dockerized Go microservices and their envoy proxies for a flow which showcases gRPC for Web Clients. Check the medium story!!! 项目地址: https://gitcode.com/gh_mirrors/gr/grpc-web-demo