ISOBlue Data Microservice

ISOBlue Data Microservice works as an interface between ISOBlue devices and an OADA Server. The microservice consumes ISOBlue Kafka messages from the specified broker and store them to the OADA server.

Prerequisites

You will need:

• Docker
• An OADA Server with write access to oada.isoblue scope type
• A Kafka broker

Getting Started

First, clone the repository:

git clone https://github.com/ISOBlue/isoblue-data-uservice.git

This microservice runs as a Docker container. To build the container, open the top directory of the cloned repository (i.e., cd isoblue-data-uservice) and run:

docker build -t isoblue-uservice .

The URL to the OADA server and the Kafka broker are specified in defaultenv.list file. Open the defaultenv.list file and update the parameters.

To start the container, run:

docker run --env-file defaultenv.list isoblue-uservice

Notes

• The docker container may not be able to connect to an OADA server or a Kafka broker running on localhost. This is because the container uses the bridge networking mode by default. You can add --network="host" argument to the docker run command as a workaround. You can find more information here.
• For development, you may need to set NODE_TLS_REJECT_UNAUTHORIZED=0 in defaultenv.list to ignore self-signed certificates. (WARNING: This is insecure!)