Speaker Deck
Speaker Deck Pro
Sign in
Sign up
for free
gRPCとgrpc-gatewayを フル活用したweb開発
Go Sagawa
December 04, 2019
Programming
0
20
gRPCとgrpc-gatewayを フル活用したweb開発
Go Sagawa
December 04, 2019
Tweet
Share
More Decks by Go Sagawa
See All by Go Sagawa
gosagawa
0
21
gosagawa
1
160
gosagawa
0
130
gosagawa
0
290
gosagawa
0
38
gosagawa
0
550
Other Decks in Programming
See All in Programming
yosuke_furukawa
PRO
13
3.5k
asumikan
0
280
daiki1020
0
1.1k
mizdra
7
4.7k
momofff
0
160
rishitdagli
0
170
yaamaa
0
400
hr01
1
1k
ippey
0
170
akkeylab
0
320
yumcyawiz
4
590
yamotuki
0
120
Featured
See All Featured
paulrobertlloyd
71
1.4k
dougneiner
119
7.8k
eitanlees
111
9.9k
rocio
155
11k
shpigford
165
19k
roundedbygravity
84
7.8k
bkeepers
321
53k
morganepeng
18
1.1k
andyhume
62
3.3k
skipperchong
7
660
notwaldorf
13
1.5k
zakiwarfel
88
3.3k
Transcript
gRPCとgrpc-gatewayを フル活用したweb開発 golang.tokyo #28 Dec 4, 2019 Go Sagawa and
factory,inc. @go_sagawa
About me Go Sagawa Backend engineer and factory, inc. Smartphone
app Div Twitter : @go_sagawa
構成
今日話すこと • protoをどう作成するか • grpc-gatewayをどのように活用するか grpc-gatewayの活用方法 protoをどうやって作るか?
ケース1 機能で分ける 画面数50程のアプリに対し 大まかな機能毎に10数proto 1protoに2~8API 共通で使うものが数proto
ケース1 の問題点 クライアント側もprotoからコード生成したいが、 rpcの情報が邪 魔 上手く抽象化されず、複雑になってくる
抽象化してないもの
抽象化したもの
抽象化したもの Bは他でも使うの で共通に
抽象化したもの × 書き換えが多く発生 × Bが共通で使われない × 別のprotoでC’が作れられる × 名前がかぶる ×
依存関係がわかりにくい
解決するために protoの時点で 構造化を意識してみよう!
protoを上手く構造化する
protoを上手く構造化する
改良したproto構成 画面数50程のアプリに対し 大まかな機能毎にrpc用protoと画面protoが10数 モデルprotoが50程 rpc以外はクライアント側も利用してコード生成 画面protoは極力モデルを利用する
その他のtips フォーマッタとしてclang-format を活用する
その他のtips nilになる可能性のあるユーザ定義メッセージを明示 する
その他のtips grpc-gatewayで ゼロ値も出力するように設定しておく 参考:【grpc-gateway】0, false, nullなどの値をJSON出力対象にする Https://qiita.com/cpp0302/items/2450ee93e7c5fbec28a7
その他のtips レビューをクライアント側も交えて行う →全APIモックを作り切ってから実装に入っている Backend iOS android
共通proto protoで全て表現できるのは良いですが、スキーマからAPI仕様がしれなくなるのでアン チパターンなのではと思ってます。 共通のパラメータはgRPCのメタデータでやり取りするのが良いと思います。
grpc-gatewayの活用法 単にprotobufがjsonになってデバッグしやすくなる 事がメリットではない!
grpc-gatewayの活用法 ・net.httpを利用しており、同じようにミドルウェアが かける。
grpc-gatewayの活用法 ・ログイン以外のAPIを暗号化および複合する ・メンテナンス状態にして全APIをシャットアウトする ・バージョンを判断して、強制アップデートを促す ・外部サービス(広告サービスや各種ツール)から呼ばれる、通信方式がJSONでないリ クエストの対処 ・ヘルスチェック用のAPI提供
まとめ • protoは上手く構造化して抽象化するとより活用 しやすい • grpc-gatewayはmiddlewareを使うとより強力に なる