atorrescogollo / aws-local-serverless-proxy

HTTP API gateway for local AWS lambdas

AWS Local Serverless Proxy

HTTP API gateway for locally testing AWS lambdas

Setup

• Download from releases assets:

curl -Lo aws-local-serverless-proxy \
    "https://github.com/atorrescogollo/aws-local-serverless-proxy/releases/download/<VERSION>/aws-local-serverless-proxy_<OS>_<ARCH>"
chmod +x aws-local-serverless-proxy

AWS_LAMBDA_RUNTIME_API=localhost:9000 ./aws-local-serverless-proxy

• With docker:

docker pull ghrc.io/atorrescogollo/aws-local-serverless-proxy:<VERSION>

docker run \
    -p 8080:8080 \
    -e AWS_LAMBDA_RUNTIME_API=lambda:8080 \
    ghrc.io/atorrescogollo/aws-local-serverless-proxy:<VERSION>

• With docker-compose:

version: '3.7'

services:
  proxy:
    image: ghrc.io/atorrescogollo/aws-local-serverless-proxy:<VERSION>
    ports:
      - 8080:8080
    environment:
      - AWS_LAMBDA_RUNTIME_API=lambda:8080
    depends_on:
      - lambda
    tty: true

  lambda: # The lambda service you want to test
    build:
      context: .
      target: lambda
    ports:
      - 9000:8080
    tty: true

docker-compose up -d

Usage

Now you can reach your lambda as if it was deployed in AWS with an API Gateway:

curl localhost:8080/ping