This is a boilerplate repo to get started with Zappa. You can use it to build a docker image that can be used to create containers for deploying serverless python apps (built with frameworks like Flask, Django, etc) to AWS. It was made with these instructions and includes a few fixes for issues that I experienced with the setup.

This was run on Docker 18.06.1 on a Mac.

I'm using python:3.6-alpine as a base image to keep things lightweight. The resulting image will be under 500MB.

Add a config file and credentials file to the aws folder. You can refer to the sample config and the sample credentials.

You can generate your own credentials after setting up an AWS account, going into your AWS console and following these instructions.

Modify the zappa_settings.json file to include your region (matching the one from aws/config) and your profile (matching the one provided in aws/credentials). The current file uses us-west-1 (California) and default as specified in the sample config.

You can build the image simply with ./build-docker.sh

# Run a container from the image
./run-docker.sh
# Activate the pre-made python virtual environment (it has everything you need installed)
source serverlessbot/bin/activate
# Deploy your dev instance
zappa deploy dev

The end of the deployment will say Deployment complete! followed by a URL. You can navigate to the URL and verify that it says "Hello World!"

Once you are done running your test, you should undeploy to clean up.

You can undeploy, while in the virtual environment, with zappa undeploy and hit y when prompted.

I've also found that the S3 buckets stick around so you may want to delete the bucket that you created. You can find this bucket in your AWS console and it will correspond to the s3_bucket setting in zappa_settings.json.

# Get out of the python virtual environment
deactivate
# Exit the container
exit

If you encounter output like the following:

Traceback (most recent call last):
  File "/usr/local/lib/python3.6/site-packages/zappa/core.py", line 911, in upload_to_s3
    self.s3_client.head_bucket(Bucket=bucket_name)
  File "/usr/local/lib/python3.6/site-packages/botocore/client.py", line 320, in _api_call
    return self._make_api_call(operation_name, kwargs)
  File "/usr/local/lib/python3.6/site-packages/botocore/client.py", line 623, in _make_api_call
    raise error_class(parsed_response, operation_name)
botocore.exceptions.ClientError: An error occurred (404) when calling the HeadBucket operation: Not Found

Double check your credentials! It's likely the aws/credential credentials file that you created is not setup right. For instance, having a different region in zappa_settings.json from your aws/config.

If an error looks cryptic from the command line or from following the steps above, try using zappa tail from the python virtual environment or looking at AWS CloudWatch Logs.