pygeoapi/aws-lambda

Using pygeoapi on AWS Lambda Serverless

Overview

AWS Lambda Serverless is a service from Amazon that enables publishing code which is executed as on demand functions. The value is here is that the server is only working when requests are made, resulting in more efficient use of server resources as well as managing costs.

pygeoapi provides a couple of ways to publish to AWS Lambda depending on your environment: zappa and node/serverless.

zappa

zappa provides Python tooling to interact with AWS lambda. Ensure the environment variables AWS_ACCESS_KEY and AWS_SECRET_ACCESS_KEY are set and available.

# install zappa
pip install zappa

# set environment variables
export AWS_ACCESS_KEY_ID=foo
export AWS_SECRET_ACCESS_KEY=bar

# deploy pygeoapi to AWS Lambda
zappa deploy -s zappa_settings.json

# update
zappa update -s zappa_settings.json

# undeploy
zappa undeploy -s zappa_settings.json

node/serverless

The included serverless.yml and pygeoapi-serverless-config.yml can be used to deploy pygeoapi on AWS Lambda Serverless Environment.

This requires Amazon Credentials and the Serverless deployment tool.

AWS Credentials can be created following the instructions at https://serverless.com/framework/docs/providers/aws/guide/credentials/

To install the Serverless environment

npm install serverless

The following serverless plugins are also used

serverless plugin install -n serverless-python-requirements
serverless plugin install -n serverless-wsgi

To deploy to AWS Lambda:

serverless deploy

Once deployed, if you only need to update the code and not anything in the serverless configuration, you can update the function using:

serverless deploy --function app

When deployed, the output will show the URL the app has been deployed to.