MsgFlo example: Image resizing service

Example of how to build a backend service for CPU-intensive tasks using Msgflo.

Deploying to Heroku

The absolutely quickest way to get running is to deploy the sevice to Heroku.

API

FIXME: document

• API. HTTP POST. JSON body. Array of images. URL and desired height/width. Returns 202 Accepted, with Location. Ref. https://benramsey.com/blog/2008/04/http-status-201-created-vs-202-accepted/
• Downloads image. Rescales. Uploads downscaled. Updates job status.

TODO

Minimal

• Add checks for successful job completion test

Bonus

• Fix marking job status with completed
• UI: Accept URLs

Running locally

Prerequisites

The following software needs to be preinstalled

• Node.js 6+
• Postgres 9.6+
• RabbitMQ 3.6+

Also needed is an Amazon S3 bucket, and the associated credentials.

Download git repo

git clone https://github.com/msgflo/msgflo-example-imageresize.git
cd msgflo-example-imageresize

Install

npm install

One-time setup

Create the database

psql -c 'create database imageresize_test;' -U postgres

Run database migrations and bind message queues

npm run setup

Configure

Configure Amazon S3 access

export IMAGERESIZE_S3_KEY=key
export IMAGERESIZE_S3_SECRET=secret
export IMAGERESIZE_S3_BUCKET=bucket

Run

Run the entire service

npm start

Run tests

npm test