Files

Mingyu Chen 67b842ce04 [License] Organize and modify the license of the code (#4371 )

1. Disable the MySQL client and LZO library by default when building the Doris.

    MySQL client library is used for MySQL external table feature.
    This feature will be replaced by the new ODBC external table soon.

    LZO library is used to compress/decompress data of some old data format of Doris,
    which is no longer used anymore.

2. Add missing license to some files.

3. For all non-Apache-License code, all are explained in NOTICE file and the corresponding license is declared.

4. Remove the js source code from webroot, it will be downloaded as thirdparty

2020-08-24 21:51:55 +08:00

4.7 KiB

Raw Blame History

title, language

title	language
编译	zh-CN

编译

本文档主要介绍如何通过源码编译 Doris。

使用 Docker 开发镜像编译（推荐）

使用现成的镜像

下载 Docker 镜像

$ docker pull apachedoris/doris-dev:build-env

检查镜像下载完成：

$ docker images
REPOSITORY              TAG                 IMAGE ID            CREATED             SIZE
apachedoris/doris-dev   build-env           f8bc5d4024e0        21 hours ago        3.28GB

注: 针对不同的 Doris 版本，需要下载对应的镜像版本

image version	commit id	release version
apachedoris/doris-dev:build-env	before ff0dd0d	0.8.x, 0.9.x
apachedoris/doris-dev:build-env-1.1	ff0dd0d 4ef5a8c	0.10.x, 0.11.x
apachedoris/doris-dev:build-env-1.2	4ef5a8c or later	0.12.x or later

运行镜像

$ docker run -it apachedoris/doris-dev:build-env

如果你希望编译本地 Doris 源码，则可以挂载路径：

$ docker run -it -v /your/local/incubator-doris-DORIS-x.x.x-release/:/root/incubator-doris-DORIS-x.x.x-release/ apachedoris/doris-dev:build-env

下载源码

启动镜像后，你应该已经处于容器内。可以通过以下命令下载 Doris 源码（已挂载本地源码目录则不用）：
```
$ wget https://dist.apache.org/repos/dist/dev/incubator/doris/xxx.tar.gz
or
$ git clone https://github.com/apache/incubator-doris.git
```
编译 Doris
```
$ sh build.sh
```
编译完成后，产出文件在 output/ 目录中。

自行编译开发环境镜像

你也可以自己创建一个 Doris 开发环境镜像，具体可参阅 docker/README.md 文件。

直接编译（CentOS/Ubuntu）

你可以在自己的 linux 环境中直接尝试编译 Doris。

系统依赖

GCC 5.3.1+, Oracle JDK 1.8+, Python 2.7+, Apache Maven 3.5+, CMake 3.11+

如果使用Ubuntu 16.04 及以上系统可以执行以下命令来安装依赖

sudo apt-get install build-essential openjdk-8-jdk maven cmake byacc flex automake libtool-bin bison binutils-dev libiberty-dev zip unzip libncurses5-dev

安装完成后，自行设置环境变量 PATH, JAVA_HOME 等。
编译 Doris
```
$ sh build.sh
```
编译完成后，产出文件在 output/ 目录中。

特别声明

自 0.13 版本开始，默认的编译产出中将取消对 [1] 和 [2] 两个第三方库的依赖。这两个第三方库为 GNU General Public License V3 协议。该协议与 Apache License 2.0 协议不兼容，因此默认不出现在 Apache 发布版本中。

移除依赖库 [1] 会导致无法访问 MySQL 外部表。访问 MySQL 外部表的功能会在后续版本中通过 UnixODBC 实现。

移除依赖库 [2] 会导致在无法读取部分早期版本（0.8版本之前）写入的部分数据。因为早期版本中的数据是使用 LZO 算法压缩的，在之后的版本中，已经更改为 LZ4 压缩算法。后续我们会提供工具用于检测和转换这部分数据。

如果有需求，用户可以继续使用这两个依赖库。如需使用，需要在编译时添加如下选项：

WITH_MYSQL=1 WITH_LZO=1 sh build.sh

注意，当用户依赖这两个第三方库时，则默认不在 Apache License 2.0 协议框架下使用 Doris。请注意 GPL 相关协议约束。

[1] mysql-5.7.18
[2] lzo-2.10

4.7 KiB Raw Blame History

编译