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

功能介紹

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

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

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

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

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

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

grpcui安裝步驟

go get github.com/fullstorydev/grpcui

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

苦于沒有科學(xué)上網(wǎng)，所以沒能一步到位，手動(dò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的訪問(wèn)端口（隨機(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

瀏覽器訪問(wèn)

http://192.168.13.38:38075/

更新日志

變化

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

網(wǎng)頁(yè)界面

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

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

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