gRPCとgrpc-gatewayを フル活用したweb開発

Transcript

1. gRPCとgrpc-gatewayを フル活用したweb開発 golang.tokyo #28 Dec 4, 2019 Go Sagawa and factory,inc. @go_sagawa
2. About me Go Sagawa Backend engineer and factory, inc. Smartphone app Div Twitter : @go_sagawa
3. 構成
4. 今日話すこと • protoをどう作成するか • grpc-gatewayをどのように活用するか grpc-gatewayの活用方法 protoをどうやって作るか？
5. ケース1 機能で分ける 画面数50程のアプリに対し 大まかな機能毎に10数proto 1protoに2~8API 共通で使うものが数proto
6. ケース1 の問題点 クライアント側もprotoからコード生成したいが、 rpcの情報が邪 魔 上手く抽象化されず、複雑になってくる
7. 抽象化してないもの
8. 抽象化したもの
9. 抽象化したもの Bは他でも使うの で共通に
10. 抽象化したもの × 書き換えが多く発生 × Bが共通で使われない × 別のprotoでC’が作れられる × 名前がかぶる × 依存関係がわかりにくい
11. 解決するために protoの時点で 構造化を意識してみよう！
12. protoを上手く構造化する
13. protoを上手く構造化する
14. 改良したproto構成 画面数50程のアプリに対し 大まかな機能毎にrpc用protoと画面protoが10数 モデルprotoが50程 rpc以外はクライアント側も利用してコード生成 画面protoは極力モデルを利用する
15. その他のtips フォーマッタとしてclang-format を活用する
16. その他のtips nilになる可能性のあるユーザ定義メッセージを明示 する
17. その他のtips grpc-gatewayで ゼロ値も出力するように設定しておく 参考：【grpc-gateway】0, false, nullなどの値をJSON出力対象にする Https://qiita.com/cpp0302/items/2450ee93e7c5fbec28a7
18. その他のtips レビューをクライアント側も交えて行う →全APIモックを作り切ってから実装に入っている Backend iOS android
19. 共通proto protoで全て表現できるのは良いですが、スキーマからAPI仕様がしれなくなるのでアン チパターンなのではと思ってます。 共通のパラメータはgRPCのメタデータでやり取りするのが良いと思います。
20. grpc-gatewayの活用法 単にprotobufがjsonになってデバッグしやすくなる 事がメリットではない！
21. grpc-gatewayの活用法 ・net.httpを利用しており、同じようにミドルウェアが かける。
22. grpc-gatewayの活用法 ・ログイン以外のAPIを暗号化および複合する ・メンテナンス状態にして全APIをシャットアウトする ・バージョンを判断して、強制アップデートを促す ・外部サービス（広告サービスや各種ツール）から呼ばれる、通信方式がJSONでないリ クエストの対処 ・ヘルスチェック用のAPI提供　　　　
23. まとめ • protoは上手く構造化して抽象化するとより活用 しやすい • grpc-gatewayはmiddlewareを使うとより強力に なる