Nginx 宣布从 1.13.10 开始正式支持 gRPC

柔光的暖阳◎ 2022-05-28 05:28 194阅读 0赞

最近，NGINX在其博客宣布，Nginx 宣布从 1.13.10 开始正式支持 gRPC

如下是正文翻译：

今天，我们很高兴在[NGINX 1.13.10][]上分享[gRPC流量][gRPC]的第一个[本地支持][gRPC]。下一个NGINX Plus版本R15将包含对gRPC的支持以及对[NGINX 1.13.9中][NGINX 1.13.9]引入的HTTP / 2服务器推送支持的支持。

NGINX可以代理gRPC TCP连接。有了这个新功能，您可以终止，检查和路由gRPC方法调用。您可以使用它来：

*  发布gRPC服务，然后使用NGINX应用HTTP / 2 TLS加密，速率限制，基于IP的访问控制列表和日志记录。您可以使用未加密的HTTP / 2（h2c cleartext）操作该服务，或者在服务周围打包TLS加密和认证。
 *  通过单个端点发布多个gRPC服务，使用NGINX检查呼叫并将其路由到每个内部服务。您甚至可以对其他HTTPS和HTTP / 2服务使用相同的端点，例如网站和基于REST的API。
 *  使用循环法，最少连接或其他方法在集群中分配呼叫，对gRPC服务集群进行负载均衡。然后，您可以在需要额外容量时扩展基于gRPC的服务

要了解更多NGINX HTTP / 2服务器推送和gRPC支持，请注册我们两个实况网络研讨会之一：[2018年3月28日上午11:00 CEST][2018_3_28_11_00 CEST]或[2018年3月29日上午10:00 PDT][2018_3_29_10_00 PDT]

## 什么是gRPC？ ##

gRPC是一种[远程过程调用][Link 1]协议，用于客户端和服务器应用程序之间的通信。它被设计为紧凑（节省空间）并且可跨多种语言移植，并且支持请求响应和流式交互。由于其[广泛的语言支持][Link 2]和简单的面向用户的设计，协议越来越受欢迎，包括在[服务网格实现中][Link 3]。

![一个简单的基于gRPC的应用程序][gRPC 1] NGINX代理gRPC流量

先通过gRPC更新部署NGINX。如果你想从源代码构建NGINX，请记住包含`http_ssl`和`http_v2`模块：

$ auto/configure --with-http_ssl_module --with-http_v2_module

NGINX使用HTTP服务器监听gRPC流量，并使用该[`grpc_pass`][grpc_pass]指令代理流量。为NGINX创建以下代理配置，在端口80上侦听未加密的gRPC流量并将请求转发到端口50051上的服务器：

http {
       
        log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                          '$status $body_bytes_sent "$http_referer" '
                          '"$http_user_agent"';
     
        server {
       
            listen 80 http2;
     
            access_log logs/access.log main;
     
            location / {
       
                # Replace localhost:50051 with the address and port of your gRPC server
                # The 'grpc://' prefix is optional; unencrypted gRPC is the default
                grpc_pass grpc://localhost:50051;
            }
        }
    }

确保`grpc_pass`指令中的地址是正确的。重新编译客户端以指向NGINX的IP地址并监听端口。

当您运行修改后的客户端时，您会看到与以前相同的响应，但交易将由NGINX终止并转发。您可以在您配置的访问日志中看到它们：

$ tail logs/access.log
    192.168.20.11 - - [01/Mar/2018:13:35:02 +0000] "POST /helloworld.Greeter/SayHello HTTP/2.0" 200 18 "-" "grpc-go/1.11.0-dev"
    192.168.20.11 - - [01/Mar/2018:13:35:02 +0000] "POST /helloworld.Greeter/SayHelloAgain HTTP/2.0" 200 24 "-" "grpc-go/1.11.0-dev"

注意： NGINX不支持在明文（非TLS）端口上同时支持HTTP / 1和HTTP / 2 。它需要[有关][Link 4]使用哪个版本的协议的[先验知识][Link 4]。如果您想通过明文处理两个协议版本，请为每个协议创建一个监听端口。

### 使用TLS加密发布gRPC服务 ###

Hello World快速入门示例使用未加密的HTTP / 2（明文）进行通信。这对测试和部署来说非常简单，但它不提供生产部署所需的加密。你可以使用NGINX来添加这个加密层。

