开始

快速搭建bRPC并尝试样例代码。

构建

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.

支持的环境

Ubuntu/LinuxMint/WSL

依赖准备

安装依赖：

  1. sudo apt-get install -y git g++ make libssl-dev libgflags-dev libprotobuf-dev libprotoc-dev protobuf-compiler libleveldb-dev

如果你需要静态链接leveldb：

  1. sudo apt-get install -y libsnappy-dev

如果你要在样例中启用cpu/heap的profiler：

  1. sudo apt-get install -y libgoogle-perftools-dev

如果你要运行测试，那么要安装并编译libgtest-dev（它没有被默认编译）：

  1. 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。

使用config_brpc.sh编译brpc

git克隆brpc，进入到项目目录，然后运行

  1. $ sh config_brpc.sh --headers=/usr/include --libs=/usr/lib
  2. $ make

修改编译器为clang，添加选项--cxx=clang++ --cc=clang。

不想链接调试符号，添加选项--nodebugsymbols，然后编译将会得到更轻量的二进制文件。

使用glog版的brpc，添加选项--with-glog。

要启用 thrift 支持，首先安装thrift并且添加选项--with-thrift。

运行样例

  1. $ cd example/echo_c++
  2. $ make
  3. $ ./echo_server &
  4. $ ./echo_client

上述操作会链接brpc的静态库到样例中，如果你想链接brpc的共享库，请依次执行：make clean和LINK_SO=1 make

运行测试

  1. $ cd test
  2. $ make
  3. $ sh run_tests.sh

使用cmake编译brpc

  1. 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运行样例

  1. $ cd example/echo_c++
  2. $ cmake -B build && cmake --build build -j4
  3. $ ./echo_server &
  4. $ ./echo_client

上述操作会链接brpc的静态库到样例中，如果你想链接brpc的共享库，请先移除CMakeCache.txt，然后用-DLINK_SO=ON选项重新执行cmake。

运行测试

  1. $ mkdir build && cd build && cmake -DBUILD_UNIT_TESTS=ON .. && make && make test

Fedora/CentOS

依赖准备

CentOS一般需要安装EPEL，否则很多包都默认不可用。

  1. sudo yum install epel-release

安装依赖：

  1. sudo yum install git gcc-c++ make openssl-devel gflags-devel protobuf-devel protobuf-compiler leveldb-devel

如果你要在样例中启用cpu/heap的profiler：

  1. sudo yum install gperftools-devel

如果你要运行测试，那么要安装ligtest-dev:

  1. sudo yum install gtest-devel

使用config_brpc.sh编译brpc

git克隆brpc，进入项目目录然后执行：

  1. $ sh config_brpc.sh --headers="/usr/include" --libs="/usr/lib64 /usr/bin"
  2. $ make

修改编译器为clang，添加选项--cxx=clang++ --cc=clang。

不想链接调试符号，添加选项--nodebugsymbols 然后编译将会得到更轻量的二进制文件。

想要让brpc使用glog，添加选项：--with-glog。

要启用 thrift 支持，先安装thrift，然后添加选项：--with-thrift。

运行样例

  1. $ cd example/echo_c++
  2. $ make
  3. $ ./echo_server &
  4. $ ./echo_client

上述操作会链接brpc的静态库到样例中，如果你想链接brpc的共享库，请依次执行：make clean和LINK_SO=1 make

运行测试

  1. $ cd test
  2. $ make
  3. $ sh run_tests.sh

使用cmake编译brpc

参考这里

自己构建依赖的Linux

依赖准备

brpc默认会构建出静态库和共享库，因此它也需要依赖有静态库和共享库两个版本。

以gflags为例，它默认不构建共享库，你需要给cmake指定选项去改变这一行为：

  1. $ cmake . -DBUILD_SHARED_LIBS=1 -DBUILD_STATIC_LIBS=1
  2. $ make

编译brpc

还以gflags为例，../gflags_dev表示gflags被克隆的位置。

git克隆brpc。进入到项目目录然后运行：

  1. $ sh config_brpc.sh --headers="../gflags_dev /usr/include" --libs="../gflags_dev /usr/lib64"
  2. $ make

这里我们给--headers和--libs传递多个路径使得脚本能够在多个地方进行检索。你也可以打包所有依赖和brpc一起放到一个目录中，然后把目录传递给 –headers/–libs选项，它会递归搜索所有子目录直到找到必须的文件。

修改编译器为clang，添加选项--cxx=clang++ --cc=clang。

不想链接调试符号，添加选项--nodebugsymbols，然后编译将会得到更轻量的二进制文件。

使用glog版的brpc，添加选项--with-glog。

要启用thrift 支持，首先安装thrift并且添加选项--with-thrift。

  1. $ ls my_dev
  2. gflags_dev protobuf_dev leveldb_dev brpc_dev
  3. $ cd brpc_dev
  4. $ sh config_brpc.sh --headers=.. --libs=..
  5. $ make

使用cmake编译brpc

参考这里

MacOS

注意：在相同硬件条件下，MacOS版brpc的性能可能明显差于Linux版。如果你的服务是性能敏感的，请不要使用MacOS作为你的生产环境。

Apple Silicon

master HEAD已支持M1系列芯片，M2还未测试。欢迎通过issues向我们报告遗留的warning/error。

依赖准备

