SkoHub Reconcile Publish

This respository provides a simple web service that can be used to publish vocabularies as Turtle Files to the SkoHub Reconcile Service.

It is a simple Express.js application that provides an HTML-Upload form on its root and an upload endpoint under /upload.

Uploaded files are stored in an uploads folder.

You can also upload files to the service using curl. To do so, you have to provide the following parameters:

• account: the account name for the SkoHub Reconcile Service
• id: this is used for logging out the upload status and should be unique (try uuidgen for a unique id)
• uploaded_file: the path to your uploaded file. Notice the @ sign. The @ symbol in curl is used to specify a file upload in a multipart/form-data request.

Also the order matters. So please always start with account and id.

Example:

curl -F account=test -F id=123 -F uploaded_file=@./uploads/dini-ag-kim/hcrt.ttl http://localhost:3030/upload

Setup

Development:

• node >= 18 (for development)

Running the Service:

• docker

Environment Variables

To run the service, you need to have a .env file in the root directory of the project. You can use the provided .sample.env as a template. Run cp .sample.env .env to create the environment file.

Network

The service uses an external network to communicate with the SkoHub Reconcile module.

Before you start the service make sure the network reconcile-backend exists. You can create it with:

docker network create reconcile-backend

Run the Service

Then, you can run the service with:

docker compose up

This will start the Reconciliation service on the port specified with APP_PORT_EXPOSED in .env.

Development

Install dependencies with npm i. Then start the service with npm run dev.

Credits