Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lambci/node-custom-lambda

A custom runtime for AWS Lambda to execute functions in Node.js v10.x or v12.x
https://github.com/lambci/node-custom-lambda

Last synced: 2 months ago
JSON representation

A custom runtime for AWS Lambda to execute functions in Node.js v10.x or v12.x

Host: GitHub
URL: https://github.com/lambci/node-custom-lambda
Owner: lambci
License: mit
Created: 2018-11-29T18:59:01.000Z (about 6 years ago)
Default Branch: master
Last Pushed: 2021-04-07T22:08:27.000Z (almost 4 years ago)
Last Synced: 2024-08-02T06:13:26.264Z (5 months ago)
Language: Shell
Homepage:
Size: 923 MB
Stars: 222
Watchers: 8
Forks: 48
Open Issues: 7
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

awesome-layers - `lambci/node-custom-lambda` - version/us-east-1/553035198032/nodejs12) | (Layers / Runtimes)

README

        # Node.js 10.x and 12.x for AWS Lambda

A [custom runtime](https://aws.amazon.com/about-aws/whats-new/2018/11/aws-lambda-now-supports-custom-runtimes-and-layers/)

for AWS Lambda to execute functions in Node.js 10.x or 12.x

## Getting Started

Save as `index.js`:

```js

exports.handler = async(event, context) => {

  console.log(`Hi from Node.js ${process.version} on Lambda!`)

  console.log(`There is ${context.getRemainingTimeInMillis()}ms remaining`)

  return event

}

```

Then bundle up into a zipfile – this is your function bundle:

```sh

zip -yr lambda.zip index.js  # add node_modules too if you have any

```

Create a new Lambda function and choose the custom runtime option.

![Create lambda](https://raw.githubusercontent.com/lambci/node-custom-lambda/master/img/create.png "Create lambda screenshot")

Select your `lambda.zip` as the "Function code" and make the handler "index.handler".

![Function code](https://raw.githubusercontent.com/lambci/node-custom-lambda/master/img/function_code.png "Function code setup screenshot")

Then click on Layers and choose "Add a layer", and "Provide a layer version ARN" and enter the following ARN:

```

arn:aws:lambda:us-east-1:553035198032:layer:nodejs12:41

```

Or [use this link](https://console.aws.amazon.com/lambda/home?region=us-east-1#/connect/layer?layer=arn:aws:lambda:us-east-1:553035198032:layer:nodejs12:41)

and pick your function from the "Function name" auto-suggest.

![Add a layer](https://raw.githubusercontent.com/lambci/node-custom-lambda/master/img/layer.png "Add a layer screenshot")

Then save your lambda and test it with a test event!

![Test event output](https://raw.githubusercontent.com/lambci/node-custom-lambda/master/img/log.png "Test event output screenshot")

## Current Version ARNs

| Node.js version | ARN |

| --- | --- |

| 10.24.1 | `arn:aws:lambda::553035198032:layer:nodejs10:31` |

| 12.22.1 | `arn:aws:lambda::553035198032:layer:nodejs12:41` |

## Previous Version ARNs

| Node.js version | ARN |

| --- | --- |

| 10.24.0 | `arn:aws:lambda::553035198032:layer:nodejs10:30` |

| 12.21.0 | `arn:aws:lambda::553035198032:layer:nodejs12:40` |

| 12.20.2 | `arn:aws:lambda::553035198032:layer:nodejs12:39` |

| 10.23.3 | `arn:aws:lambda::553035198032:layer:nodejs10:29` |

| 12.20.1 | `arn:aws:lambda::553035198032:layer:nodejs12:38` |

| 10.23.1 | `arn:aws:lambda::553035198032:layer:nodejs10:28` |

| 12.20.0 | `arn:aws:lambda::553035198032:layer:nodejs12:37` |

| 10.23.0 | `arn:aws:lambda::553035198032:layer:nodejs10:27` |

| 12.19.1 | `arn:aws:lambda::553035198032:layer:nodejs12:36` |

| 12.19.0 | `arn:aws:lambda::553035198032:layer:nodejs12:35` |

| 10.22.1 | `arn:aws:lambda::553035198032:layer:nodejs10:26` |

| 12.18.4 | `arn:aws:lambda::553035198032:layer:nodejs12:34` |

| 10.22.0 | `arn:aws:lambda::553035198032:layer:nodejs10:25` |

| 12.18.3 | `arn:aws:lambda::553035198032:layer:nodejs12:33` |

| 12.18.2 | `arn:aws:lambda::553035198032:layer:nodejs12:32` |

| 10.21.0 | `arn:aws:lambda::553035198032:layer:nodejs10:24` |

| 12.18.1 | `arn:aws:lambda::553035198032:layer:nodejs12:31` |

| 12.18.0 | `arn:aws:lambda::553035198032:layer:nodejs12:30` |

| 10.20.1 | `arn:aws:lambda::553035198032:layer:nodejs10:23` |

| 12.17.0 | `arn:aws:lambda::553035198032:layer:nodejs12:29` |

| 12.16.3 | `arn:aws:lambda::553035198032:layer:nodejs12:28` |

| 12.16.2 | `arn:aws:lambda::553035198032:layer:nodejs12:26` |

| 10.20.0 | `arn:aws:lambda::553035198032:layer:nodejs10:22` |

| 12.16.1 | `arn:aws:lambda::553035198032:layer:nodejs12:25` |

| 10.19.0 | `arn:aws:lambda::553035198032:layer:nodejs10:21` |

| 12.16.0 | `arn:aws:lambda::553035198032:layer:nodejs12:24` |

| 12.15.0 | `arn:aws:lambda::553035198032:layer:nodejs12:23` |

| 10.18.1 | `arn:aws:lambda::553035198032:layer:nodejs10:20` |

| 12.14.1 | `arn:aws:lambda::553035198032:layer:nodejs12:22` |

| 10.18.0 | `arn:aws:lambda::553035198032:layer:nodejs10:19` |

| 12.14.0 | `arn:aws:lambda::553035198032:layer:nodejs12:21` |

| 10.17.0 | `arn:aws:lambda::553035198032:layer:nodejs10:18` |

| 12.13.1 | `arn:aws:lambda::553035198032:layer:nodejs12:20` |

| 12.13.0 | `arn:aws:lambda::553035198032:layer:nodejs12:19` |

| 10.16.3 | `arn:aws:lambda::553035198032:layer:nodejs10:17` |

| 12.12.0 | `arn:aws:lambda::553035198032:layer:nodejs12:18` |

| 12.11.1 | `arn:aws:lambda::553035198032:layer:nodejs12:17` |

| 12.11.0 | `arn:aws:lambda::553035198032:layer:nodejs12:16` |

| 12.10.0 | `arn:aws:lambda::553035198032:layer:nodejs12:15` |

| 12.9.1 | `arn:aws:lambda::553035198032:layer:nodejs12:14` |

| 12.9.0 | `arn:aws:lambda::553035198032:layer:nodejs12:13` |

| 12.8.1 | `arn:aws:lambda::553035198032:layer:nodejs12:12` |

| 10.16.2 | `arn:aws:lambda::553035198032:layer:nodejs10:16` |

| 12.8.0 | `arn:aws:lambda::553035198032:layer:nodejs12:11` |

| 12.7.0 | `arn:aws:lambda::553035198032:layer:nodejs12:10` |

| 10.16.1 | `arn:aws:lambda::553035198032:layer:nodejs10:15` |

| 10.16.0 | `arn:aws:lambda::553035198032:layer:nodejs10:14` |

| 12.6.0 | `arn:aws:lambda::553035198032:layer:nodejs12:9` |

| 12.5.0 | `arn:aws:lambda::553035198032:layer:nodejs12:8` |

| 12.4.0 | `arn:aws:lambda::553035198032:layer:nodejs12:7` |

| 12.3.1 | `arn:aws:lambda::553035198032:layer:nodejs12:6` |

| 10.15.3 | `arn:aws:lambda::553035198032:layer:nodejs10:13` |

| 12.3.0 | `arn:aws:lambda::553035198032:layer:nodejs12:5` |

| 12.2.0 | `arn:aws:lambda::553035198032:layer:nodejs12:4` |

| 12.1.0 | `arn:aws:lambda::553035198032:layer:nodejs12:2` |

| 12.0.0 | `arn:aws:lambda::553035198032:layer:nodejs12:1` |

| 11.14.0 | `arn:aws:lambda::553035198032:layer:nodejs11:17` |

| 11.13.0 | `arn:aws:lambda::553035198032:layer:nodejs11:16` |

| 11.12.0 | `arn:aws:lambda::553035198032:layer:nodejs11:13` |

| 11.11.0 | `arn:aws:lambda::553035198032:layer:nodejs11:11` |

| 11.10.1 | `arn:aws:lambda::553035198032:layer:nodejs11:10` |

| 10.15.2 | `arn:aws:lambda::553035198032:layer:nodejs10:7` |

| 10.15.1 | `arn:aws:lambda::553035198032:layer:nodejs10:6` |

| 11.10.0 | `arn:aws:lambda::553035198032:layer:nodejs11:9` |

| 11.9.0 | `arn:aws:lambda::553035198032:layer:nodejs11:8` |

| 11.8.0 | `arn:aws:lambda::553035198032:layer:nodejs11:7` |

| 10.15.0 | `arn:aws:lambda::553035198032:layer:nodejs10:5` |

| 11.7.0 | `arn:aws:lambda::553035198032:layer:nodejs11:6` |

| 11.6.0 | `arn:aws:lambda::553035198032:layer:nodejs11:5` |

| 10.14.2 | `arn:aws:lambda::553035198032:layer:nodejs10:3` |

| 11.4.0 | `arn:aws:lambda::553035198032:layer:nodejs11:4` |

| 10.14.1 | `arn:aws:lambda::553035198032:layer:nodejs10:1` |

| 11.3.0 | `arn:aws:lambda::553035198032:layer:nodejs11:1` |

## Things to be aware of

* This is a no-batteries-included runtime – you'll need to zip up any

  `node_modules` dependencies, including `aws-sdk` with your lambda function

* It does not monkeypatch `console.log`, `console.error`, etc

  functions to add extra timestamps and request IDs to each line you log as the

  official runtimes do. I believe this leads to fewer surprises and cleaner

  logs that are easier to parse by various tools – but if you're

  relying on this behaviour you'll need to add these fields yourself.

* Cold start overhead of ~240ms for Node.js 10.x and ~260ms for 12.x – this

  is due to Node.js' increasingly slow startup time,

  [but they're working on it!](https://github.com/nodejs/node/issues/17058)