brpc最新安装上手指南

2021-12-08 13:45:02 浏览数 (1)

当时brpc还未开源。后于同年百度对外开源了brpc。在百度内部brpc叫baidu-rpc。后来由于进入了Apache基金会进行孵化,brpc的含义做了调整,改成了better RPC。这倒也无伤大雅,众所周知,百度和腾讯是国内鲜有的C 大厂,而brpc也算是笔者见过C 开源世界里比较优秀且实用的框架了。

好了,关于brpc的溢美之词暂且按下不表,我们言归正传,赶快上手吧!另外brpc支持Mac和Linux环境。本文是基于某云的Centos实机操作纪实!brpc的版本是0.9.7。

github

brpc的github地址如下:

https://github.com/apache/incubator-brpc

我们也可以直接在本地克隆:

代码语言:javascript复制
git clone https://github.com/apache/incubator-brpc.git

安装编译依赖

cmake

我习惯用cmake编译一些第三方库,这里我们安装一下cmake。云主机默认安装的cmake可能是cmake 2的版本。但由于brpc其中一个依赖gflags需要cmake3,所以我们先安装一下cmake3:

代码语言:javascript复制
yum install cmake3

第三方库

  • gflags
  • leveldb
  • protobuf (2或3均可)
  • openssl

上面是brpc编译所依赖的几个第三方库,基本上在github上都能找到。除openssl外都支持cmake编译。

  • https://github.com/gflags/gflags
  • https://github.com/google/leveldb
  • https://github.com/protocolbuffers/protobuf
  • https://github.com/openssl/openssl

其中gflags、leveldb默认cmake的编译方式会编译成静态库,导致最终编译brpc时会报错:

代码语言:javascript复制
/usr/local/lib/libgflags.a(gflags.cc.o): relocation R_X86_64_32S against `.rodata' can not be used

所以请注意我们需要把gflags、leveldb都编译成动态库。在下载完源码后,cd到对应目录,执行如下操作:

代码语言:javascript复制
mkdir bld
cd bld
cmake3 -DBUILD_SHARED_LIBS=ON ..
make -j 8
sudo make install

也就是给cmake加上一个-DBUILD_SHARED_LIBS=ON参数。gflags、leveldb可以安装上述流程来编译。

另外关于openssl和protobuf,参照编译文档编译即可。没有什么坑点。

唯一需要提醒的是,如果是autotool编译安装的方式(要执行./configure的),最好不要自作聪明加--prefix参数来修改默认的库安装路径。因为如果安装到自定义路径下,后续其他编译如果依赖到这个库,都需要修改编译时的库检索路径,简直自找麻烦!

编译brpc

好了,准备工作做完,终于要编译brpc了。cd到brpc的下载目录中。

代码语言:javascript复制
mkdir bld
cd bld
cmake3 ..
make
make install

这里我make的时候没加j8参数来开启并行编译。因为我机器上实测并行编译会编译失败,串行编译无问题。当然缺点就是编译比较慢了。我建议是在云主机上开一个tmux,在tmux会话里开始make,然后你就可以忙别的去了。

漫长等待之后,最终会编译成功。

编译example

brpc编译完成,基本上你就可以使用了。但是brpc自带的例子没有编译。我们可以编译一下,启动看看。在example目录下面。

需要提醒的是example的代码用cmake编译,可能会失败(反正我是遇到了)。没关系,我们改成普通make编译的方式。

首先要先生成config.mk,回到brpc的顶级目录:

代码语言:javascript复制
sh config_brpc.sh --headers=/usr/local/include  --libs=/usr/local/lib

headers和libs指定第三方库的头文件和库所在路径。这也就是我为什么说不要随意修改库的安装路径的原因了,库装在不同位置着实不便。尽量集中到一起,不在一起的时候,可以通过建立软连接,弄到一起。

生成config.mk之后,就可以去example目录编译了,比如我们编译echo_c 。

代码语言:javascript复制
cd example/echo_c  
make

运行echo_c

上面编译完成之后会有echo_server和echo_client的可执行文件。

我们启动server:

代码语言:javascript复制
nohup ./echo_server &

echo_client 其实我一般不用。echo_client是默认的baidu_std协议。实际工作中多有使用,但作为demo测试,其实不用。因为brpc有个强大的特性是支持单端口多协议,并且号称支持协议最多的RPC框架。所以我们可以用HTTP请求的方式来请求它!

代码语言:javascript复制
curl -d '{"message":"hello world"}' 127.0.0.1:8000/EchoService/Echo

端口号后面的路径和proto定义有关。查看echo.proto的定义:

代码语言:javascript复制
service EchoService {
      rpc Echo(EchoRequest) returns (EchoResponse);
};

好了。后面我们就可以通过调试修改这个echo_server来学习了解brpc啦。

我知道你在看哦

0 人点赞