seecc/doris

seecc/doris Docker镜像文档

镜像概述

seecc/doris镜像基于Apache Doris 2.0.2版本构建，提供Frontend（FE）和Backend（BE）两种服务组件，用于快速部署分布式分析型数据库集群。FE作为集群的控制节点，负责元数据管理、查询规划和集群调度；BE作为数据节点，负责数据存储、计算执行和查询处理。该镜像支持通过Docker Compose实现多节点集群部署，适用于大数据分析、数据仓库构建等场景。

核心功能与特性

• 组件分离：提供FE（fe-2.0.2）和BE（be-2.0.2）两个独立镜像，支持灵活部署集群架构
• 元数据管理：FE节点负责元数据存储与同步，确保集群元数据一致性
• 分布式计算：BE节点支持并行计算，提升大规模数据查询效率
• 配置灵活：通过环境变量自定义节点ID、网络地址、认证密码等关键参数
• 数据持久化：支持本地目录挂载，确保元数据、日志和存储数据持久化
• 时区配置：支持通过环境变量设置时区，适应不同地域部署需求

使用场景

• 构建企业级数据仓库，支持TB/PB级数据存储与分析
• 实时/离线数据分析平台，提供高效SQL查询能力
• 多节点分布式集群部署，满足高可用和高并发需求
• 快速搭建Doris测试/开发环境，降低部署复杂度

使用方法与配置说明

环境准备

• Docker Engine 19.03+
• Docker Compose 3.4+
• 确保宿主机已创建所需挂载目录（如/docker/doris-cluster/fe1/doris-meta、/docker/doris-cluster/be1/storage等）

部署示例（Docker Compose）

以下为包含1个FE节点和3个BE节点的集群配置示例：

yaml
version: '3.4'
services:
  doris_fe1:
    image: seecc/doris:fe-2.0.2
    container_name: doris_fe1
    hostname: "fe"
    environment:
      TZ: Asia/Shanghai  # 时区设置
      FE_HOST: "10.199.199.101"  # FE节点IP地址
      FE_SERVERS: "fe1:10.199.199.101:9010"  # FE集群节点列表（格式：节点名:IP:端口）
      FE_ID: 1  # FE节点ID（主节点通常设为1）
      FE_PASSWORD: "admin"  # FE管理员密码
    volumes:
      - /etc/localtime:/etc/localtime  # 同步宿主机时间
      - /docker/doris-cluster/fe1/doris-meta:/opt/apache-doris/fe/doris-meta  # 元数据持久化目录
      - /docker/doris-cluster/fe1/log:/opt/apache-doris/fe/log  # 日志目录
      - ./doris_start/mysql-connector-java-5.1.47.jar:/opt/apache-doris/jdbc_drivers/mysql-connector-java-5.1.47.jar  # JDBC驱动挂载
    restart: always
    ports:
      - "8030:8030"  # HTTP API端口
      - "9030:9030"  # MySQL客户端连接端口
      - "9010:9010"  # FE节点间通信端口
    networks:
      my_network:
        ipv4_address: 10.199.199.101  # 固定IP地址

  doris_be1:
    image: seecc/doris:be-2.0.2
    container_name: doris_be1
    hostname: "be"
    environment:
      TZ: Asia/Shanghai
      FE_HOST: "10.199.199.101"  # 关联的FE节点IP
      FE_PASSWORD: "admin"  # FE管理员密码
      BE_HOST: "10.199.199.111"  # BE节点IP地址
      BE_ADDR: "10.199.199.111:9051"  # BE节点通信地址（IP:端口）
      BE_ID: 1  # BE节点ID
    volumes:
      - /etc/localtime:/etc/localtime
      - /docker/doris-cluster/be1/storage:/opt/apache-doris/be/storage  # 数据存储目录
      - /docker/doris-cluster/be1/log:/opt/apache-doris/be/log  # 日志目录
      - ./doris_start/mysql-connector-java-5.1.47.jar:/opt/apache-doris/jdbc_drivers/mysql-connector-java-5.1.47.jar
    depends_on:
      - doris_fe1  # 依赖FE节点启动
    restart: always
    ports:
      - "8041:8041"  # BE HTTP端口
      - "9061:9061"  # BE心跳端口
      - "9051:9051"  # BE与FE通信端口
    networks:
      my_network:
        ipv4_address: 10.199.199.111

  # 可根据需求添加更多BE节点（如doris_be2、doris_be3），配置类似上述doris_be1，注意修改IP、端口和挂载目录

networks:
  my_network:
    external: true  # 使用外部网络（需提前创建）

关键配置说明

FE节点环境变量

BE节点环境变量

端口映射说明

启动与验证

1. 保存上述配置为docker-compose.yml
2. 执行命令启动集群：docker-compose up -d
3. 验证FE节点状态：访问http://FE_HOST:8030，查看集群状态
4. 验证BE节点状态：通过MySQL客户端连接FE的9030端口（mysql -h FE_HOST -P 9030 -u root -p），执行SHOW BACKENDS;查看BE节点状态

数据持久化

通过volumes配置挂载宿主机目录，确保以下数据持久化：

• FE：元数据目录（doris-meta）、日志目录（log）
• BE：数据存储目录（storage）、日志目录（log）

建议为不同节点创建独立的挂载目录，避免数据冲突。