h-eye

H-Eye agent

This agent has the following responsibilities:

• REST based operations

  • REST endpoint to do CRUD on dataspaces.
  • Serialize results to be consumed in JSON

• Provide public URIs for infered assets.

• Invoke the EYE reasoner

• A small interpreter for dynamic operations on workspaces

Running it as command line

First of all, you need to install the EYE reasoner (Windows – OS X – Linux).

(make sure that you can run this using '/bin/sh eye', or set the EYE_PATH environment variable)

Then, install the server package as follows:

$ [sudo] npm -g install eyeserver

Running

hes serve <directory>

More options with

hes --help

To use

curl -i localhost:3000

And 'follow your nose'

Run with docker

Build hydra-eye server

docker build -t cvasquez/hydra-eye .

(to build a clean image from scratch use the --no-cache option)

Start the docker image

Start HydraEye on host port 3000:

docker run --name=hydra-eye -p 3000:3000 -v $PWD/workspace:/usr/src/app/workspace cvasquez/hydra-eye

Running your image with -d runs the container in detached mode, leaving the container running in the background. The -p flag redirects a public port to a private port inside the container. The -v flag mounts a directory to a directory inside the container.

If you need to go inside the container you can use the exec command:

# Enter the container
docker exec -it hydra-eye /bin/bash

Stop the docker container

docker rm -f hydra-eye

Test if it's up

curl -i localhost:3000