hello-lambda

Minimal project to get up and running on AWS lambda with Python 3.6 and pipenv.

Quickstart

The main commands are wrapped using a very simple Makefile. I believe it doesn't work on Windows but I don't have a window machine to care enough. If you feel like adding that, feel free to send me a pull request.

Install

The first time only:

• make install: Create a virtual environment and install dependencies using pipenv

Test locally

• make run: call the lambda handler using pipenv run

Build

• make build: Collect dependencies and entry point script into a deployment package By default, it'll be a deliverable.zip in the root of the project.

  The target is customisable and may be provided on the command line:

  make build OUT_FILE=outfile.zip
  

Upload and Deploy

• Go to your AWS account, in the "Lambda" section
• Click "Create a function" > "Author from scratch" > Configure triggers page: Click "Next"
• Give a name & description, choose Python 3.6 runtime
• Select "Upload a ZIP file" and choose the delivrable in the file picker
• Set the Handler to hello_lambda.lambda_handler (or more generally <script_name>.<function_name>)
• Select/create an AWS Role, click "Next"
• Review all the details and confirm creation
• Run it!

Next steps

• Add any third party package you might need using pipenv install ...
• To deploy, run the build script and re-upload the ZIP file
• Settings can be added as environment variables in AWS
• Triggers can be configured to run your function: API gateway, Alexa, Cloudwatch, SNS, ...