Orion-LD is a Context Broker and CEF building block for context data management which supports both the NGSI-LD and the NGSI-v2 APIs. It is currently a fork of the original Orion Context Broker extending support to add NGSI-LD and linked data concepts. Orion-LD follows the ETSI specification for NGSI-LD and has been tested to be a stable and fast NGSI-LD broker with close compliance to the version 1.3.1 of the NGSI-LD API specification.
Note that the NGSI-LD specification is a living, changing document (version 1.5 as of June 2021), with features being continuously added at a pace such that it is not possible to align a context broker to the cutting edge specification for NGSI-LD implementation.
The latest release of Orion-LD is (Beta 3 of June 2021) and it contains the following additions with respect to Beta 1 (initially alpha-6):
- Query responses and notifications in GeoJSON format, if so requested (Accept: application/geo+json)
- Performance improvements
- Bug fixes
- Working and tested implementation of the optional interface for Temporal Representation of Entities (TRoE - feel free to use, but at your own risk ;-))
The plan is to merge Orion-LD back into the main branch of the original Orion at some point.
This project is part of FIWARE. For more information check the FIWARE Catalogue entry for Core Context.
Issues on this projects can be reported as github issues, while
questions are preferred on Stackoverflow, using the tag fiware-orion.
| 📚 Documentation | 🎓 Academy | 🐳 Docker Hub |
|---|
If you want to start testing NGSI-LD, one option is to use Docker.
There are a number of docker images to choose from.
If you (at your own risk) want to evaluate the bleeding edge development changes, you can use the latest image:
docker run fiware/orion-ld:latest or even better: use
docker compose to run it
If you instead want to use a more stable image, the latest beta release (as of June 2021) is 0.8.0
docker run fiware/orion-ld:0.8.0Please check dockerhub for newer releases.
NGSI-LD is an an extended subset of JSON-LD for use with context management systems, its payloads are encoded as linked data using JSON. This presentation from FIWARE Summit Malaga 2018 is also of interest: https://www.slideshare.net/FI-WARE/fiware-global-summit-ngsild-ngsi-with-linked-data
If you are not sharing your data across systems and have no need of linked data concepts, then the current stable version of NGSI - NGSI-v2 is sufficient please use the original unforked Orion instead.
This component is currently a beta release but already passing most of the NGSI-LD test suite
Examples of NGSI-LD can be found in ETSI. See also the OpenAPI Specification of NGSI-LD
Documentation:
- Guide to NGSI-LD entities and attributes
- Guide to the context
- Installation Guide
- Quick Start Guide
- External Libraries
- Temporal Representation
- The Broker as Context Server
A Test Suite for NGSI-LD can be found here.