Grpc+Grpc Gateway实践一 介绍与环境安装
介绍与环境安装
假定我们有一个项目需求,希望用Rpc
作为内部API
的通讯,同时也想对外提供Restful Api
,写两套又太繁琐不符合
于是我们想到了Grpc
以及Grpc Gateway
,这就是我们所需要的
准备环节
在正式开始我们的Grpc
+Grpc Gateway
实践前,我们需要先配置好我们的开发环境
- Grpc
- Protoc Plugin
- Protocol Buffers
- Grpc-gateway
Grpc
是什么
Google对Grpc
的定义:
A high performance, open-source universal RPC framework
也就是Grpc
是一个高性能、开源的通用RPC框架,具有以下特性:
- 强大的
IDL
,使用Protocol Buffers
作为数据交换的格式,支持v2
、v3
(推荐v3
) - 跨语言、跨平台,也就是
Grpc
支持多种平台和语言 - 支持HTTP2,双向传输、多路复用、认证等
安装
1、官方推荐(需科学上网)
go get -u google.golang.org/grpc
2、通过github.com
进入到第一个$GOTPATH目录(因为go get
会默认安装在第一个下)下,新建google.golang.org
目录,拉取golang
在github
上的镜像库:
cd /usr/local/go/path/src mkdir google.golang.orgcd google.golang.org/git clone https://github.com/grpc/grpc-gomv grpc-go/ grpc/
目录结构:
google.golang.org/
└── grpc...
而在grpc
下有许多常用的包,例如:
- metadata:定义了
grpc
所支持的元数据结构,包中方法可以对MD
进行获取和处理 - credentials:实现了
grpc
所支持的各种认证凭据,封装了客户端对服务端进行身份验证所需要的所有状态,并做出各种断言 - codes:定义了
grpc
使用的标准错误码,可通用
Protoc Plugin
是什么
编译器插件
安装
go get -u github.com/golang/protobuf/protoc-gen-go
将Protoc Plugin
的可执行文件从$GOPATH中移动到$GOBIN下
mv /usr/local/go/path/bin/protoc-gen-go /usr/local/go/bin/
Protocol Buffers v3
是什么
Protocol buffers are a flexible, efficient, automated mechanism for serializing structured data – think XML, but smaller, faster, and simpler. You define how you want your data to be structured once, then you can use special generated source code to easily write and read your structured data to and from a variety of data streams and using a variety of languages. You can even update your data structure without breaking deployed programs that are compiled against the "old" format.
Protocol Buffers
是Google
推出的一种数据描述语言,支持多语言、多平台,它是一种二进制的格式,总得来说就是更小、更快、更简单、更灵活,目前分别有v2
、v3
的版本,我们推荐使用v3
- proto2 文档地址
- proto3 文档地址
建议可以阅读下官方文档的介绍,本系列会在使用时简单介绍所涉及的内容
安装
wget https://github.com/google/protobuf/releases/download/v3.5.1/protobuf-all-3.5.1.zip
unzip protobuf-all-3.5.1.zip
cd protobuf-3.5.1/
./configure
make
make install
检查是否安装成功
protoc --version
如果出现报错
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
Libraries have been installed in:/usr/local/libIf you ever happen to want to link against installed libraries
in a given directory, LIBDIR, you must either use libtool, and
specify the full pathname of the library, or use the `-LLIBDIR'
flag during linking and do at least one of the following:- add LIBDIR to the `LD_LIBRARY_PATH' environment variableduring execution- add LIBDIR to the `LD_RUN_PATH' environment variableduring linking- use the `-Wl,-rpath -Wl,LIBDIR' linker flag- have your system administrator add LIBDIR to `/etc/ld.so.conf'See any operating system documentation about shared libraries for
more information, such as the ld(1) and ld.so(8) manual pages.
而我们安装了一个新的动态链接库,ldconfig
一般在系统启动时运行,所以现在会找不到这个lib
,因此我们要手动执行ldconfig
,让动态链接库为系统所共享,它是一个动态链接库管理命令,这就是ldconfig
命令的作用
protoc使用
我们按照惯例执行protoc --help
(查看帮助文档),我们抽出几个常用的命令进行讲解
1、-IPATH, --proto_path=PATH
:指定import
搜索的目录,可指定多个,如果不指定则默认当前工作目录
2、--go_out
:生成golang
源文件
参数
若要将额外的参数传递给插件,可使用从输出目录中分离出来的逗号分隔的参数列表:
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
,就可以达到这个目的
protoc --go_out=plugins=grpc:. *.proto
Grpc-gateway
是什么
grpc-gateway is a plugin of protoc. It reads gRPC service definition, and generates a reverse-proxy server which translates a RESTful JSON API into gRPC. This server is generated according to custom options in your gRPC definition.
grpc-gateway是protoc的一个插件。它读取gRPC服务定义,并生成一个反向代理服务器,将RESTful JSON API转换为gRPC。此服务器是根据gRPC定义中的自定义选项生成的。
安装
go get -u github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway
如果出现以下报错,我们分析错误提示可得知是连接超时(大概是被墙了)
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
进入到第一个$GOPATH目录的google.golang.org
目录下,拉取genproto
在github
上的go-genproto
镜像库:
cd /usr/local/go/path/src/google.golang.orggit clone https://github.com/google/go-genproto.gitmv go-genproto/ genproto/
在安装完毕后,我们将grpc-gateway
的可执行文件从$GOPATH中移动到$GOBIN
mv /usr/local/go/path/bin/protoc-gen-grpc-gateway /usr/local/go/bin/
到这里我们这节就基本完成了,建议多反复看几遍加深对各个组件的理解!
参考
示例代码
- grpc-hello-world
Grpc+Grpc Gateway实践一 介绍与环境安装相关推荐
- Gym实践(一)——环境安装
提示:转载请注明出处,若本文无意冒犯到您的合法权益,请及时与作者联系. Gym实践(一)--环境安装 一.Gym是什么? OpenAI Gym OpenAI Gym 评估平台 二.安装步骤 1.安装A ...
- 第一章 Python Kivy 学习 -- Kivy介绍及环境安装
系列文章目录 第一章 Python Kivy 学习 – Kivy介绍及环境安装 第二章 Python Kivy 学习 – Kivy项目开发原理(待编辑) 第三章 Python Kivy 学习 – Ki ...
- RabbitMQ简单介绍+Windows环境安装
文章目录 文章目录 文章目录 1.RabbitMQ简介 2.RabbitMQ与其他MQ有什么不同 3.RabbitMQ环境安装 3.1 安装erlang 3.2 安装rabbitmq-server 4 ...
- 03-01 appium架构介绍与环境安装
appium 介绍 移动端的自动化测试框架 可用于测试原生应用.移动网页应用.混合应用 跨平台 支持 iOS 与 Android 操作系统 跨语言:支持 Java.Python 底层多引擎可切换 生态 ...
- selenium自动化测试-1.selenium介绍及环境安装
今天给大家介绍selenium及环境安装 其中包括 python环境安装 selenium环境安装 Chrome驱动安装 Firefox驱动安装 之后会陆续给大家介绍selenium系列 请不要错过我 ...
- Appium架构介绍与环境安装
Appium介绍 Appium是一个移动端的自动化测试框架,可以用于测试原生应用,移动网页应用和混合应用,且是跨平台的.可用于IOS和Android操作系统.原生应用是指用android或ios编写的 ...
- Libgdx介绍及环境安装
Libgdx介绍 Libgdx是一款跨平台的游戏引擎,目前支持的平台有windows, Mac-os,Linux,Android,IOS,HTML5等等,底层封装了OpenGL,上层是用Java封装的 ...
- 人工智能学习笔记01——数据分析的介绍及环境安装
1 为什么要学习数据分析 1 有岗位需求 2 是python数据科学的基础 3 是机器学习课程的基础 2 什么是数据分析 数据分析就是用适当的方法对采集来的大量数据进行分析,帮助人们做出判断,以便 ...
- vue介绍及环境安装
认识Vue Vue (读音 /vjuː/,类似于 view) 是一套用于构建用户界面的渐进式框架.与其它大型框架不同的是,Vue 被设计为可以自底向上逐层应用.Vue 的核心库只关注视图层,不仅易于上 ...
最新文章
- nacos 负载策略_Spring Cloud Alibaba:Nacos 作为注册中心和配置中心使用
- android 回调函数一:基本概念
- Unity性能优化 – 脚本篇
- 被远程机器长时间无响应 (错误码:[308])_自动折叠式“Rollbot”为完全不受束缚的软机器人铺平了道路...
- LeetCode 381. O(1) 时间插入、删除和获取随机元素 - 允许重复(vector + 哈希)
- Python操作MySQL(一)
- 手写 new 操作符
- atitit 研发管理 要不要自己做引擎自己实现架构?.docx
- 442.数组中重复的数据
- 管理Linux软件包和进程
- akamai反爬虫 akamai2.0 反爬 akamiv2 阿卡迈|ti|德州仪器|nike|机票预定| Maersk
- 《非暴力沟通》-马歇尔·卢森堡
- 记录一次时间戳、夏令时、时区线上问题分析
- 获取Mac地址getMacAddress
- 基于51单片机的羽毛球计分器设计
- C | 进程间通信的方式
- vue笔记:父子传值奥利给!
- 钓鱼网站php,偶遇钓鱼网站的一次代码审计
- CopyTranslator复制即可翻译,一个PDF文本翻译神器终于面世
- 同型号服务器更改硬盘,服务器更换硬盘需要怎么做