![gRPC请求 - 响应流程，TLS加密，NGINX作为代理][gRPC_ - _TLS_NGINX] NGINX路由和SSL终止gRPC流量

使用NGINX，您可以识别服务和方法，然后使用[`location`][location]指令路由流量。您可能已经推断出每个gRPC请求的URL是从proto规范中的包，服务和方法名称派生的。考虑这个示例`SayHello`RPC方法：

package helloworld;
     
    service Greeter {
       
        rpc SayHello (HelloRequest) returns (HelloReply) {}
    }

调用`SayHello`RPC方法`POST`为/helloworld.Greeter/SayHello发出请求，如以下日志条目所示：

192.168.20.11 - - [01/Mar/2018:13:35:02 +0000] "POST /helloworld.Greeter/SayHello HTTP/2.0" 200 18 "-" "grpc-go/1.11.0-dev"

使用NGINX路由流量非常简单：

location /helloworld.Greeter {
       
        grpc_pass grpc://192.168.20.11:50051;
    }
     
    location /helloworld.Dispatcher {
       
        grpc_pass grpc://192.168.20.11:50052;
    }
     
    location / {
       
        root html;
        index index.html index.htm;
    }

你可以自己尝试一下。这里我们扩展了示例Hello World包（in `helloworld.proto`）以添加一个名为Dispatcher的新服务，然后创建了一个实现Dispatcher方法的新服务器应用程序。客户端使用单个HTTP / 2连接为Greeter和Dispatcher服务发出RPC调用。NGINX将呼叫分开并路由到合适的gRPC服务器。

注意“全部” `location` `/`块。该块处理与已知gRPC调用不匹配的请求。您可以使用这样的`location`块从相同的TLS加密端点提供Web内容和其他非gRPC服务。

### 负载平衡gRPC呼叫 ###

您现在如何扩展gRPC服务以增加容量并提供高可用性？NGINX的上游团队正是这样做的：

upstream grpcservers {
       
        server 192.168.20.11:50051;
        server 192.168.20.12:50051;
    }
     
    server {
       
        listen 1443 ssl http2;
     
        ssl_certificate     ssl/certificate.pem;
        ssl_certificate_key ssl/key.pem;
     
        location /helloworld.Greeter {
       
            grpc_pass grpc://grpcservers;
            error_page 502 = /error502grpc;
        }
     
        location = /error502grpc {
       
            internal;
            default_type application/grpc;
            add_header grpc-status 14;
            add_header grpc-message "unavailable";
            return 204;
        }
    }

当然，`grpc_pass` `grpcs://upstreams`如果您的上游用户在TLS上收听，则可以使用。

NGINX可以采用一系列[负载平衡算法][Link 5]来分配上游gRPC服务器上的gRPC呼叫。NGINX的[内置运行状况检查][Link 6]检测服务器是否无法响应或产生错误，然后使服务器停止运转。如果没有服务器可用，则该`/error502grpc`位置将返回符合gRPC的错误消息。

[NGINX 1.13.10]: http://nginx.org/en/download.html
[gRPC]: http://nginx.org/en/docs/http/ngx_http_grpc_module.html
[NGINX 1.13.9]: https://www.nginx.com/blog/nginx-1-13-9-http2-server-push/
[2018_3_28_11_00 CEST]: https://www.nginx.com/resources/webinars/nginx-http2-server-push-grpc-emea
[2018_3_29_10_00 PDT]: https://www.nginx.com/resources/webinars/nginx-http2-server-push-grpc
[Link 1]: https://en.wikipedia.org/wiki/Remote_procedure_call
[Link 2]: https://grpc.io/docs/tutorials/
[Link 3]: https://istio.io/docs/concepts/what-is-istio/overview.html
[gRPC 1]: https://cdn-1.wp.nginx.com/wp-content/uploads/2018/03/dia-FS-2018-03-08-NGINX-gRPC-01-What-Is-gRPC-1024x147-1024x147.png
[grpc_pass]: http://nginx.org/en/docs/http/ngx_http_grpc_module.html#grpc_pass
[Link 4]: https://tools.ietf.org/html/rfc7540#section-3.4
[gRPC_ - _TLS_NGINX]: https://cdn-1.wp.nginx.com/wp-content/uploads/2018/03/dia-FS-2018-03-08-NGINX-gRPC-03-gRPC-with-TLS-Encryption-1024x225-1024x225.png
[location]: http://nginx.org/en/docs/http/ngx_http_core_module.html#location
[Link 5]: https://docs.nginx.com/nginx/admin-guide/load-balancer/http-load-balancer/#choosing-a-load-balancing-method
[Link 6]: https://docs.nginx.com/nginx/admin-guide/load-balancer/http-load-balancer/#passive-health-checks

