快速入门

本指南将通过一个简单的示例帮助您开始使用 gRPC-Web。

快速入门

本指南将通过一个简单的示例帮助您开始使用 gRPC-Web。

先决条件

获取示例代码

示例代码是 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
    
  2. 以后台进程方式启动服务

    docker-compose up -d node-server envoy commonjs-client
    
  3. 从您的浏览器

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

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

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

docker-compose down

发生了什么?

此示例应用程序具有三个关键组件

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

下一步

上次修改时间为 2024 年 11 月 25 日:feat: move the $ shell line indicator to scss (#1354) (ab8b3af)