快速入门

前提条件

• 支持 Docker Compose 文件版本 3 的 Docker 和 docker-compose。有关安装说明，请参阅安装 Compose。

获取示例代码

示例代码是 grpc-web 仓库的一部分。

1. 将仓库下载为 zip 文件并解压，或克隆仓库

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

2. 切换到仓库的根目录

   cd grpc-web
   

从浏览器运行 Echo 示例！

在 grpc-web 目录下

1. 获取必需的包和工具

   docker-compose pull prereqs node-server envoy commonjs-client
   

   注意

   看到以下警告？为了运行示例应用，您可以忽略它

   WARNING: Some service image(s) must be built from source
   

2. 以后台进程启动服务

   docker-compose up -d node-server envoy commonjs-client
   

3. 在您的浏览器中

   • 访问 localhost:8081/echotest.html。
   • 在文本输入框中输入一条消息，例如“Hello”。
   • 按下发送按钮。

   您将在输入框下方看到服务器回显您的消息。

恭喜！您刚刚使用 gRPC 运行了一个客户端-服务器应用程序。

完成后，运行以下命令关闭您之前启动的服务

docker-compose down

发生了什么？

此示例应用包含三个关键组件

1. node-server 是一个标准的 gRPC 服务器，使用 Node 实现。此服务器监听端口 :9090，并实现应用的业务逻辑（回显客户端消息）。
2. envoy 是 Envoy 代理。它监听端口 :8080 并将浏览器的 gRPC-Web 请求转发到端口 :9090。
3. commonjs-client：此组件使用 protoc-gen-grpc-web protoc 插件生成客户端 stub 类，使用 webpack 编译所有 JS 依赖项，并使用一个简单的 web 服务器在端口 :8081 托管静态内容（echotest.html 和 dist/main.js）。从网页输入的用户消息作为 gRPC-web 请求发送到 Envoy 代理。

下一步

• 学习 基础教程。