grpcui是一款非常不錯的命令行工具，可以讓你通過瀏覽器與gRPC服務(wù)器交互。它有點(diǎn)像Postman，不過是針對gRPC APIs而不是REST，在某些方面，它就像grpcurl的擴(kuò)展。grpcurl是一個命令行界面，而grpcui則提供了一個基于Web/瀏覽器的GUI。這讓你可以交互式地構(gòu)建請求以發(fā)送到gRPC服務(wù)器。歡迎需要此款工具的朋友前來下載使用。

功能介紹

grpcui 支持各種 RPC 方法，包括流式方法。但是，它要求你一次性構(gòu)造整個請求消息流，然后一次性渲染整個結(jié)果的響應(yīng)消息流（所以你不能像grpcurl那樣與雙向流交互）。

grpcui支持純文本服務(wù)器和TLS服務(wù)器，并且有許多TLS配置選項(xiàng)。它還支持相互的TLS，即客戶端需要出示客戶端證書。

如上所述，如果服務(wù)器支持反射服務(wù)，grpcui就可以無縫工作。如果不支持，你可以提供.proto源文件，也可以向grpcui提供protoset文件（包含編譯后的描述符，由protoc產(chǎn)生）。

web UI除了定義請求消息數(shù)據(jù)外，還允許你設(shè)置請求元數(shù)據(jù)。在定義請求消息數(shù)據(jù)時(shí)，它使用動態(tài)的HTML表單，支持所有可能的protobuf消息的數(shù)據(jù)輸入，包括對知名類型（如google.protobuf.Timestamp）、one ofs和地圖的豐富支持。

除了通過HTML形式輸入數(shù)據(jù)外，還可以以JSON格式輸入數(shù)據(jù)，將整個JSON請求體鍵入或粘貼到文本表單中。

發(fā)出RPC后，Web UI會顯示所有g(shù)RPC響應(yīng)元數(shù)據(jù)，包括服務(wù)器發(fā)送的頭和預(yù)告片。當(dāng)然，它還會以HTML表格的形式顯示一個人類可以理解的響應(yīng)體。

grpcui安裝步驟

go get github.com/fullstorydev/grpcui

go install github.com/fullstorydev/grpcui/cmd/grpcui

苦于沒有科學(xué)上網(wǎng)，所以沒能一步到位，手動下載部分依賴，記錄如下：

//安裝go環(huán)境

yum install go

mkdir gopath

export GOPATH=/home/xiaofeng/gopath/

//go get 安裝部分

export GOPROXY=https://mirrors.aliyun.com/goproxy/

go get github.com/golang/protobuf

go get github.com/fullstorydev/grpcui

//git clone安裝部分

cd github.com/envoyproxy

git clone https://github.com/envoyproxy/go-control-plane.git

mkdir golang.org/x -p

cd golang.org/x

git clone https://github.com/golang/net.git

git clone https://github.com/golang/text.git

git clone https://github.com/golang/sys.git

git clone https://github.com/golang/oauth2.git

mkdir google.golang.org

cd google.golang.org/

git clone https://github.com/protocolbuffers/protobuf-go.git

mv protobuf-go protobuf

git clone https://github.com/googleapis/go-genproto.git

mv go-genproto/ genproto

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

mv grpc-go/ grpc

mkdir cloud.google.com

cd cloud.google.com/

git clone https://github.com/googleapis/google-cloud-go.git

mv google-cloud-go/ go

使用

//連接本地的50051grpc服務(wù)端口，綁定192.168.13.38建立grpcui的訪問端口（隨機(jī)）

#grpcui -bind 192.168.13.38 -plaintext 127.0.0.1:50051

gRPC Web UI available at http://192.168.13.38:38075/

note：注意關(guān)閉防火墻

systemctl disable firewalld

瀏覽器訪問

http://192.168.13.38:38075/

更新日志

變化

這個版本包括對Web UI中的一個BUG的修復(fù)，對從源代碼構(gòu)建grpcui的用戶的一個小修復(fù)，以及一些新功能。

網(wǎng)頁界面

這些變化影響了命令行工具和 Go 包的使用。

UI現(xiàn)在除了 "請求"、"原始請求 "和 "響應(yīng) "選項(xiàng)卡外，還包括一個新的選項(xiàng)卡："歷史 "選項(xiàng)卡。當(dāng)RPC被調(diào)用時(shí)，這將把請求的細(xì)節(jié)存儲到瀏覽器本地存儲中。然后，用戶可以從這個選項(xiàng)卡中查看RPC的歷史記錄，并選擇一個重新運(yùn)行。

當(dāng)試圖將元素（通過綠色 "+"按鈕）添加到重復(fù)或地圖字段中時(shí)，在另一個地圖字段的值內(nèi)嵌套時(shí)，會發(fā)生運(yùn)行時(shí)錯誤。這一點(diǎn)已得到修正。