介绍与环境安装

    于是我们想到了Grpc以及Grpc Gateway，这就是我们所需要的

    在正式开始我们的Grpc+Grpc Gateway实践前，我们需要先配置好我们的开发环境

    • Grpc
    • Protoc Plugin
    • Protocol Buffers
    • Grpc-gateway

    Grpc

    Google对Grpc的定义：

    也就是Grpc是一个高性能、开源的通用RPC框架，具有以下特性：

    • 强大的IDL，使用Protocol Buffers作为数据交换的格式，支持v2、v3（推荐v3）
    • 跨语言、跨平台，也就是Grpc支持多种平台和语言

    安装

    1、官方推荐（需科学上网）

    2、通过github.com

    进入到第一个$GOPATH目录（因为go get 会默认安装在第一个下）下，新建google.golang.org目录，拉取golang在github上的镜像库：

    1. cd /usr/local/go/path/src   
    3. mkdir google.golang.org
    5. cd google.golang.org/
    7. git clone https://github.com/grpc/grpc-go
    9. mv grpc-go/ grpc/

    目录结构：

    1. google.golang.org/
    2. └── grpc
    3.     ...

    而在grpc下有许多常用的包，例如：

    • ：定义了grpc所支持的元数据结构，包中方法可以对MD进行获取和处理
    • credentials：实现了所支持的各种认证凭据，封装了客户端对服务端进行身份验证所需要的所有状态，并做出各种断言
    • ：定义了grpc使用的标准错误码，可通用

    是什么

    1. go get -u github.com/golang/protobuf/protoc-gen-go

    将Protoc Plugin的可执行文件从$GOPATH中移动到$GOBIN下

    1. mv /usr/local/go/path/bin/protoc-gen-go /usr/local/go/bin/

    Protocol Buffers v3

    是什么

    Protocol Buffers是Google推出的一种数据描述语言，支持多语言、多平台，它是一种二进制的格式，总得来说就是更小、更快、更简单、更灵活，目前分别有v2、v3的版本，我们推荐使用v3

    建议可以阅读下官方文档的介绍，本系列会在使用时简单介绍所涉及的内容

    安装

    检查是否安装成功

    1. protoc --version

    如果出现报错

    1. protoc: error while loading shared libraries: libprotobuf.so.15: cannot open shared object file: No such file or directory

    则执行ldconfig后，再次运行即可成功

    为什么要执行ldconfig

    我们通过控制台输出的信息可以知道，Protocol Buffers Libraries的默认安装路径在/usr/local/lib

    1. Libraries have been installed in:
    2.    /usr/local/lib
    4. If you ever happen to want to link against installed libraries
    5. specify the full pathname of the library, or use the `-LLIBDIR'
    6. flag during linking and do at least one of the following:
    7.    - add LIBDIR to the `LD_LIBRARY_PATH' environment variable
    8.      during execution
    9.    - add LIBDIR to the `LD_RUN_PATH' environment variable
    10.      during linking
    11.    - use the `-Wl,-rpath -Wl,LIBDIR' linker flag
    12.    - have your system administrator add LIBDIR to `/etc/ld.so.conf'
    14. See any operating system documentation about shared libraries for
    15. more information, such as the ld(1) and ld.so(8) manual pages.

    而我们安装了一个新的动态链接库，ldconfig一般在系统启动时运行，所以现在会找不到这个lib，因此我们要手动执行ldconfig，让动态链接库为系统所共享，它是一个动态链接库管理命令，这就是ldconfig命令的作用

    我们按照惯例执行（查看帮助文档），我们抽出几个常用的命令进行讲解

    1、-IPATH, --proto_path=PATH：指定import搜索的目录，可指定多个，如果不指定则默认当前工作目录

    参数

    若要将额外的参数传递给插件，可使用从输出目录中分离出来的逗号分隔的参数列表:

    1. protoc --go_out=plugins=grpc,import_path=mypackage:. *.proto
    • import_prefix=xxx：将指定前缀添加到所有import路径的开头
    • import_path=foo/bar：如果文件没有声明go_package，则用作包。如果它包含斜杠，那么最右边的斜杠将被忽略。
    • plugins=plugin1+plugin2：指定要加载的子插件列表（我们所下载的repo中唯一的插件是grpc）
    • Mfoo/bar.proto=quux/shme： M参数，指定.proto文件编译后的包名（foo/bar.proto编译后为包名为quux/shme）

    Grpc支持

    如果proto文件指定了RPC服务，protoc-gen-go可以生成与grpc相兼容的代码，我们仅需要将plugins=grpc参数传递给--go_out，就可以达到这个目的

    是什么

    grpc-gateway是protoc的一个插件。它读取gRPC服务定义，并生成一个反向代理服务器，将RESTful JSON API转换为gRPC。此服务器是根据gRPC定义中的自定义选项生成的。

    安装

    1. go get -u github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway

    如果出现以下报错，我们分析错误提示可得知是连接超时（大概是被墙了）

    1. package google.golang.org/genproto/googleapis/api/annotations: unrecognized import path "google.golang.org/genproto/googleapis/api/annotations" (https fetch: Get https://google.golang.org/genproto/googleapis/api/annotations?go-get=1: dial tcp 216.239.37.1:443: getsockopt: connection timed out)

    有两种解决方法，

    1、科学上网

    2、通过github.com

    进入到第一个$GOTPATH目录的google.golang.org目录下，拉取genproto在github上的go-genproto镜像库：

    1. cd /usr/local/go/path/src/google.golang.org
    3. git clone https://github.com/google/go-genproto.git
    5. mv go-genproto/ genproto/

    在安装完毕后，我们将grpc-gateway的可执行文件从$GOPATH中移动到$GOBIN

    1. mv /usr/local/go/path/bin/protoc-gen-grpc-gateway /usr/local/go/bin/

    到这里我们这节就基本完成了，建议多反复看几遍加深对各个组件的理解！

    参考