Skip to content

Latest commit

 

History

History
91 lines (59 loc) · 3.28 KB

README.md

File metadata and controls

91 lines (59 loc) · 3.28 KB
Raw

Image transformation with NodeJS

This code is from the tutorial featured on Scaleway's documentation website.

In the tutorial, we transform images stored in an S3 bucket using serverless functions written in Node JS.

Requirements

This example assumes that you are familiar with:

  • how serverless functions work. If needed, you can check Scaleway official documentation.
  • how S3 object storage works, and especially how to create a bucket and upload files within a bucket. Please refer to scaleway's documentation here.
  • how to create and get user API access and secret keys using IAM. Please refer to IAM documentation here.

This example uses the Scaleway Serverless Framework Plugin. Please set up your environment with the requirements stated in the Scaleway Serverless Framework Plugin before trying out the example.

Additionnaly it uses the serverless-functions-node library for local testing.

Context

This example contains two functions:

  1. Connect to the storage bucket, pull all image files from it, then call the second function to resize each image
  2. Get a specific image (whose name is passed through the call's input data), resize it and push the resized image to a new bucket

Setup

Create two buckets

Create an S3 bucket and upload an RGB image (jpg, jpeg or png format) within this bucket. Keep the name of your bucket, this will be your source bucket. Create a second S3 bucket, this will be your destination bucket.

Fill environment variables

Ensure to create a bucket and have the following secrets and environment variables available in your environment (to be able to test locally) and within serverless.yml file (to be able to deploy):

secret:
  ACCESS_KEY: <bucket scw access key>
  ACCESS_KEY_ID: <bucket scw access key id>
  SOURCE_BUCKET: <source bucket name>
  DESTINATION_BUCKET: <bucket name>
  S3_ENDPOINT_URL: http://s3.fr-par.scw.cloud
  TRANSFORM_URL: <image transform url>
env:
  RESIZED_WIDTH: '500'

Install npm modules

Once your environment is set up, you can install npm dependencies from package.json file using:

npm install

Test locally

Once your environment is set up, you can test your functions locally with:

NODE_ENV=test node BucketScan.js
NODE_ENV=test node ImageTransform.js

This will launch local servers, allowing you to test the function. For that, you can run in another terminal:

curl -X GET "http://localhost:8080"

In your logs, you should see something similar to:

Successfully resized <SOURCE_BUCKET>/<filename> and uploaded to <DEST_BUCKET>/resized-<filename>"

Deploy and call the function

Finally, if the test succeeded, you can deploy your function with:

serverless deploy

Then, from the given URL, you can run:

curl -X GET "<function url>"

When invoking this function, the output should be similar to the one obtained when testing locally.