mono

 

Easily host web frameworks and applications on a single AWS Lambda function using this Serverless Component.

Features

• Designed to make it easy to host pre-existing web frameworks (e.g. Express.js, Hapi) or any large web application on a single AWS Lambda Function.
• Blazing Fast Uploads via AWS S3 Accelerated Transfer and Multi-Part.
• Dependencies are automatically put in AWS Lambda Layers, reducing cold-start time and further reducing upload time.
• Simple shim for receiving and responding to HTTP requests.

 

1. Install
2. Create
3. Configure
4. Deploy

 

1. Install

1$ npm install -g @serverless/components

2. Create

1$ mkdir mono && cd mono

The directory should look something like this:

|- serverless.yml # required
|- index.js       # required
|- package.json   # optional
|- .env           # your development AWS api keys
|- .env.prod      # your production AWS api keys

the .env files are not required if you have the aws keys set globally and you want to use a single stage, but they should look like this.

AWS_ACCESS_KEY_ID=XXX
AWS_SECRET_ACCESS_KEY=XXX

The index.js file should look something like this.

1module.exports = async (e, ctx, cb) => {
2  return { statusCode: 200, body: 'mono app deployed.' }
3}
4
5// you could also just return an object
6// which would return it as body with
7// 200 status code by default
8// module.exports = () => ({ hello: 'world' })
9
10// or just a string
11// module.exports = () => 'success'
12
13// or a status code number
14// module.exports = () => 404 // not found!
15
16// you don't even need to export a function!
17// module.exports = { hello: 'world' } // great for mocking!
18// module.exports = 'success'
19// module.exports = 500

3. Configure

All the following inputs are optional. However, they allow you to configure your Lambda compute instance and pass environment variables.

1# serverless.yml
2
3name: mono
4stage: dev
5
6mono:
7  component: "@serverless/mono"
8  inputs:
9    name: my-mono-app
10    description: My Mono App
11    region: us-east-1
12    memory: 128
13    timeout: 10
14    env:
15      TABLE_NAME: my-table
16
17    # the directory that contains the index.js file.
18    # If not provided, the default is the current working directory
19    # code: ./code
20
21

4. Deploy

1mono (master)$ components
2
3  Mono › outputs:
4  url:  'https://bbhm7tk587.execute-api.us-east-1.amazonaws.com/dev/'
5
6
7  7s › dev › Mono › done
8
9mono (master)$

All requests to this root url will be proxied directly to your lambda function, giving you full control of the http layer.

 

New to Components?

Checkout the Serverless Components repo for more information.