AWS Lambda¶

AWS Lambda - serverless computation service in AWS.

Here we have an example how to deploy “hello-world” AWS Lambda with a simple Burr application. This example is based on the official instruction: https://docs.aws.amazon.com/lambda/latest/dg/python-image.html#python-image-instructions

Burr can be deployed within a Lambda function. This is a good option if you want to run your application in response to events, or if you want to run your application in a serverless environment.

See the repository on GitHub for the full code example and for step-by-step instructions on how to deploy a Burr application to AWS Lambda.

Prerequisites¶

AWS CLI Setup: Make sure the AWS CLI is set up on your machine. If you haven’t done this yet, no worries! You can follow the Quick Start guide for easy setup instructions.

Step-by-Step Guide¶

1. Build Docker image:¶

Build Docker image for deploy in AWS ECR

docker build --platform linux/amd64 -t aws-lambda-burr .

Local tests:

Run Docker container:

docker run -p 9000:8080 aws-lambda-burr

Send test request to check if Docker container executes it correctly:

curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{"body": {"number":3}}'

2. Create AWS ECR repository:¶

Ensure the AWS account number (111122223333) is correctly replaced with yours:

Authenticate Docker to Amazon ECR:

Retrieve an authentication token to authenticate your Docker client to your Amazon Elastic Container Registry (ECR):

aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-east-1.amazonaws.com

Create the ECR Repository:

aws ecr create-repository --repository-name aws-lambda-burr \
    --region us-east-1 \
    --image-scanning-configuration scanOnPush=true \
    --image-tag-mutability MUTABLE

3. Deploy the Image to AWS ECR¶

Ensure the AWS account number (111122223333) is correctly replaced with yours:

docker tag aws-lambda-burr 111122223333.dkr.ecr.us-east-1.amazonaws.com/aws-lambda-burr:latest
docker push 111122223333.dkr.ecr.us-east-1.amazonaws.com/aws-lambda-burr:latest

4. Create a simple AWS Lambda role:¶

Example of creating an AWS Role for Lambda execution:

aws iam create-role \
    --role-name lambda-ex \
    --assume-role-policy-document '{"Version": "2012-10-17","Statement": [{ "Effect": "Allow", "Principal": {"Service": "lambda.amazonaws.com"}, "Action": "sts:AssumeRole"}]}'

5. Create AWS Lambda¶

Ensure the AWS account number (111122223333) is correctly replaced with yours:

aws lambda create-function \
    --function-name aws-lambda-burr \
    --package-type Image \
    --code ImageUri=111122223333.dkr.ecr.us-east-1.amazonaws.com/aws-lambda-burr:latest \
    --role arn:aws:iam::111122223333:role/lambda-ex

6. Test AWS Lambda¶

aws lambda invoke \
    --function-name aws-lambda-burr \
    --cli-binary-format raw-in-base64-out \
    --payload '{"body": {"number": 5}}' \
    response.json