跳到主要内容
跳到主要内容

使用 LDB Toolchain 编译

使用 LDB Toolchain 编译

本文档主要介绍如何使用 LDB toolchain 编译 Doris。该方式目前作为 Docker 编译方式的补充,方便没有 Docker 环境的开发者和用户编译 Doris 源码。 Doris目前推荐的LDB toolchain版本为 0.17, 其中含有clang-16和gcc-11。

您依然可以使用 Docker 开发镜像编译最新代码:apache/doris:build-env-ldb-toolchain-latest

感谢 Amos Bird 的贡献。

准备编译环境

该方式适用于绝大多数 Linux 发行版(CentOS,Ubuntu 等)。

  1. 下载 ldb_toolchain_gen.sh

    可以从 这里 下载最新的 ldb_toolchain_gen.sh。该脚本用于生成 ldb toolchain。

    更多信息,可访问 https://github.com/amosbird/ldb_toolchain_gen

  2. 执行以下命令生成 ldb toolchain

    sh ldb_toolchain_gen.sh /path/to/ldb_toolchain/

    其中 /path/to/ldb_toolchain/ 为安装 toolchain 目录。

    执行成功后,会在 /path/to/ldb_toolchain/ 下生成如下目录结构:

    ├── bin
    ├── include
    ├── lib
    ├── share
    ├── test
    └── usr
  3. 下载并安装其他编译组件

    1. Java8
    2. Apache Maven 3.6.3
    3. Node v12.13.0

    对于不同的 Linux 发行版,可能默认包含的组件不同。因此可能需要安装一些额外的组件。下面以 centos6 为例,其他发行版类似:

    # install required system packages
    sudo yum install -y byacc patch automake libtool make which file ncurses-devel gettext-devel unzip bzip2 zip util-linux wget git python2

    # install autoconf-2.69
    wget http://ftp.gnu.org/gnu/autoconf/autoconf-2.69.tar.gz && \
    tar zxf autoconf-2.69.tar.gz && \
    cd autoconf-2.69 && \
    ./configure && \
    make && \
    make install

    # install bison-3.0.4
    wget http://ftp.gnu.org/gnu/bison/bison-3.0.4.tar.gz && \
    tar xzf bison-3.0.4.tar.gz && \
    cd bison-3.0.4 && \
    ./configure && \
    make && \
    make install
  4. 下载 Doris 源码

    git clone https://github.com/apache/doris.git

    下载完成后,进入到 doris 源码目录,创建 custom_env.sh,文件,并设置 PATH 环境变量,如:

    export JAVA_HOME=/path/to/java/
    export PATH=$JAVA_HOME/bin:$PATH
    export PATH=/path/to/maven/bin:$PATH
    export PATH=/path/to/node/bin:$PATH
    export PATH=/path/to/ldb_toolchain/bin:$PATH

编译 Doris

进入 Doris 源码目录,执行:

$ cat /proc/cpuinfo | grep avx2

查看编译机器是否支持avx2指令集

不支持则使用以下命令进行编译

$ USE_AVX2=0 sh build.sh

若支持则直接执行 sh build.sh 即可

如需编译Debug版本的BE,增加 BUILD_TYPE=Debug

$ BUILD_TYPE=Debug sh build.sh

该脚本会先编译第三方库,之后再编译 Doris 组件(FE、BE)。编译产出在 output/ 目录下。

预编译三方库

build.sh 脚本会先编译第三方库。你也可以直接下载预编译好的三方库:

https://github.com/apache/doris-thirdparty/releases

这里我们提供了 Linux X86(with AVX2) 和 MacOS(X86芯片) 的预编译三方库。如果和你的编译运行环境一致,可以直接下载使用。

下载好后,解压会得到一个 installed/ 目录,将这个目录拷贝到 thirdparty/ 目录下,之后运行 build.sh 即可。