快速入门
本指南将通过一个简单的示例帮助您开始使用 gRPC-Web。
快速入门
本指南将通过一个简单的示例帮助您开始使用 gRPC-Web。
先决条件
支持 Docker Compose 文件版本 3 的 Docker 和
docker-compose
。有关安装说明,请参阅 安装 Compose。
获取示例代码
示例代码是 grpc-web 仓库的一部分。
将仓库下载为 zip 文件 并解压缩,或克隆仓库
git clone https://github.com/grpc/grpc-web
切换到仓库的根目录
cd grpc-web
在浏览器中运行 Echo 示例!
从 grpc-web
目录
获取所需的包和工具
docker-compose pull prereqs node-server envoy commonjs-client
注意
收到以下警告?为了运行示例应用程序,您可以忽略它
WARNING: Some service image(s) must be built from source
以后台进程方式启动服务
docker-compose up -d node-server envoy commonjs-client
从您的浏览器
- 访问 localhost:8081/echotest.html。
- 在文本输入框中输入一条消息,例如“你好”。
- 按下 发送 按钮。
您将在输入框下方看到服务器回显的消息。
恭喜!您刚刚使用 gRPC 运行了一个客户端-服务器应用程序。
完成后,运行以下命令关闭您之前启动的服务
docker-compose down
发生了什么?
此示例应用程序具有三个关键组件
node-server
是一个用 Node 实现的标准 gRPC 服务器。此服务器监听端口:9090
,并实现应用程序的业务逻辑(回显客户端消息)。envoy
是 Envoy 代理。它监听:8080
并将浏览器的 gRPC-Web 请求转发到端口:9090
。commonjs-client
:此组件使用protoc-gen-grpc-web
protoc 插件生成客户端存根类,使用webpack
编译所有 JS 依赖项,并使用一个简单的 Web 服务器在端口:8081
上托管静态内容 (echotest.html
和dist/main.js
)。从网页输入的用户消息将作为 gRPC-web 请求发送到 Envoy 代理。
下一步
- 学习 基础教程。
上次修改时间为 2024 年 11 月 25 日:feat: move the $ shell line indicator to scss (#1354) (ab8b3af)