gRPC ハンズオン

まずはこのあたりを一通り実施して雰囲気を掴みます。

公式チュートリアル:

クイックスタート（helloworld サンプル）:

helloworld サンプル:

Protocol Buffer Compiler (protoc)

protoc をコマンドラインで実行する際には、カレントディレクトリ、.proto ファイル、モジュールの生成先の位置関係に気をつけてパラメータを指定する必要があります。特に -I パラメータの特殊な指定方法 (e.g. -Igrpc/example/custom/path=../../protos) についてはコマンドのヘルプ (-h) にも載っていないので、下記ページの Generating gRPC interfaces with custom package path セクションにある貴重な例を参考にしてください。

Python 用 protoc の使い方の説明:

サーバのマルチプロセス対応

gRPC サーバは ThreadPoolExecutor を使ってマルチスレッドで起動することになっていますが、これを単純に ProcessPoolExecutor に置き換えることではマルチプロセス対応ができません。
まずサブプロセスを必要な数だけ fork してから、通常の ThreadPoolExecutor を使って gRPC サーバを起動する方法がよいとされています。

Multiprocessing のサンプル:

コマンドラインでリクエストを送る (grpcurl)

grpcurl は gRPC サーバに直接リクエストを送信できるコマンドラインツールで、開発時に便利です。

grpcurl からリクエストを送る際に .proto ファイルを指定しなくていいように、gRPC サーバで server reflection という機能を有効にしておくのがおすすめです。

Server reflection 機能を有効にするサンプル:

Cloud Run 上で動作させる

デプロイ時に HTTP/2 を有効にすることや、クライアント・エッジロードバランサ・サーバのインスタンス間の関係に注意する必要があります。

OpenTelemetry 対応（モニタリング）

トレースコンテキストは、ヘッダの traceparent に格納することが推奨されています。gRPC では HTTP/2 ヘッダのことを metadata と呼んでいます。

カスタム metadata を使用するサンプル:

gRPC Keepalive について

別記事にしました。