安装依赖：

  1. brew install openssl git gnu-getopt coreutils gflags protobuf leveldb

如果你要在样例中启用cpu/heap的profiler：

  1. brew install gperftools

如果你要运行测试，需安装gtest。先运行brew install googletest看看homebrew是否支持（老版本没有），没有的话请下载和编译googletest：

  1. 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。

OpenSSL

Monterey中openssl的安装位置可能不再位于/usr/local/opt/openssl，很可能会在/opt/homebrew/Cellar目录下，如果编译时报告找不到openssl：

  • 先运行brew link openssl --force看看/user/local/opt/openssl是否出现了
  • 没有的话可以自行设置软链：sudo ln -s /opt/homebrew/Cellar/openssl@3/3.0.3 /usr/local/opt/openssl。请注意此命令中openssl的目录可能随环境变化而变化，可通过brew info openssl查看。

使用config_brpc.sh编译brpc

git克隆brpc，进入到项目目录然后运行：

  1. $ sh config_brpc.sh --headers=/usr/local/include --libs=/usr/local/lib --cc=clang --cxx=clang++
  2. $ make

MacOS Monterey下的brew安装路径可能改变，如有路径相关的错误，可考虑设置如下：

  1. $ sh config_brpc.sh --headers=/opt/homebrew/include --libs=/opt/homebrew/lib --cc=clang --cxx=clang++
  2. $ make

不想链接调试符号，添加选项--nodebugsymbols，然后编译将会得到更轻量的二进制文件。

使用glog版的brpc，添加选项--with-glog。

要启用thrift 支持，首先安装thrift并且添加选项--with-thrift。

运行样例

  1. $ cd example/echo_c++
  2. $ make
  3. $ ./echo_server &
  4. $ ./echo_client

上述操作会链接brpc的静态库到样例中，如果你想链接brpc的共享库，请依次执行：make clean和LINK_SO=1 make

运行测试

  1. $ cd test
  2. $ make
  3. $ sh run_tests.sh

使用cmake编译brpc

参考这里

Docker

使用docker 编译brpc：

  1. $ mkdir -p ~/brpc
  2. $ cd ~/brpc
  3. $ git clone https://github.com/apache/brpc.git
  4. $ cd brpc
  5. $ docker build -t brpc:master .
  6. $ docker images
  7. $ docker run -it brpc:master /bin/bash

支持的依赖

GCC: 4.8-11.2

c++11被默认启用，以去除对boost的依赖（比如atomic）。

GCC7中over-aligned的问题暂时被禁止。

使用其他版本的gcc可能会产生编译警告，请联系我们予以修复。

请在makefile中给cxxflags增加-D__const__=选项以避免gcc4+中的errno问题.

Clang: 3.5-4.0

无已知问题。

glibc: 2.12-2.25

无已知问题。

protobuf: 2.4+

同一个文件兼容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至今没被支持。

gflags: 2.0-2.2.1

无已知问题。

openssl: 0.97-1.1

被https功能需要。

tcmalloc: 1.7-2.5

brpc默认不链接 tcmalloc。用户按需要链接tcmalloc。

和glibc内置的ptmalloc相比，tcmalloc通常能提升性能。然而不同版本的tcmalloc可能表现迥异。例如：tcmalloc 2.1与 tcmalloc 1.7和2.5相比，可能会让brpc的多线程样例性能显著恶化（tcmalloc中的一个自旋锁导致的）。甚至不同的小版本号之间表现也可能不同。当你的程序表现不符合预期的时候，移除tcmalloc然后尝试其他版本。

用gcc4.8.2编译然后链接更早版本GCC编译的tcmalloc，可能会让程序中main()函数之前挂掉或者死锁，例如：

img

当你遇到这个问题的时候，请用同一个GCC重新编译tcmalloc。

另外一个使用tcmalloc的常见问题是，它不会像 ptmalloc一样及时地归还内存给系统。因此当有一个无效的内存访问的时候，程序可能不会直接挂掉，取而代之的是它可能在一个不相关的地方挂掉，或者甚至一直不挂掉。当你的程序出现怪异的内存问题的时候，尝试移除tcmalloc。

如果你要使用cpu profiler或heap profiler，要链接libtcmalloc_and_profiler.a。这两个 profiler都是基于tcmalloc的。而contention profiler不需要tcmalloc。

当你移除tcmalloc的时候，不仅要移除tcmalloc的链接，也要移除宏-DBRPC_ENABLE_CPU_PROFILER。

glog: 3.3+

brpc实现了一个默认的日志功能它和glog冲突。要替换成glog，可以给config_brpc.sh增加--with-glog选项或者给cmake增加-DWITH_GLOG=ON选项。

valgrind: 3.8+

brpc会自动检测valgrind（然后注册bthread的栈）。不支持老版本的valgrind（比如3.2）。

thrift: 0.9.3-0.11.0

无已知问题。

实例追踪

我们提供了一个程序去帮助你追踪和监控所有brpc实例。 只需要在某处运行 trackme_server 然后再带着 -trackme_server=SERVER参数启动需要被追踪的实例。trackme_server将从实例周期性地收到ping消息然后打印日志。您可以从日志中聚合实例地址，并调用实例的内置服务以获取更多信息。

修改于 2024年10月7日: Oncall report (1b7065e)