brpc鼓励静态链接依赖,以便于每个运行brpc服务的机器不必再安装依赖。
brpc有如下依赖:
- gflags: Extensively used to define global options.
- protobuf: Serializations of messages, interfaces of services.
- leveldb: Required by rpcz to record RPCs for tracing.
安装依赖:
sudo apt-get install -y git g++ make libssl-dev libgflags-dev libprotobuf-dev libprotoc-dev protobuf-compiler libleveldb-dev
如果你需要静态链接leveldb:
sudo apt-get install -y libsnappy-dev
如果你需要通过源码编译生成 leveldb 静态库:
git clone --recurse-submodules https://github.com/google/leveldb.git
mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_POSITION_INDEPENDENT_CODE=ON .. && cmake --build .
sudo cp -r ../include/leveldb /usr/include/ && sudo cp libleveldb.a /usr/lib/
如果你要在样例中启用cpu/heap的profiler:
sudo apt-get install -y libgoogle-perftools-dev
如果你要运行测试,那么要安装并编译libgtest-dev(它没有被默认编译):
sudo apt-get install -y cmake libgtest-dev && cd /usr/src/gtest && sudo cmake . && sudo make && sudo mv lib/libgtest* /usr/lib/ && cd -
gtest源码目录可能变动,如果/usr/src/gtest
不存在,请尝试/usr/src/googletest/googletest
。
git克隆brpc,进入到项目目录,然后运行
$ sh config_brpc.sh --headers=/usr/include --libs=/usr/lib
$ make
修改编译器为clang,添加选项--cxx=clang++ --cc=clang
。
不想链接调试符号,添加选项--nodebugsymbols
,然后编译将会得到更轻量的二进制文件。
使用glog版的brpc,添加选项--with-glog
。
要启用 thrift 支持,首先安装thrift并且添加选项--with-thrift
。
运行样例
$ cd example/echo_c++
$ make
$ ./echo_server &
$ ./echo_client
上述操作会链接brpc的静态库到样例中,如果你想链接brpc的共享库,请依次执行:make clean
和LINK_SO=1 make
运行测试
$ cd test
$ make
$ sh run_tests.sh
mkdir build && cd build && cmake .. && cmake --build . -j6
对于 cmake 3.13+ 也可以使用如下命令进行编译:
cmake -B build && cmake --build build -j6
要帮助VSCode或Emacs(LSP)去正确地理解代码,添加-DCMAKE_EXPORT_COMPILE_COMMANDS=ON
选项去生成compile_commands.json
。
要修改编译器为clang,请修改环境变量CC
和CXX
为clang
和clang++
。
不想链接调试符号,请移除build/CMakeCache.txt
,然后用-DWITH_DEBUG_SYMBOLS=OFF
选项执行cmake。
想要让brpc使用glog,用-DWITH_GLOG=ON
选项执行cmake。
要启用 thrift 支持,先安装thrift,然后用-DWITH_THRIFT=ON
选项执行cmake。
用cmake运行样例
$ cd example/echo_c++
$ cmake -B build && cmake --build build -j4
$ ./echo_server &
$ ./echo_client
上述操作会链接brpc的静态库到样例中,如果你想链接brpc的共享库,请先移除CMakeCache.txt
,然后用-DLINK_SO=ON
选项重新执行cmake。
运行测试
$ mkdir build && cd build && cmake -DBUILD_UNIT_TESTS=ON .. && make && make test
CentOS一般需要安装EPEL,否则很多包都默认不可用。
sudo yum install epel-release
安装依赖:
sudo yum install git gcc-c++ make openssl-devel gflags-devel protobuf-devel protobuf-compiler leveldb-devel
如果你要在样例中启用cpu/heap的profiler:
sudo yum install gperftools-devel
如果你要运行测试,那么要安装ligtest-dev:
sudo yum install gtest-devel
git克隆brpc,进入项目目录然后执行:
$ sh config_brpc.sh --headers="/usr/include" --libs="/usr/lib64 /usr/bin"
$ make
修改编译器为clang,添加选项--cxx=clang++ --cc=clang
。
不想链接调试符号,添加选项--nodebugsymbols
然后编译将会得到更轻量的二进制文件。
想要让brpc使用glog,添加选项:--with-glog
。
要启用 thrift 支持,先安装thrift,然后添加选项:--with-thrift
。
运行样例
$ cd example/echo_c++
$ make
$ ./echo_server &
$ ./echo_client
上述操作会链接brpc的静态库到样例中,如果你想链接brpc的共享库,请依次执行:make clean
和LINK_SO=1 make
运行测试
$ cd test
$ make
$ sh run_tests.sh
参考这里
vcpkg 是一个全平台支持的包管理器,你可以使用以下步骤vcpkg轻松编译brpc:
$ git clone https://github.com/microsoft/vcpkg.git
$ ./bootstrap-vcpkg.bat # 使用 powershell
$ ./bootstrap-vcpkg.sh # 使用 bash
$ ./vcpkg install brpc
brpc默认会构建出静态库和共享库,因此它也需要依赖有静态库和共享库两个版本。
以gflags为例,它默认不构建共享库,你需要给cmake
指定选项去改变这一行为:
$ cmake . -DBUILD_SHARED_LIBS=1 -DBUILD_STATIC_LIBS=1
$ make
还以gflags为例,../gflags_dev
表示gflags被克隆的位置。
git克隆brpc。进入到项目目录然后运行:
$ sh config_brpc.sh --headers="../gflags_dev /usr/include" --libs="../gflags_dev /usr/lib64"
$ make
这里我们给--headers
和--libs
传递多个路径使得脚本能够在多个地方进行检索。你也可以打包所有依赖和brpc一起放到一个目录中,然后把目录传递给 --headers/--libs选项,它会递归搜索所有子目录直到找到必须的文件。
修改编译器为clang,添加选项--cxx=clang++ --cc=clang
。
不想链接调试符号,添加选项--nodebugsymbols
,然后编译将会得到更轻量的二进制文件。
使用glog版的brpc,添加选项--with-glog
。
要启用thrift 支持,首先安装thrift并且添加选项--with-thrift
。
$ ls my_dev
gflags_dev protobuf_dev leveldb_dev brpc_dev
$ cd brpc_dev
$ sh config_brpc.sh --headers=.. --libs=..
$ make
参考这里
注意:在相同硬件条件下,MacOS版brpc的性能可能明显差于Linux版。如果你的服务是性能敏感的,请不要使用MacOS作为你的生产环境。
master HEAD已支持M1系列芯片,M2未测试过。欢迎通过issues向我们报告遗留的warning/error。
安装依赖:
brew install openssl git gnu-getopt coreutils gflags protobuf leveldb
如果你要在样例中启用cpu/heap的profiler:
brew install gperftools
如果你要运行测试,需安装gtest。先运行brew install googletest
看看homebrew是否支持(老版本没有),没有的话请下载和编译googletest:
git clone https://github.com/google/googletest -b release-1.10.0 && cd googletest/googletest && mkdir build && cd build && cmake -DCMAKE_CXX_FLAGS="-std=c++11" .. && make
在编译完成后,复制include/
和lib/
目录到/usr/local/include
和/usr/local/lib
目录中,以便于让所有应用都能使用gtest。
Monterey中openssl的安装位置可能不再位于/usr/local/opt/openssl
,很可能会在/opt/homebrew/Cellar
目录下,如果编译时报告找不到openssl:
- 先运行
brew link openssl --force
看看/usr/local/opt/openssl
是否出现了 - 没有的话可以自行设置软链:
sudo ln -s /opt/homebrew/Cellar/openssl@3/3.0.3 /usr/local/opt/openssl
。请注意此命令中openssl的目录可能随环境变化而变化,可通过brew info openssl
查看。
git克隆brpc,进入到项目目录然后运行:
$ sh config_brpc.sh --headers=/usr/local/include --libs=/usr/local/lib --cc=clang --cxx=clang++
$ make
MacOS Monterey下的brew安装路径可能改变,如有路径相关的错误,可考虑设置如下:
$ sh config_brpc.sh --headers=/opt/homebrew/include --libs=/opt/homebrew/lib --cc=clang --cxx=clang++
$ make
不想链接调试符号,添加选项--nodebugsymbols
,然后编译将会得到更轻量的二进制文件。
使用glog版的brpc,添加选项--with-glog
。
要启用thrift 支持,首先安装thrift并且添加选项--with-thrift
。
运行样例
$ cd example/echo_c++
$ make
$ ./echo_server &
$ ./echo_client
上述操作会链接brpc的静态库到样例中,如果你想链接brpc的共享库,请依次执行:make clean
和LINK_SO=1 make
运行测试
$ cd test
$ make
$ sh run_tests.sh
参考这里
使用docker 编译brpc:
$ mkdir -p ~/brpc
$ cd ~/brpc
$ git clone https://github.com/apache/brpc.git
$ cd brpc
$ docker build -t brpc:master .
$ docker images
$ docker run -it brpc:master /bin/bash
c++11被默认启用,以去除去boost的依赖(比如atomic)。
GCC7中over-aligned的问题暂时被禁止。
使用其他版本的gcc可能会产生编译警告,请联系我们予以修复。
请在makefile中给cxxflags增加-D__const__=__unused__
选项以避免gcc4+中的errno问题.
无已知问题。
无已知问题。
同一个文件兼容pb 3.x版本和pb 2.x版本:
不要使用proto3新增的类型,并且在proto文件的起始位置添加syntax=proto2;
声明。
tools/add_syntax_equal_proto2_to_all.sh这个脚本可以给所有没有这行声明的proto文件添加syntax="proto2"
声明。
pb 3.x中的Arena至今没被支持。
无已知问题。
被https功能需要。
brpc默认不链接 tcmalloc。用户按需要链接tcmalloc。
和glibc内置的ptmalloc相比,tcmalloc通常能提升性能。然而不同版本的tcmalloc可能表现迥异。例如:tcmalloc 2.1与 tcmalloc 1.7和2.5相比,可能会让brpc的多线程样例性能显著恶化(tcmalloc中的一个自旋锁导致的)。甚至不同的小版本号之间变现也可能不同。当你的程序表现不符合预期的时候,移除tcmalloc然后尝试其他版本。
用gcc4.8.2编译然后链接更早版本GCC编译的tcmalloc,可能会让程序中main()函数之前挂掉或者死锁,例如:
当你遇到这个问题的时候,请用同一个GCC重新编译tcmalloc。
另外一个使用tcmalloc的常见问题是,它不会像 ptmalloc一样及时地归还内存给系统。因此当有一个无效的内存访问的时候,程序可能不会直接挂掉,取而代之的是它可能在一个不相关的地方挂掉,或者甚至一直不挂掉。当你的程序出现怪异的内存问题的时候,尝试移除tcmalloc。
如果你要使用cpu profiler或heap profiler,要链接libtcmalloc_and_profiler.a
。这两个 profiler都是基于tcmalloc的。而contention profiler不需要tcmalloc。
当你移除tcmalloc的时候,不仅要移除tcmalloc的链接,也要移除宏-DBRPC_ENABLE_CPU_PROFILER
。
brpc实现了一个默认的日志功能它和glog冲突。要替换成glog,可以给config_brpc.sh增加*--with-glog*选项或者给cmake增加-DWITH_GLOG=ON
选项。
brpc会自动检测valgrind(然后注册bthread的栈)。不支持老版本的valgrind(比如3.2)。
无已知问题。
我们提供了一个程序去帮助你追踪和监控所有brpc实例。 只需要在某处运行 trackme_server 然后再带着 -trackme_server=SERVER参数启动需要被追踪的实例。trackme_server将从实例周期性地收到ping消息然后打印日志。您可以从日志中聚合实例地址,并调用实例的内置服务以获取更多信息。