RabbitMQ wrapper for Hets. It listens to the queue for Hets-jobs and invokes Hets accordingly. For some jobs, it sends jobs back to the ontohub-backend to post-process the result.
- Install Hets
- Install RabbitMQ
- Install the RabbitMQ extension "Recent History Exchange": You can enable it with
rabbitmq-plugins enable rabbitmq_recent_history_exchange - Use the Ruby-version that is noted in the file
.ruby-version. - To install the dependencies, run
in the repository directory.
bundle
Create a config/settings.local.yml with the local configuration.
The hets.path needs to point to the hets executable.
Each instance of the hets-agent in the system (even across machines) needs to have a distinct agent.id value.
The agent.id is used to create a queue that only this instance listens to.
This queue will receive the version requirement.
This agent.id can be overridden by setting the environment variable HETS_AGENT_ID.
The backend.api_key needs to be registered in the backend.
We recommend to have one API-key per hets-agent instance.
Make sure to run bundle exec rails rabbitmq:send_hets_version from the ontohub-backend repository before the first
start to set a version requirement.
- To start it in the development environment, run
bundle exec bin/hets-agent
to listen for jobs in a development environment.
- For a production environment, set the environment variable
HETS_AGENT_ENV=productionadditionally:HETS_AGENT_ENV=production bundle exec bin/hets-agent