Druid RS 参数化部署镜像

镜像概述和主要用途

本镜像用于快速部署和运行 Apache Druid（[***] RS 环境设计。通过容器化方式提供隔离、可移植的 Druid 节点运行环境，降低集群部署和维护复杂度。

核心功能和特性

• 多节点类型支持：兼容 Druid 所有标准节点类型，包括 Coordinator、Overlord、Broker、Historical、MiddleManager 等，可通过参数指定目标节点角色。
• 参数化配置：针对 RS 环境优化的配置体系，支持通过环境变量动态调整节点参数，无需修改底层配置文件。
• 简化部署流程：内置包装脚本自动处理配置注入、依赖检查和启动流程，减少手动操作。
• 容器化优势：基于 Docker 容器实现环境隔离，确保跨平台一致性，支持快速扩缩容和版本管理。

使用场景和适用范围

• RS 相关项目：适用于需要部署 Druid 集群的 RS 内部项目或关联系统。
• 多环境适配：支持开发、测试及生产环境的 Druid 节点部署，可灵活切换节点角色。
• 集群构建：作为 Druid 集群的基础组件，用于搭建完整的分布式数据处理平台。

使用方法和配置说明

镜像拉取

docker pull [镜像仓库地址]/druid-rs:latest  # 需替换为实际镜像仓库地址

快速启动（docker run）

通过 docker run 命令启动指定类型的 Druid 节点，核心参数通过环境变量传入：

docker run -d \
  --name druid-coordinator \
  -e DRUID_NODE_TYPE=coordinator \
  -e ZOOKEEPER_CONNECT=zk-host:2181/druid \
  -e METADATA_DB_TYPE=postgresql \
  -e METADATA_DB_CONNECT_URI=jdbc:postgresql://db-host:5432/druid_metadata \
  -e METADATA_DB_USER=druid \
  -e METADATA_DB_PASSWORD=secret \
  -p 8081:8081 \
  [镜像仓库地址]/druid-rs:latest

Docker Compose 配置示例

以下为包含 Coordinator 和 Historical 节点的简易集群配置示例：

version: '3.8'
services:
  druid-coordinator:
    image: [镜像仓库地址]/druid-rs:latest
    container_name: druid-coordinator
    environment:
      - DRUID_NODE_TYPE=coordinator
      - ZOOKEEPER_CONNECT=zookeeper:2181/druid
      - METADATA_DB_TYPE=postgresql
      - METADATA_DB_CONNECT_URI=jdbc:postgresql://postgres:5432/druid_metadata
      - METADATA_DB_USER=druid
      - METADATA_DB_PASSWORD=druid123
    ports:
      - "8081:8081"
    depends_on:
      - zookeeper
      - postgres

  druid-historical:
    image: [镜像仓库地址]/druid-rs:latest
    container_name: druid-historical
    environment:
      - DRUID_NODE_TYPE=historical
      - ZOOKEEPER_CONNECT=zookeeper:2181/druid
      - METADATA_DB_TYPE=postgresql
      - METADATA_DB_CONNECT_URI=jdbc:postgresql://postgres:5432/druid_metadata
      - METADATA_DB_USER=druid
      - METADATA_DB_PASSWORD=druid123
      - DRUID_HISTORICAL_MAX_SIZE=10g  # 历史节点存储上限
    ports:
      - "8083:8083"
    depends_on:
      - zookeeper
      - postgres

  zookeeper:
    image: zookeeper:3.8
    container_name: zookeeper
    ports:
      - "2181:2181"

  postgres:
    image: postgres:14
    container_name: postgres
    environment:
      - POSTGRES_USER=druid
      - POSTGRES_PASSWORD=druid123
      - POSTGRES_DB=druid_metadata
    ports:
      - "5432:5432"

配置参数说明

注意事项

• 节点类型需与 Druid 集群角色匹配，不同节点需配置对应端口（如 Coordinator 默认 8081，Broker 默认 8082 等）。
• 生产环境中建议通过挂载外部配置文件（如 druid.properties）覆盖默认参数，确保配置持久化。
• 元数据库和 ZooKeeper 需提前部署并确保网络可达，建议使用独立的生产级服务（而非容器内临时实例）。