ging/fiware-draco

FIWARE Draco Docker镜像文档

镜像概述和主要用途

FIWARE Draco Docker镜像是FIWARE生态系统的官方镜像，基于Apache NiFi构建。该镜像集成了额外的处理器，专门用于管理NGSI（Next Generation Service Interface）上下文数据。Apache NiFi是一个基于流编程（flow-based programming）概念的数据flow系统，提供了强大的数据路由、转换和系统中介功能，而Draco在此基础上增强了对NGSI上下文数据的处理能力，适用于物联网（IoT）场景中的上下文信息管理与流转。

核心功能和特性

• 基于Apache NiFi：继承NiFi的核心数据流处理能力，包括可视化流程设计、数据路由、转换、优先级队列等
• NGSI上下文数据支持：包含专用处理器，用于NGSI上下文数据的接收、解析、转换和发送
• 流编程模型：采用流编程范式，支持复杂数据flow的可视化配置与管理
• 可扩展性：支持自定义处理器扩展，适应特定业务场景需求
• 可靠性：提供数据容错机制，确保数据处理的可靠性和一致性

使用场景和适用范围

• 物联网数据处理：处理来自IoT设备的上下文信息，实现数据的实时流转与转换
• FIWARE生态集成：与FIWARE其他组件（如Orion Context Broker）配合，构建完整的上下文管理系统
• 上下文数据中介：作为不同系统间的中介，实现NGSI数据与其他格式数据的转换与交互
• 数据flow自动化：通过可视化流程设计，实现上下文数据处理流程的自动化配置与运行

使用方法和配置说明

基本使用（Docker Run）

通过以下命令启动Draco容器：

bash
docker run -d -p 8080:8080 --name fiware-draco fiware/draco

• -d：后台运行容器
• -p 8080:8080：映射容器的8080端口（NiFi Web UI默认端口）到主机的8080端口
• --name fiware-draco：指定容器名称为fiware-draco
• fiware/draco：使用FIWARE Draco官方镜像

访问Web UI

容器启动后，通过浏览器访问 http://<主机IP>:8080 即可打开NiFi Web UI，进行数据流的设计与管理。

持久化数据（可选）

为确保配置和数据持久化，可挂载本地目录到容器内的NiFi数据目录：

bash
docker run -d -p 8080:8080 \
  -v /本地路径/nifi/conf:/opt/nifi/nifi-current/conf \
  -v /本地路径/nifi/data:/opt/nifi/nifi-current/data \
  --name fiware-draco fiware/draco

• /opt/nifi/nifi-current/conf：NiFi配置文件目录
• /opt/nifi/nifi-current/data：NiFi数据存储目录

环境变量配置（可选）

可通过环境变量调整NiFi运行参数，例如设置JVM内存：

bash
docker run -d -p 8080:8080 \
  -e NIFI_JVM_HEAP_INIT=2g \
  -e NIFI_JVM_HEAP_MAX=4g \
  --name fiware-draco fiware/draco

• NIFI_JVM_HEAP_INIT：JVM初始堆内存
• NIFI_JVM_HEAP_MAX：JVM最大堆内存

Docker Compose配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  draco:
    image: fiware/draco
    container_name: fiware-draco
    ports:
      - "8080:8080"
    volumes:
      - ./nifi/conf:/opt/nifi/nifi-current/conf
      - ./nifi/data:/opt/nifi/nifi-current/data
    environment:
      - NIFI_JVM_HEAP_INIT=2g
      - NIFI_JVM_HEAP_MAX=4g
    restart: unless-stopped

通过 docker-compose up -d 启动服务。

注意事项

• 默认情况下，NiFi Web UI无需认证，生产环境中建议通过NiFi配置启用安全认证
• 首次启动时，NiFi可能需要几分钟时间完成初始化
• 如需使用NGSI处理器，需在NiFi Web UI中添加并配置相应的处理器组件（如NGSISource、NGSIDestination等）