Apache Doris 部署有单机快速部署和生产环境的集群部署两种常见方式,单机部署适合测试与开发,集群部署适用于正式业务场景。以下是基于主流 2.x 版本的详细部署步骤,以 Linux 系统为例:
前期准备
-
环境依赖安装
组件 要求及安装命令 JDK FE 依赖 JDK 8,下载后配置环境变量。示例配置: export JAVA_HOME=/root/jdk1.8.0_431``export PATH=$PATH:$JAVA_HOME/bin系统依赖库 BE 需依赖相关库,CentOS 执行: yum install -y libstdc++-devel zlib-devel snappy-devel lz4-devel;Ubuntu 执行:apt-get install -y libstdc++6 zlib1g-dev libsnappy-dev liblz4-dev辅助工具 安装 mysql - client 用于连接 FE,ntp 用于时间同步: yum install -y mysql - client ntp(CentOS)或apt install -y mysql - client-core - 8.0 ntp(Ubuntu) -
系统参数优化 执行以下命令调整系统配置,避免部署后出现运行异常:
bash
运行
# 调整虚拟内存映射数 sysctl -w vm.max_map_count=2000000 # 关闭swap分区 swapoff -a # 提高文件描述符限制 ulimit -n 655350 # 写入配置文件确保重启生效 echo "* soft nofile 65535" >> /etc/security/limits.conf echo "* hard nofile 65535" >> /etc/security/limits.conf -
下载安装包 从Doris 镜像站下载稳定版安装包,示例命令:
bash
运行
wget https://apache-doris-releases.oss-accelerate.aliyuncs.com/apache-doris-2.1.10-bin-x64.tar.gz # 解压到指定目录 mkdir -p /opt/doris tar -zxvf apache-doris-2.1.10-bin-x64.tar.gz -C /opt/doris cd /opt/doris
单机部署(测试环境)
单机部署会在同一台机器上同时启动 FE 和 BE,步骤简单适合快速测试。
-
部署 FE(前端节点)
- 编辑 FE 配置文件
conf/fe.conf,关键配置如下:
bash
运行
# 指定本机内网IP priority_networks = 192.168.0.118/24 # 配置JDK路径 JAVA_HOME=/root/jdk1.8.0_431 # JVM内存配置,根据机器内存调整 JAVA_OPTS="-Xms2g -Xmx2g -XX:+UseG1GC"- 启动 FE 并验证:
bash
运行
# 后台启动FE bin/start_fe.sh --daemon # 查看进程,存在DorisFE则启动成功 jps - 编辑 FE 配置文件
-
部署 BE(后端节点)
- 编辑 BE 配置文件
conf/be.conf,配置内网 IP:
bash
运行
priority_networks = 192.168.0.118/24- 启动 BE 并验证:
bash
运行
# 后台启动BE bin/start_be.sh --daemon # 查看进程,存在DorisBE则启动成功 jps - 编辑 BE 配置文件
-
注册 BE 到 FE 通过 MySQL 客户端连接 FE,完成 BE 节点注册:
bash
运行
# 连接FE,默认无密码 mysql -uroot -P9030 -h127.0.0.1 --default-auth=mysql_native_password # 执行注册命令,IP为本机地址 alter system add backend "192.168.0.118:9050"; # 查看BE状态,Alive为true表示注册成功 show proc '/backends'\G
集群部署(生产环境)
生产环境建议 FE 节点≥3 台(1 主 2 从)、BE 节点≥3 台,保障高可用,以下是核心步骤。
-
节点规划示例
节点 IP 角色 说明 192.168.1.10 FE(Leader) 主前端节点,管理元数据 192.168.1.11 FE(Follower) 从前端节点,实现高可用 192.168.1.12 BE 数据存储与计算节点 192.168.1.13 BE 数据存储与计算节点 192.168.1.14 BE 数据存储与计算节点 -
批量部署 FE
- 先在 192.168.1.10 启动主 FE,步骤同单机部署的 FE 部署。
- 在 192.168.1.11 等从 FE 节点,修改
fe.conf后,执行命令加入集群:
bash
运行
# 从FE节点启动并关联主FE bin/start_fe.sh --daemon --helper 192.168.1.10:9010 -
批量部署 BE
- 每台 BE 节点修改
conf/be.conf中的priority_networks为对应本机 IP。 - 启动所有 BE 后,通过 MySQL 客户端连接主 FE,批量注册 BE:
bash
运行
alter system add backend "192.168.1.12:9050","192.168.1.13:9050","192.168.1.14:9050"; - 每台 BE 节点修改
验证部署
-
访问 FE 的 Web 界面,默认端口 8030,如
http://192.168.1.10:8030,可查看集群节点状态。 -
通过 MySQL 客户端执行简单查询,验证功能正常: sql
create database test_db; use test_db; create table test_table(id int) distributed by hash(id) buckets 1; insert into test_table values(1); select * from test_table;