Orion-LD - FIWARE NGSI-LD 上下文代理

镜像概述和主要用途

Orion-LD 是一款实现 NGSI-LD API 标准的通用使能器（Generic Enabler），主要用途是作为 NGSI-LD 上下文代理，用于管理和处理上下文信息的创建、查询、更新和删除，支持符合 ETSI NGSI-LD 规范的上下文数据交互。目前以独立进程形式运行，未来计划通过插件机制扩展 Orion Context Broker，将 NGSI-LD 功能集成到 Orion 中。

核心功能和特性

• 符合 NGSI-LD 标准：完全实现 ETSI NGSI-LD API 规范，支持上下文实体的 CRUD 操作、订阅通知、批量操作等。
• 数据存储集成：依赖 MongoDB 存储上下文数据，支持单实例和副本集部署。
• 多租户支持：通过配置可启用多租户模式（Multi-tenancy），实现不同租户数据隔离。
• 订阅与通知机制：支持上下文数据变化的订阅，以及基于事件的通知推送，提供多种通知模式（持久化、临时、线程池）。
• 跨域资源共享（CORS）：可配置允许特定来源的跨域请求，支持 __ALL 通配符允许所有来源。
• 时间实体表示（TRoE）：可选启用 TRoE 功能，支持实体的时间序列数据管理，需配合 PostgreSQL 数据库。
• 上下文缓存：内置订阅缓存机制，可配置刷新间隔，提升查询性能。
• 灵活的网络配置：支持 IPv4/IPv6 协议，可配置 HTTPS 加密通信，自定义端口和连接超时。

使用场景和适用范围

• 物联网（IoT）平台：作为上下文管理核心，汇聚设备数据，提供标准化接口供上层应用查询和订阅设备状态。
• 智能城市系统：整合交通、能源、环境等领域的上下文信息，支持多部门（多租户）数据共享与协作。
• 工业4.0场景：管理生产线上的设备状态、物料流转等上下文数据，实现实时监控和事件驱动的自动化。
• 符合 ETSI 标准的系统集成：需要遵循 NGSI-LD 规范的项目，确保与其他 FIWARE 组件或第三方系统互操作。

详细使用方法和配置说明

前置条件

• Docker 环境（18.06+）及 Docker Compose（可选）。
• MongoDB 实例（3.6+，推荐使用副本集提升可靠性）。
• 若启用 TRoE 功能，需额外部署 PostgreSQL 数据库。

部署示例

1. Docker Compose 部署（推荐）

以下示例包含 Orion-LD 和 MongoDB 的基础部署配置，适用于开发和测试环境：

yaml
version: "3.5"
services:
  orion:
    image: fiware/orion-ld
    hostname: orion
    container_name: fiware-orion
    ports:
      - "1026:1026"  # NGSI-LD API 端口
    depends_on:
      - mongo-db
    environment:
      - ORIONLD_MONGO_HOST=mongo-db  # MongoDB 主机地址
      - ORIONLD_LOG_LEVEL=DEBUG      # 日志级别（DEBUG/INFO/WARN/ERROR）
      - ORIONLD_FOREGROUND=true      # 前台运行（容器场景推荐设为 true）

  mongo-db:
    image: mongo:3.6
    hostname: mongo-db
    container_name: db-mongo
    ports:
      - "27017:27017"  # MongoDB 端口
    volumes:
      - mongo-db:/data/db  # 持久化数据卷
    command: --nojournal  # 禁用 journal（仅测试环境，生产环境建议启用）

volumes:
  mongo-db:  # 定义数据卷，持久化 MongoDB 数据

启动命令：docker-compose up -d

2. Docker Run 命令部署

单独启动 Orion-LD（需提前启动 MongoDB）：

bash
docker run -d \
  --name fiware-orion \
  -p 1026:1026 \
  -e ORIONLD_MONGO_HOST=<mongodb-host> \
  -e ORIONLD_MONGO_PORT=27017 \
  -e ORIONLD_LOG_LEVEL=INFO \
  -e ORIONLD_FOREGROUND=true \
  fiware/orion-ld

替换 <mongodb-host> 为实际 MongoDB 主机地址（如宿主机 IP 或容器名称）。

环境变量配置说明

Orion-LD 支持通过环境变量自定义配置，以下是主要参数说明：

验证部署

部署后，可通过以下命令验证服务是否正常运行：

bash
# 检查容器状态
docker ps | grep fiware-orion

# 发送健康检查请求（返回 NGSI-LD 版本信息）
curl -X GET http://localhost:1026/version

预期响应（示例）：

json
{
  "orionld version": "1.1.0",
  "ngsi-ld version": "1.4.2",
  "fiware release": "FIWARE 8.2"
}

构建镜像

如需自定义镜像，可参考***文档：Orion-LD Docker 构建指南。