Transrate gRPC #5

chaspy · 2020-03-27T15:01:46Z

chaspy · 2020-03-27T15:03:19Z

content/grpc.md

@@ -4,20 +4,19 @@ publishDate: "2019-12-31"
 categories: ["Traffic Management"]
 ---

-[gRPC](https://grpc.io/) is a communication protocol for services, built on [HTTP/2](https://www.cncf.io/blog/2018/08/31/grpc-on-http-2-engineering-a-robust-high-performance-protocol/). Unlike REST over HTTP/1, which is based on [resources](https://en.wikipedia.org/wiki/Representational_state_transfer), gRPC is based on [Service Definitions](https://grpc.io/docs/guides/concepts/). You specify service definitions in a format called [protocol buffers](https://developers.google.com/protocol-buffers/) ("proto"), which can be serialized into an small binary format for transmission.
+[gRPC](https://grpc.io/) はサービス間通信のプロトコルで、[HTTP/2](https://www.cncf.io/blog/2018/08/31/grpc-on-http-2-engineering-a-robust-high-performance-protocol/) 上で動作します。[resources](https://en.wikipedia.org/wiki/Representational_state_transfer) ベースの HTTP/1 上で動作する REST と異なり、gRPC は [Service Definitions](https://grpc.io/docs/guides/concepts/) ベースです。伝達のための小さなバイナリフォーマットへシリアライズすることができる [protocol buffers](https://developers.google.com/protocol-buffers/) ("proto") と呼ばれるフォーマットで service definitions を指定します。


for transmission の訳に迷いました。「伝達のための」って硬いですよね。とっちゃってもいいかなと思いつつ、意見を伺いたいです。

ここに限らずですが、Link が張られている用語 - Service Definitions などを訳すか迷いました。下手に用語を下手に訳すのも逆に分かりづらいと思い。。。

for transmission

データの通信や永続化のため とかはどうですかね(from wikipedia)

chaspy · 2020-03-27T15:05:01Z

content/grpc.md


-While gRPC supports some networking use cases like [TLS](https://grpc.io/docs/guides/auth/) and [client-side load balancing](https://grpc.io/blog/loadbalancing/), adding Istio to a gRPC architecture can be useful for collecting telemetry, adding traffic rules, and setting [RPC-level authorization](https://istio.io/blog/2018/istio-authorization/#rpc-level-authorization). Istio can also provide a useful management layer if your traffic is a mix of HTTP, TCP, gRPC, and database protocols, because you can use the same Istio APIs for all traffic types.
+gRPC が [TLS](https://grpc.io/docs/guides/auth/) や [client-side load balancing](https://grpc.io/blog/loadbalancing/) のようなユースケースをサポートする一方、それに加えて Istio を gRPC アーキテクチャへ組み込むことはメトリクスの収集、トラフィックルールの追加、[RPC-level authorization](https://istio.io/blog/2018/istio-authorization/#rpc-level-authorization) といった利点があります。すべてのトラフィックタイプに同一の Istio API を使用できるため、トラフィックが HTTP, TCP, gRPC, そして データベースプロトコルの間で混在している場合でも、Istio は 便利な管理レイヤーを追加できます。


最後の文の訳が難しかったです。

Istio は便利な管理レイヤーを追加できます。

なにかいい案があればおねがいします。

あえてセンテンスを２つに分けてみるのはどうでしょうか？

gRPC が (略) のようなユースケースをサポートする一方、それに加えて Istio を gRPC アーキテクチャへ組み込むことは (略) といった利点があります。

→

gRPC は (略) のようなユースケースをサポートしています。さらに gRPC のアーキテクチャに Istio を組み込むことは (略) といった利点があります。

chaspy · 2020-03-27T15:05:39Z

content/grpc.md


 ![](/images/grpc-server-healthy.png)

-Then, we can apply an Istio traffic rule to inject a 10-second delay [fault](https://istio.io/docs/tasks/traffic-management/fault-injection/) into `server`. You might apply this rule in a chaos testing scenario, to test the resiliency of this application.
+また、10秒の delay [fault](https://istio.io/docs/tasks/traffic-management/fault-injection/) を `server` へ挿入するための Istio のトラフィックルールを適用できます。アプリケーションの回復性をテストするために、カオステストシナリオでこのルールを適用できるかもしれません。


delay fault、遅延故障にすべきですかね、、、

faultを残すのであれば 10秒遅延させる [fault] とかでどうでしょう？

chaspy · 2020-03-27T15:06:19Z

@t-ide @sakajunquality
Please review 🙏

sakajunquality · 2020-03-27T15:23:21Z

content/grpc.md


-With gRPC, you can generate boilerplate code from `.proto` files into [multiple programming languages](https://grpc.io/docs/quickstart/), making gRPC an ideal choice for polyglot microservices.
+gRPC では、`.proto` ファイルから [multiple programming languages](https://grpc.io/docs/quickstart/) へのボイラープレートコードを生成することができます。このため、gRPC は polyglot microservices のための理想的な選択となるでしょう。


polyglot microservices

この文脈だと、（プログラミングの）多言語でのマイクロサービスくらいに訳してしまってもいいかと思いました

gRPC では、 この部分ですが、日本語だと、がここにはなくても自然かなーと思いました

sakajunquality · 2020-03-27T15:39:45Z

content/grpc.md


 ![grpc](/images/grpc.png)

-Here, we're running two gRPC Services, `client` and `server`. `client` makes an RPC call to the `server`'s `/SayHello` function every 2 seconds.
+このように、`client` と `server` の2つの gRPC サービスがあります。`client` は RPC コールを `server` の `/SayHello` function へ2秒ごとに行います。


function は訳したほうがよさそうです

sakajunquality · 2020-03-27T15:46:42Z

content/grpc.md

@@ -64,11 +63,10 @@ spec:
        subset: v1
 ```

-This causes the client RPC to time out (`Outgoing Request Duration`):
+これは client RPC にタイムアウト(`Outgoing Request Duration`)を起こします。


これにより(略) とかのほうが流れが読みやすいかも？

sakajunquality · 2020-03-27T15:59:05Z

@chaspy ざっとコメントしたであります

content/grpc.md

chaspy · 2020-03-27T18:01:21Z

@sakajunquality レビューありがとうございました、反映しました！

@t-ide
一応認識合わせしたいので一度みてもらって、よさそうならマージお願いします！

t-ide · 2020-03-28T07:40:59Z

@chaspy @sakajunquality

ありがとうございます！

反応遅れて申し訳ないのですが，個人的にリンクが貼られている文章が「リンク先タイトル」や「技術用語」以外なら，リンクが貼られている用語も訳した方が見やすいように思うのですが如何でしょう。

例えば，

multiple programming languages へのボイラープレートコードを生成することができます。
→複数プログラミング言語のボイラープレートコードを生成することができます。

のようなイメージです。翻訳ポリシー次第だと思うので，ご意見いただければなと。

それ以外は大丈夫だと思います！！

sakajunquality · 2020-03-30T10:19:08Z

@t-ide @chaspy
リンク先が日本語になっていたら日本語にするのが良さそうですね！

t-ide · 2020-03-31T03:02:03Z

@sakajunquality
リンク先に日本語版があれば（wikipediaやprotocol bufferなど）日本語版にリンクを貼ると良い，という解釈で良いでしょうか。

日本語版があるリンクを洗い出してみます。

t-ide · 2020-03-31T03:22:45Z

content/grpc.md

[Blog post - gRPC + Istio + Cloud Internal Load Balancer](https://cloud.google.com/solutions/using-istio-for-internal-load-balancing-of-grpc-services)
→[ブログ - Istio を使用して内部 gRPC サービスを負荷分散する](https://cloud.google.com/solutions/using-istio-for-internal-load-balancing-of-grpc-services?hl=ja)

ちょうどこんな感じです！！ @t-ide

リンク先に日本語版があるかどうかを探すのが若干面倒ですね 😅

istio.io 日本語はないはず

en.wikipedia.org 日本語あるかも

www.cncf.io/blog

developers.google.com あるかも

grpc.io/blog あるかも？

www.envoyproxy.io/docs ないと思う

cloud.google.com ^で書いてくれてるようにある

Addressed 👍
2fa883b

Wiki にも追加しました。
https://github.com/istiobyexample-ja/istiobyexample/wiki/Home/_compare/303be7febbd1d7111cb2622e8d55890b125d50b1...d0549e645380e4a59e6c00f60a0865df5adb3e5d

t-ide · 2020-03-31T03:33:28Z

content/grpc.md


-With gRPC, you can generate boilerplate code from `.proto` files into [multiple programming languages](https://grpc.io/docs/quickstart/), making gRPC an ideal choice for polyglot microservices.
+gRPC では `.proto` ファイルから [multiple programming languages](https://grpc.io/docs/quickstart/) へのボイラープレートコードを生成することができます。このため、gRPC は 多言語での microservices のための理想的な選択となるでしょう。


[protocol buffers](https://developers.google.com/protocol-buffers/)
→[protocol buffers](https://developers.google.com/protocol-buffers?hl=ja)
現状ほとんど和訳されてませんが，一応...

[resources](https://en.wikipedia.org/wiki/Representational_state_transfer)
→ [resources](https://ja.wikipedia.org/wiki/Representational_State_Transfer)
説明の構成は異なりますが，大まかな意味は同じですし，英語版には無いRPCへの言及もありますので，個人的には日本語版リンクにしても良いと思います。英語版の方が妥当と判断されたらこのままで結構です。

日本語版が Outdated じゃないかどうかだけ気になりますねえ。まぁそうであればそっちはそっちで原点にあたってもらえればいいんですが。ちょっと中身確認して判断します。

2件とも対応しました 👍
d9d1a4c
52109e1

sakajunquality · 2020-04-05T03:51:43Z

LGTMed

Transrate gRPC

bb6bc38