在centos環境下安裝grpc
技術標籤:Linux
備註:在8月5日的新版本以後移除了單純的make install 安裝指令,需要使用cmake或者bazel進行編譯,現在網路上的的教程大部分都是基於pure install的,為了成功安裝博主走了不少彎路,這裡記錄一下過程。博主使用的cmake進行編譯,使用bazel的話bug一大堆,不推薦。
1.下載原始碼
安裝依賴庫
yum install make automake gcc gcc-c++ kernel-devel autoconf libtool pkg-config # 或者大而全 yum groupinstall "Development Tools" "Development Libraries"
本文是在/home/user/下載 目錄下進行,通過git克隆原始碼
cd /home/user/下載
git clone https://github.com/grpc/grpc.git
cd grpc
# 進入gRPC資料夾,下載第三方庫的軟體原始碼
git submodule update --init
git 克隆的時間可能比較長,因此需要耐心等待。
2.使用cmake編譯原始碼
起始目錄是/home/user/下載/grpc
$ mkdir -p cmake/build
$ cd cmake/build
$ cmake ../..
$ make
此時使用cmake編譯C++檔案為連結檔案,需要等待比較長的時間。
3.cmake安裝第三方庫和原始碼
gRPC的CMake 系統具有兩個用於處理依賴的選項。兩個選項提供以下兩種功能:
① module CMake可以使用從 git submodules 下載的原始碼和grpc一起構建。
② package 搜尋系統上已安裝的庫並使用它們來構建gRPC。
兩個選項是通過變數 gRPC _ {depname}_ PROVIDER 上進行控制的,例如:
如果您設定gRPC_CARES_PROVIDER = module
,那麼CMake在構建gRPC之前先自動通過之前拉取的third-party裡的原始碼安裝cares這個庫(自動)。如果您設定了
gRPC_CARES_PROVIDER = package
,那麼CMake將搜尋本機中已經安裝的cares,並使用它來構建gRPC。
如果centos的CMake 是v3.13或更高版本,則可以在“module”模式下一鍵安裝grpc和依賴庫(推薦,不然容易出現各種cmake的缺少)
cmake --version #檢視cmake版本
# Install gRPC and its dependencies
# /home/admin/下載/grpc/cmake/build
# 緊接編譯完原始碼之後(make之後)
cmake \
-DCMAKE_BUILD_TYPE=Release \
-DgRPC_INSTALL=ON \
-DgRPC_BUILD_TESTS=OFF \
-DgRPC_SSL_PROVIDER=package \
../..
make -j4 install
如果要構建的gRPC <1.27或使用CMake < 3.13,則需要為依賴項選擇“package”模式(而不是“module”模式)。
這意味著我們需要在系統上事先安裝好這些依賴庫。
# /home/admin/下載/grpc
# Install absl
mkdir -p "third_party/abseil-cpp/cmake/build"
pushd "third_party/abseil-cpp/cmake/build"
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_POSITION_INDEPENDENT_CODE=TRUE ../..
make -j4 install
popd
# Install cares
mkdir -p "third_party/cares/cares/cmake/build"
pushd "third_party/cares/cares/cmake/build"
cmake -DCMAKE_BUILD_TYPE=Release ../..
make -j4 install
popd
# Install protobuf
mkdir -p "third_party/protobuf/cmake/build"
pushd "third_party/protobuf/cmake/build"
cmake -Dprotobuf_BUILD_TESTS=OFF -DCMAKE_BUILD_TYPE=Release ..
make -j4 install
popd
# Install re2
mkdir -p "third_party/re2/cmake/build"
pushd "third_party/re2/cmake/build"
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_POSITION_INDEPENDENT_CODE=TRUE ../..
make -j4 install
popd
# Install zlib
mkdir -p "third_party/zlib/cmake/build"
pushd "third_party/zlib/cmake/build"
cmake -DCMAKE_BUILD_TYPE=Release ../..
make -j4 install
popd
# Just before installing gRPC, wipe out contents of all the submodules to simulate
# a standalone build from an archive
# shellcheck disable=SC2016
git submodule foreach 'cd $toplevel; rm -rf $name'
# Install gRPC
mkdir -p "cmake/build"
pushd "cmake/build"
cmake \
-DCMAKE_BUILD_TYPE=Release \
-DgRPC_INSTALL=ON \
-DgRPC_BUILD_TESTS=OFF \
-DgRPC_CARES_PROVIDER=package \
-DgRPC_ABSL_PROVIDER=package \
-DgRPC_PROTOBUF_PROVIDER=package \
-DgRPC_RE2_PROVIDER=package \
-DgRPC_SSL_PROVIDER=package \
-DgRPC_ZLIB_PROVIDER=package \
../..
make -j4 install
popd
編譯成功後,可以檢視安裝的protobuf的版本
protoc --version
4.執行和驗證
原始碼裡有個exmale Demo庫,我們可以編譯HelloWorld Demo驗證是否安裝成功
設定環境變數
如果不修改環境變數,在編譯Demo的過程會顯示缺少某些動態連結庫.so
編輯“/etc/profile”檔案,新增環境變數。
vi /etc/profile
在檔案末新增PKG_CONFIG_PATH和LD_LIBRARY_PAT環境變數。
修改內容如下:
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
export LD_LIBRARY_PATH=/usr/local/lib
使環境變數生效 source /etc/profile
分別檢視PKG_CONFIG_PATH和LD_LIBRARY_PATH環境變數是否修改生效。
echo $PKG_CONFIG_PATH
回顯內容如下:
/usr/local/lib/pkgconfig
echo $LD_LIBRARY_PATH
回顯內容如下:
/usr/local/lib
驗證Demo是否編譯成功,且正常執行
# Build helloworld example using cmake
mkdir -p "examples/cpp/helloworld/cmake/build"
pushd "examples/cpp/helloworld/cmake/build"
cmake ../..
make
popd
編譯成功後生成greeter_server 和 greeter_client。
然後執行服務端,監聽的是50051埠:
# 從/grpc 進入 examples/cpp/helloworld/cmake/build
(base) [[email protected] build]# ./greeter_server
Server listening on 0.0.0.0:50051
在另外一個終端執行客戶端程式:
(base) [[email protected] build]# ./greeter_client
Greeter received: Hello world