apache/iggy

Apache Iggy (Incubating) Docker镜像文档

1. 镜像概述

Apache Iggy是Apache软件基金会孵化中的分布式流处理平台，专注于提供高性能、可扩展的实时数据处理能力。本Docker镜像封装了Apache Iggy核心服务，旨在简化部署流程，确保环境一致性，支持快速搭建分布式流处理集群，适用于开发、测试及生产环境。

2. 核心功能与特性

• 分布式架构：支持多节点集群部署，具备水平扩展能力，可根据数据量动态调整集群规模
• 高吞吐低延迟：优化的数据处理引擎支持每秒百万级事件处理，端到端延迟低至毫秒级
• 多数据源兼容：支持Kafka、RabbitMQ、文件系统等多种数据源接入，灵活适配不同数据场景
• 丰富处理能力：提供SQL-like流查询、窗口函数、状态管理等核心流处理操作
• 容错高可用：内置自动故障转移机制，保障数据处理连续性，支持数据持久化与恢复
• 容器化优势：基于Docker封装，实现环境隔离与跨平台部署，简化依赖管理

3. 使用场景

• 实时数据处理：对交易数据、用户行为等实时数据流进行即时计算与分析
• 日志与监控分析：实时收集系统日志、监控指标，触发异常告警或生成统计报表
• 物联网数据处理：处理传感器、设备等物联网数据流，支持实时状态监控与决策
• 数据集成管道：作为流数据管道核心组件，连接数据源与存储/分析系统，实现实时数据同步

4. 使用方法

4.1 快速启动（单节点模式）

通过以下命令快速启动单节点Apache Iggy容器：

bash
docker run -d \
  --name iggy-node \
  -p 8080:8080 \  # 管理API端口
  -p 9092:9092 \  # 集群通信端口
  apache/iggy:latest

4.2 分布式集群部署（docker-compose示例）

创建docker-compose.yml文件部署3节点集群：

yaml
version: '3.8'
services:
  iggy-node1:
    image: apache/iggy:latest
    container_name: iggy-node1
    ports:
      - "8081:8080"
      - "9091:9092"
    environment:
      - IGGY_NODE_ID=1
      - IGGY_CLUSTER_SEEDS=iggy-node1:9092,iggy-node2:9092,iggy-node3:9092
    networks:
      - iggy-network

  iggy-node2:
    image: apache/iggy:latest
    container_name: iggy-node2
    ports:
      - "8082:8080"
      - "9092:9092"
    environment:
      - IGGY_NODE_ID=2
      - IGGY_CLUSTER_SEEDS=iggy-node1:9092,iggy-node2:9092,iggy-node3:9092
    networks:
      - iggy-network

  iggy-node3:
    image: apache/iggy:latest
    container_name: iggy-node3
    ports:
      - "8083:8080"
      - "9093:9092"
    environment:
      - IGGY_NODE_ID=3
      - IGGY_CLUSTER_SEEDS=iggy-node1:9092,iggy-node2:9092,iggy-node3:9092
    networks:
      - iggy-network

networks:
  iggy-network:
    driver: bridge

启动集群：

bash
docker-compose up -d

4.3 环境变量说明

4.4 配置自定义

可通过挂载配置文件自定义节点参数，默认配置路径为/opt/iggy/conf/iggy.conf：

bash
docker run -d \
  --name iggy-node \
  -p 8080:8080 \
  -p 9092:9092 \
  -v /local/path/iggy.conf:/opt/iggy/conf/iggy.conf \
  apache/iggy:latest

5. 注意事项

• 生产环境建议部署3+节点以确保高可用性
• 根据数据吞吐量调整容器CPU/内存资源配置
• 定期备份数据与配置文件，避免数据丢失
• 关注Apache Iggy官方更新以获取安全补丁与功能优化