Python-lambda is a toolset for developing and deploying serverless Python code in AWS Lambda.
A call for contributors
With python-lambda and pytube both continuing to gain momentum, I'm calling for contributors to help build out new features, review pull requests, fix bugs, and maintain overall code quality. If you're interested, please email me at nficano[at]gmail.com.
Description
AWS Lambda is a service that allows you to write Python, Java, or Node.js code that gets executed in response to events like http requests or files uploaded to S3.
Working with Lambda is relatively easy, but the process of bundling and deploying your code is not as simple as it could be.
The Python-Lambda library takes away the guess work of developing your Python-Lambda services by providing you a toolset to streamline the annoying parts.
Requirements
- Python 2.7, >= 3.6 (At the time of writing this, these are the Python runtimes supported by AWS Lambda).
- Pip (~8.1.1)
- Virtualenv (~15.0.0)
- Virtualenvwrapper (~4.7.1)
Getting Started
First, you must create an IAM Role on your AWS account called
lambda_basic_execution with the LambdaBasicExecution policy attached.
On your computer, create a new virtualenv and project folder.
(pylambda) $ mkdir pylambda
Next, download Python-Lambda using pip via pypi.
From your pylambda directory, run the following to bootstrap your project.
This will create the following files: event.json, __init__.py,
service.py, and config.yaml.
Let's begin by opening config.yaml in the text editor of your choice. For
the purpose of this tutorial, the only required information is
aws_access_key_id and aws_secret_access_key. You can find these by
logging into the AWS management console.
Next let's open service.py, in here you'll find the following function:
# Your code goes here!
e = event.get('e')
pi = event.get('pi')
return e + pi
This is the handler function; this is the function AWS Lambda will invoke in
response to an event. You will notice that in the sample code e and pi
are values in a dict. AWS Lambda uses the event parameter to pass in
event data to the handler.
So if, for example, your function is responding to an http request, event
will be the POST JSON data and if your function returns something, the
contents will be in your http response payload.
Next let's open the event.json file:
"pi": 3.14,
"e": 2.718
}
Here you'll find the values of e and pi that are being referenced in
the sample code.
If you now try and run:
You will get:
# execution time: 0.00000310s
# function execution timeout: 15s
As you probably put together, the lambda invoke command grabs the values
stored in the event.json file and passes them to your function.
The event.json file should help you develop your Lambda service locally.
You can specify an alternate event.json file by passing the
--event-file= argument to lambda invoke.
When you're ready to deploy your code to Lambda simply run:
The deploy script will evaluate your virtualenv and identify your project dependencies. It will package these up along with your handler function to a zip file that it then uploads to AWS Lambda.
You can now log into the AWS Lambda management console to verify the code deployed successfully.
Wiring to an API endpoint
If you're looking to develop a simple microservice you can easily wire your function up to an http endpoint.
Begin by navigating to your AWS Lambda management console and clicking on your function. Click the API Endpoints tab and click "Add API endpoint".
Under API endpoint type select "API Gateway".
Next change Method to POST and Security to "Open" and click submit (NOTE:
you should secure this for use in production, open security is used for demo
purposes).
At last you need to change the return value of the function to comply with the standard defined for the API Gateway endpoint, the function should now look like this:
def handler(event, context):
# Your code goes here!
e = event.get('e')
pi = event.get('pi')
return {
"statusCode": 200,
"headers": { "Content-Type": "application/json"},
"body": e + pi
}