mos-adebayo/hb_backend_node

A simple stateless microservice in Nodejs which generates image thumbnails

HB Back-End

This is a simple stateless microservice in Nodejs, with three major features -

• Authentication; this returns a signed JWT
• JSON Patch; this applies a patch to a JSON document and returns it
• Image Resize (Thumbnail); this resizes an image to 50x50 pixels and returns it

Usage

To run this project follow these steps:

Run npm i or yarn to install all the dependencies

Then run npm start to start the project

Additionally, you can run npm test to run the tests included in the project.

NOTE: Your server has to be running for the integration tests to complete. Also, it is recommended to have an internet connection when running the test.image_thumbnail.js integration test in order to enable it download the image for resize.

Docker

The public image for this project on Docker Hub is at https://hub.docker.com/r/aikaykalz/hb-backend/ To pull the repository,

$ docker pull mosadebayo/hb_node_app

You can run the image for your terminal using the following command

$ docker run --rm -p 3000:3000 mosadebayo/hb_node_app

NOTE: If you encounter permission errors, you should consider running the command with sudo.

Routes

This project has just three routes (one public route and two protected routes) and are as follows:

• POST http://localhost:3000/login for the login function. This also signs a JSON Web Token for use in the other two routes. Example Request body:

      {
          username: 'username',
          password: 'password'
      }

• PATCH http://localhost:3000/apply-patch for the JSON Patch function. This applies performs the patch operaion with the data provided in the object. Example Request body:

      { 
          jsonObj: {
              "name": "Adebayo",
              "location": "Lagos"
          }, 
          patchObj: {
              "op": "replace",
              "path": "/name",
              "value": "Adeola"
          }
      }

• GET http://localhost:3000/gen-thumbnail for the image thumbnail function. This downloads a public image, resizes it (to 50x50 pixels) and returns the resultant image Example Request URL:

  http://localhost:3000/gen-thumbnail?image=https://www.openuped.eu/images/badge/icons/anywhere-online.png

NOTE: Depending on your configuration, you may need to change the host and/or the port number in the URL. For the Patch and Thumbnail URLs, you need to add a header value containing the token. Example:

{
    token: 'your_token_returned_from_the_login_request'
}

Monitor

This application uses node-js dashboard for monitoring. To start the monitor, type the following in your terminal

$ npm run dev