gRPC网关

gRPC网关

注： 内容翻译自 gRPC gateway

为什么用 grpc-gateway

etcd v3 使用 gRPC 作为它的消息协议。etcd 项目包括基于 gRPC 的 Go client 和 命令行工具 etcdctl，通过 gRPC 和 etcd 集群通讯。对于不支持 gRPC 支持的语言，etcd 提供 JSON 的 grpc-gateway。这个网关提供 RESTful 代理，翻译 HTTP/JSON 请求为 gRPC 消息。

使用 grpc-gateway

网关接受 etcd 的 protocol buffer 的 JSON mapping 。注意 key 和 value 字段被定义为 byte 数组，因此必须在 JSON 中以 base64 编码.

< < COMMENT
https://www.base64encode.org/
foo is 'Zm9v' in Base64
bar is 'YmFy'
COMMENT

curl -L http://localhost:2379/v3alpha/kv/put \
	-X POST -d '{"key": "Zm9v", "value": "YmFy"}'

curl -L http://localhost:2379/v3alpha/kv/range \
	-X POST -d '{"key": "Zm9v"}'

Swagger

生成的 Swagger API 定义可以在 rpc.swagger.json 找到.

etcd API 参考

注： 内容来自 etcd API references

特别说明

这个参考文档内容实在太多，英文原文的文档是一个巨型 markdown 文件，所有内容堆在一起，长的离谱…

为了解决阅读困难的问题，我采用按照服务和方法拆分的方式，重新整理了一份 API 参考文档 并翻译，内容和原文一致，只是拆分成多节。

推荐阅读拆分的版本, 请用力戳下面的链接：

API 参考文档