はじめに
最近マイクロサービスが流行っていますが、システムを分割するようなアーキテクチャだと、APIの構築で考慮することがたくさんあります。
- データモデル(JSON, XML, Binary)
- エンドポイント
- 呼び出し方
- エラーハンドリング
- APIの効率(1回の呼び出しでどれくらいのデータを取得するか)
- レイテンシー
- スケーラビリティ
- ロードバランシング
- 多言語に対する内部の操作性
- 認証、監視、ロギング
APIで最も一般的なのはRESTですが、Goを採用してマイクロサービスを開発している会社だと大体gRPCを使っているという話を聞きました。
最近Goを勉強し始めたので、今後のためにgRPCとその周辺知識を調べてまとめました。
gRPCとは
gRPCは、RPC(クライアントがサーバのプログラムをネットワーク経由で呼び出して実行するプロトコル)を実現するために、Googleで開発されたオープンソースのフレームワークです。
Protocol Bufferを使ってデータをシリアライズし、高速な通信を実現することができます。
また、gRPCでは、Protocol Bufferを使ってmessageやserviceなどのAPI仕様を.protoファイルに定義する必要があります。
.protoファイルは様々な言語に対応しており、サーバとクライアントで必要なソースコードのひな形をそれぞれ生成することができます。
そのため、これを活用することで、多言語でつくられているようなマイクロサービスをより簡単につくることができるようになります。
Protocol Bufferを使う理由
gRPCでProtocol Bufferを使用するのには以下の理由があります。
- 言語に依存せずコードを生成できる
- データをバイナリで扱い効率的にシリアライズできる
- たくさんのデータを運ぶのに便利
- APIの追加が楽
Protocol BufferでAPIのスキーマを考える際は、データとリクエストレスポンスはmessage、RPCのエンドポイントはserviceで定義します。
データをシリアライズする際、JSONだとテキストフォーマットで読みやすい代わりに、パースする際にCPUのリソースを使います。
一方、Protocol Bufferはバイナリフォーマットで機械語の表現に近いため、サイズが小さい上にCPUのリソース消費もJSONほど高くありません。
したがって、gRPCでProtocol Bufferを使うことで、スマホのように性能の低いCPUの端末でも、ネットワーク帯域を節約した効率的で速い通信、およびシリアライズを行うことができます。
HTTP/2とは
HTTP/2(RFC7540)では、従来のHTTPを踏襲しながら、以下のように既存の問題点を解決してネットワークリソースの効率化を実現します。
- レイテンシーの削減(1つのTCP接続で並列処理を実現)
- ラウンドトリップの削減(サーバプッシュでクライアントの1回リクエストに対して複数のレスポンスを返す)
- 送受信のデータ量の削減(バイナリデータを使用)
- パケットサイズの縮小(ヘッダ圧縮)
- セキュア(SSLデフォルト)
なお、WebサーバとWebブラウザがHTTP/2に対応していれば自動的にHTTP/2の通信を行うため、利用者側がHTTP/2を意識する必要はありません。
gRPCの特長
gRPCにはいくつかの特長があります。
スケーラビリティ
gRPCでは、サーバはデフォルトで非同期処理を行います。
つまり、リクエストがきてもスレッドをブロックしないため、並列に万単位のリクエストを受けることができます。
一方、クライアントでは必要なパフォーマンスによって非同期処理と同期処理のどちらかを選択します。
セキュリティ
gRPCではデフォルトでSSLの使用が推奨されます。
また、Interceptorを用いた認証制御も行うことができます。
様々なAPIのタイプ
gRPCにはAPIのタイプがいくつかあります。
Unaryは、RESTのように1つのリクエストに対して1つのレスポンスがサーバから返ってくるようなAPIのタイプです。
~Streamingのものが、リクエストやレスポンスが複数で返ってくるようなタイプとなります。
各APIの定義をProtocol Bufferで定義すると以下のようになります。
リクエストとレスポンスの前にstreamとつけることで、Streamingに対応します。
RESTとの比較
RESTと比較すると以下のようになります。
| gRPC | REST | |
|---|---|---|
| スキーマ | Protocol Buffer | JSON |
| プロトコル | HTTP/2(低レイテンシー) | HTTP1.1(高レイテンシー) |
| APIタイプ1 | 双方向+非同期 | クライアント→サーバ |
| APIタイプ2 | Stream対応 | Request/Response |
| APIタイプ3 | API志向 | CRUD志向(POST/GET/PUT/DELETE) |
| コード生成 | Protocol Buffer | OpenAPI/Swagger |
参考資料