发表评论取消回复

表情：

评论列表（有 0 条评论，194人围观）

还没有评论，来说两句吧...

相关阅读

相关从零开始 Nginx 交叉编译

交叉编译工具链： arm-poky-linux-gnueabi-gcc ./configure --prefix=/home/chad/Documents/nginx

红太狼/ 2023年02月12日 14:22/ 0 赞/ 11 阅读

相关高通华为正式宣布，专利费收定了，大家支持谁？

4G的网络运行方式已经出现了很长时间了，按照这个时代的发展速度也足够表明5G时代的即将到来，而5G作为需要超高技术实力作支撑才能掌握的一门新科技。它的出现最大的受益方就是那些实

￡神魔★判官ぃ/ 2022年12月23日 06:28/ 0 赞/ 122 阅读

相关重磅！JDK 17 发布，Oracle 宣布从 JDK 17 开始正式免费。。

-------------------- JDK 17 正式发布＋免费牛逼啊，JDK 16 刚发布半年（2021/03/16），JDK 17 又如期而至（2021/0

- 日理万妓/ 2022年09月12日 02:52/ 0 赞/ 1371 阅读

相关重磅！JDK 17 发布，Oracle 宣布从 JDK 17 开始正式免费。。

点击关注公众号，Java干货及时送达![56858250a5919110d7b3fc2ceefa911e.png][] 上一版：[JDK 16 正式发布，一次性发布 17 个

待我称王封你为后i/ 2022年08月28日 14:43/ 0 赞/ 243 阅读

相关 nginx 配置从零开始

作为一个 nginx 的初学者记录一下从零起步的点滴。基本概念 Nginx 最常的用途是提供反向代理服务，那么什么反向代理呢？正向代理相信很多大陆同胞都在这片神奇的土

ゝ一世哀愁。/ 2022年08月21日 06:37/ 0 赞/ 181 阅读

相关 nginx 配置从零开始

作为一个 nginx 的初学者记录一下从零起步的点滴。基本概念 Nginx 最常的用途是提供反向代理服务，那么什么反向代理呢？正向代理相信很多大陆同胞都在这片神奇的土

╰半夏微凉°/ 2022年08月08日 13:45/ 0 赞/ 192 阅读

相关 NVIDIA正式宣布CUDA 6.0：支持统一寻址！

NVIDIA于2013-12-27正式宣布了最新版并行计算开发工具CUDA 6，相比此前的CUDA 5.5有着革命性的巨大进步。 NVIDIA表示，CUDA 6可以让并行编

朴灿烈づ我的快乐病毒、/ 2022年08月08日 03:28/ 0 赞/ 201 阅读

相关 Nginx 宣布从 1.13.10 开始正式支持 gRPC

最近，NGINX在其博客宣布，Nginx 宣布从 1.13.10 开始正式支持 gRPC 如下是正文翻译：今天，我们很高兴在[NGINX 1.13.10][]上分享[g

柔光的暖阳◎/ 2022年05月28日 05:28/ 0 赞/ 195 阅读

相关 Mybatis支持GRPC protobuf

最近公司项目rpc使用Google grpc 作为rpc框架，数据传输DTO对象统一使用proto来定义，但由于DTO层的model和DAO层的model 在很大程度上是可以复

一时失言乱红尘/ 2022年05月19日 09:38/ 0 赞/ 277 阅读

相关【重磅】微软正式宣布 .NET5支持跨平台、移动开发

前言近期微软正式宣布 .NET Core 3.0 之后的下一个版本将是 .NET 5 。这将是 .NET 系列的下一个重要版本。能够使用它来开发 Windows，Lin

た入场券/ 2022年01月28日 05:07/ 0 赞/ 267 阅读