Skip to content

Host Library Microservice

The lib microservice is a simplified file manager serving files over graphQL and HTTP API.

It has two features:

  • provide a listing of directory contents.
  • upload and download files

This document provides instructions for installing npm package of library microservice and running the same as a standalone service.

Setup the File System

Outside DTaaS

The package can be used independently of DTaaS. If this is your use case, you do not need any specific file structure. Any valid file directory is sufficient.

Inside DTaaS

The users of DTaaS expect the following file system structure for their reusable assets.

File System Layout

There is a skeleton file structure in files directory.

⬇ Install

The npm package is available in Github packages registry and on npmjs. Prefer the package on npmjs over Github.

Set the registry and install the package with the one of the two following commands

npmjs

1
sudo npm install -g @into-cps-association/libms@0.5.4  # requires no login

Github

1
2
# requires login
sudo npm config set @into-cps-association:registry https://npm.pkg.github.com

The github package registry asks for username and password. The username is your Github username and the password is your Github personal access token. In order for the npm to download the package, your personal access token needs to have read:packages scope.

🚀 Use

Display help.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
$libms -h
Usage: libms [options]

The lib microservice is a file server. It supports file transfer
over GraphQL and HTTP protocols.

Options:
  -c, --config <file>  provide the config file (default libms.yaml)
  -H, --http <file>    enable the HTTP server with the specified config
  -h, --help           display help for libms

Both the options are not mandatory.

Please see configuration for explanation of configuration conventions. The config is saved libms.yaml file by convention. If -c is not specified The libms looks for libms.yaml file in the working directory from which it is run. If you want to run libms without explicitly specifying the configuration file, run

1
libms

To run libms with a custom config file,

1
2
libms -c FILE-PATH
libms --config FILE-PATH

If the environment file is named something other than libms.yaml, for example as libms-config.yaml, you can run

1
libms -c "config/libms-config.yaml"

You can press Ctl+C to halt the application. If you wish to run the microservice in the background, use

1
nohup libms [-c FILE-PATH] & disown

The lib microservice is now running and ready to serve files.

Protocol Support

The libms supports GraphQL protocol by default. This microservice can also serve files in a browser with files transferred over HTTP protocol.

This option needs to be enabled with -H http.json flag. A sample http config provided here can be used.

1
nohup libms [-H http.json] & disown

The regular file upload and download options become available.

Service Endpoints

The GraphQL URL: localhost:PORT/lib

The HTTP URL: localhost:PORT/lib/files

The service API documentation is available on user page.