基礎(chǔ):
GRPC的產(chǎn)生動機和設(shè)計原則
grpc| python 實戰(zhàn) grpc
Python版gRPC入門實驗 - 知乎
google grpc 簡介及官網(wǎng)的快速入門
gRPC + Python 入門到生產(chǎn)環(huán)境
文檔:
gRPC官方文檔
gRPC官方文檔中文版
細節(jié):
gRPC Python 源碼淺析 - Basic
gRPC學習筆記
awesome-grpc - 目前可用于gRPC的大量資源
實踐:
Our experience designing and building gRPC services
視頻:Introduction to gRPC: A general RPC framework that puts mobile and HTTP/2 first by Mete Atamel
正如其他 RPC 系統(tǒng)诀紊,gRPC 基于如下思想:定義一個服務(wù)夜矗, 指定其可以被遠程調(diào)用的方法及其參數(shù)和返回類型。gRPC 默認使用 protocol buffers 作為接口定義語言府怯,來描述服務(wù)接口和有效載荷消息結(jié)構(gòu)。如果有需要的話讹挎,可以使用其他替代方案。
需要語言支持 HTTP/2吆玖,protobuf 等
通信方式
根據(jù)不同的業(yè)務(wù)場景, grpc 支持 4 種通信方式:
- 客服端一次請求, 服務(wù)器一次應(yīng)答
- 客服端一次請求, 服務(wù)器多次應(yīng)答(流式)
- 客服端多次請求(流式), 服務(wù)器一次應(yīng)答
- 客服端多次請求(流式), 服務(wù)器多次應(yīng)答(流式)
服務(wù)端server
GRPC的Client與Server筒溃,均通過Channel作為數(shù)據(jù)通信,序列化沾乘、反序列化則使用Protobuf怜奖,每個請求都將被封裝成HTTP2的Stream,在整個生命周期中翅阵,客戶端Channel應(yīng)該保持長連接歪玲,而不是每次調(diào)用重新創(chuàng)建Channel、響應(yīng)結(jié)束后關(guān)閉Channel(即短連接怎顾、交互式的RPC)读慎,目的就是達到鏈接的復(fù)用,進而提高交互效率槐雾。
服務(wù)端主要流程:
1. 實例化Server
2. 注冊Service
3. 監(jiān)聽并接收連接請求
4. 連接與請求處理
5. 連接的處理細節(jié)(http2連接的建立)
6. 新請求的處理細節(jié)(新流的打開和幀數(shù)據(jù)的處理)
Server端接收到客戶端建立的連接后,使用一個goroutine(golang)專門處理此客戶端的連接(即一個tcp連接或者說一個http2連接)幅狮,所以同一個grpc客戶端連接上服務(wù)端后募强,后續(xù)的請求都是通過同一個tcp連接。
客戶端和服務(wù)端的連接在應(yīng)用層由Transport抽象(類似通常多路復(fù)用實現(xiàn)中的封裝的channel)崇摄,在客戶端是ClientTransport擎值,在服務(wù)端是ServerTransport。Server端接收到一個客戶端的http2請求后即打開一個新的流逐抑,ClientTransport和ServerTransport之間使用這個新打開的流以http2幀的形式交換數(shù)據(jù)鸠儿。
對于返回單個應(yīng)答的 RPC 方法("response-unary" 方法),gRPC Python 同時支持同步(阻塞)和異步(非阻塞)的控制流語義。對于應(yīng)答流式 RPC 方法进每,調(diào)用會立即返回一個應(yīng)答值的迭代器汹粤。調(diào)用迭代器的 next() 方法會阻塞,直到從迭代器產(chǎn)生的應(yīng)答變得可用田晚。
客戶端client
grpc客戶端調(diào)用服務(wù)器端最重要的三個步驟:
1. 創(chuàng)建連接到遠程服務(wù)器的 channel
2. 構(gòu)建使用該channel的客戶端stub
3. 調(diào)用服務(wù)方法嘱兼,執(zhí)行RPC調(diào)用
Channel 到概念上的端點的虛擬連接,用于執(zhí)行RPC贤徒。 通道可以根據(jù)配置芹壕,負載等自由地實現(xiàn)與端點零或多個實際連接。通道也可以自由地確定要使用的實際端點接奈,并且可以在每次 RPC 上進行更改踢涌,從而允許客戶端負載平衡。應(yīng)用程序通常期望使用存根(stub)序宦,而不是直接調(diào)用這個類斯嚎。
可以使用使用grpc-gateway生成一個反向代理,將接收的RESTful JSON API 轉(zhuǎn)化為 gRPC
在創(chuàng)建客戶端存根時挨厚,一個 gRPC channel提供一個特定主機和端口服務(wù)端的連接堡僻。客戶端可以通過指定channel參數(shù)來修改 gRPC 的默認行為疫剃,比如打開關(guān)閉消息壓縮钉疫。一個channel具有狀態(tài),包含已連接和空閑 巢价。gRPC 如何處理關(guān)閉channel是語言相關(guān)的牲阁。有些語言可允許詢問channel狀態(tài)。
如何調(diào)試gRPC服務(wù)
當我們開始使用gRPC時壤躲,可用的測試工具是有限的城菊。開發(fā)人員想要將他們的端點合并起來,但使用gRPC等同于熟悉的工具(例如postman)或者不存在或不太成熟碉克。這些工具需要使用適當?shù)膒rotobuf文件支持編碼和解碼消息凌唬,并且能夠支持HTTP / 2。您實際上可以直接鏈接gRPC端點漏麦,但這遠不是簡化的流程客税。我們遇到的一些有用的工具是:
protoc-gen-lint,用于protobufs的linting - 此工具可檢查Google協(xié)議緩沖區(qū)樣式指南中的任何偏差撕贞。我們將此作為構(gòu)建流程的一部分更耻,以執(zhí)行編碼標準并捕獲基本錯誤。這對發(fā)現(xiàn)無效的消息結(jié)構(gòu)和拼寫錯誤很有用捏膨。
grpcc秧均,gRPC服務(wù)器的CLI - 這使用Node REPL通過protobuf文件與gRPC服務(wù)進行交互食侮,對于快速測試端點非常有用。
omgrpc目胡,GUI客戶端 - 描述為gRPC端點的Postman锯七,該工具提供了一種可視化的方式來與您的gRPC服務(wù)進行交互。