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

Transcript

1. 1.

   gRPCとgrpc-gatewayを フル活用したweb開発 golang.tokyo #28 Dec 4, 2019 Go Sagawa and

   factory,inc. @go_sagawa
2. 2.

   About me Go Sagawa Backend engineer and factory, inc. Smartphone

   app Div Twitter : @go_sagawa
3. 3.

   構成

4. 4.

   今日話すこと • protoをどう作成するか • grpc-gatewayをどのように活用するか grpc-gatewayの活用方法 protoをどうやって作るか？

5. 5.

   ケース1 機能で分ける 画面数50程のアプリに対し 大まかな機能毎に10数proto 1protoに2~8API 共通で使うものが数proto

6. 6.

   ケース1 の問題点 クライアント側もprotoからコード生成したいが、 rpcの情報が邪 魔 上手く抽象化されず、複雑になってくる

7. 7.

   抽象化してないもの

8. 8.

   抽象化したもの

9. 9.

   抽象化したもの Bは他でも使うの で共通に

10. 10.

    抽象化したもの × 書き換えが多く発生 × Bが共通で使われない × 別のprotoでC’が作れられる × 名前がかぶる ×

    依存関係がわかりにくい
11. 11.

    解決するために protoの時点で 構造化を意識してみよう！

12. 12.

    protoを上手く構造化する

13. 13.

    protoを上手く構造化する

14. 14.

    改良したproto構成 画面数50程のアプリに対し 大まかな機能毎にrpc用protoと画面protoが10数 モデルprotoが50程 rpc以外はクライアント側も利用してコード生成 画面protoは極力モデルを利用する

15. 15.

    その他のtips フォーマッタとしてclang-format を活用する

16. 16.

    その他のtips nilになる可能性のあるユーザ定義メッセージを明示 する

17. 17.

    その他のtips grpc-gatewayで ゼロ値も出力するように設定しておく 参考：【grpc-gateway】0, false, nullなどの値をJSON出力対象にする Https://qiita.com/cpp0302/items/2450ee93e7c5fbec28a7

18. 18.

    その他のtips レビューをクライアント側も交えて行う →全APIモックを作り切ってから実装に入っている Backend iOS android

19. 19.

    共通proto protoで全て表現できるのは良いですが、スキーマからAPI仕様がしれなくなるのでアン チパターンなのではと思ってます。 共通のパラメータはgRPCのメタデータでやり取りするのが良いと思います。

20. 20.

    grpc-gatewayの活用法 単にprotobufがjsonになってデバッグしやすくなる 事がメリットではない！

21. 21.

    grpc-gatewayの活用法 ・net.httpを利用しており、同じようにミドルウェアが かける。

22. 22.

    grpc-gatewayの活用法 ・ログイン以外のAPIを暗号化および複合する ・メンテナンス状態にして全APIをシャットアウトする ・バージョンを判断して、強制アップデートを促す ・外部サービス（広告サービスや各種ツール）から呼ばれる、通信方式がJSONでないリ クエストの対処 ・ヘルスチェック用のAPI提供　　　　

23. 23.

    まとめ • protoは上手く構造化して抽象化するとより活用 しやすい • grpc-gatewayはmiddlewareを使うとより強力に なる