telefonicaiot/fiware-cygnus-ld

Cygnus-LD镜像

镜像概述

Cygnus-LD是FIWARE框架的核心组件之一，作为上下文数据持久化连接器，基于Apache Flume构建，负责将NGSI-LD等上下文数据源的信息持久化到HDFS、MySQL、MongoDB等多种第三方数据库和存储系统，实现上下文数据的历史视图管理。该镜像属于FIWARE Core Context Management范畴，遵循AGPL-3.0开源许可证。

核心功能

1. 多源数据持久化：支持NGSI-LD上下文数据、***数据等存储到HDFS、MySQL、MongoDB、PostgreSQL、Elasticsearch等存储系统；
2. 流处理能力：基于Flume的流处理机制，实现数据的定向路由、格式转换与可靠传输；
3. 灵活扩展：通过配置不同的Flume Agent（源、通道、Sink），可灵活扩展存储目标与数据处理逻辑；
4. FIWARE生态兼容：与Orion Context Broker等FIWARE组件无缝集成，支撑智能城市、物联网等场景的数据管理需求。

使用场景

• 智能城市：存储交通流量、环境监测等物联网设备的上下文数据，用于历史趋势分析与决策支持；
• 工业物联网：持久化设备运行状态数据，支持故障回溯、预测维护与性能优化；
• 开放数据平台：将NGSI格式的公共数据同步到CKAN等平台，供公众查询与使用；
• 企业数据管理：整合多源上下文数据，构建统一的历史数据仓库。

配置说明

Cygnus-LD的配置通过环境变量或挂载配置文件实现，关键配置项包括：

• Source配置：指定数据接收方式（如HTTP端口、Kafka主题）；
• Channel配置：选择内存通道（高效）或文件通道（可靠）；
• Sink配置：设置目标存储系统的连接参数（如数据库地址、认证信息、存储格式）。

Docker部署示例

基础运行命令

bash
docker run -d --name cygnus-ld \
  -p 5050:5050 \
  -e CYGNUS_LD_CONF_FILE=/opt/cygnus/conf/cygnus-ld.conf \
  telefonicaiot/fiware-cygnus-ld

Docker Compose示例

yaml
version: '3'
services:
  cygnus-ld:
    image: telefonicaiot/fiware-cygnus-ld
    ports:
      - "5050:5050"
    volumes:
      - ./cygnus-ld.conf:/opt/cygnus/conf/cygnus-ld.conf
    environment:
      - CYGNUS_LOG_LEVEL=INFO
      - CYGNUS_LD_SINK_TYPE=mongodb # 示例：指定Sink类型为MongoDB

说明：需提前准备cygnus-ld.conf配置文件，定义具体的Source、Channel和Sink参数，以适配目标存储系统。