AWS Lambda Node Container

The minimum you need to get Node running in a container using Amazon's image.

Note: this repository is not affiliated with Amazon.

Containers currently have about 10gb space to use, whereas zip functions have about 250mb. So for many interesting use cases you will need to use a container.

This template exists because it is actually fairly hard to find pre-made lambda containers that work. Many lambda container images on GitHub don't work, including starter kits and templates. The other containers don't work because they don't use Amazon's image and so no longer implement the latest runtime interface.

Setup

Local Setup

1. docker build -t <image name> .
   • or docker build --platform linux/amd64 -t <image name> . for amd64
   • or docker build --platform linux/arm64 -t <image name> . for arm
2. docker run -p 9000:8080 <image name>
3. curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{"payload":"Hi"}'

Setup on AWS

1. Go to the AWS ECR Console (Elastic Container Registry)
   1. Go to Repositories
   2. Create a repository
   3. Click "view push commands" within the repository
   4. Run the commands the panel describes in a shell in the project folder
      • this builds the Docker container and pushes it to AWS ECR
2. Go to the AWS Lambda Console
   1. Go to Functions
   2. Create a function
      1. Choose "container image" at top
      2. Click "Browse Images"
      3. Click reload button and click "select repository"
      4. Select the repository and image
      5. Select the appropriate architecture etc
   3. Test
      1. Test with the test tab
      2. In configuration tab create a Function URL

Reference

• Amazon Typescript Container Images Developer Guide
• Docker image amazon/aws-lambda-nodejs