Cookiecutter SAM for MongoDB Atlas with Python Lambda functions

⚠️ THIS is ALPHA SOFTWARE in active DEVELOPMENT use at own risk and not in production, yet. ⚠️

This is a Cookiecutter template to create a Serverless App based on Serverless Application Model (SAM) and Python 3.8 which uses MongoDB Atlas.

It is important to note that you should not try to git clone this project but use SAM CLI instead as {{cookiecutter.project_slug}} will be rendered based on your input and therefore all variables and files will be rendered properly.

tldr

curl https://raw.githubusercontent.com/mongodb-developer/get-started-aws-cfn/main/get-setup.sh | bash -s us-east-2
sam init --location gh:mongodb/cookiecutter-mongodb-atlas-aws-sam-python
# cd to your project

sam build --use-container
sam deploy --extra-parameters $(./export-mongocli-parameters.sh)
# sam deploy --guided     # Have you apikey ready

Pre-requisite

The project will deploy the MongoDB Atlas AWS Quick Start which provisions complete MongoDB Atlas deployments through CloudFormation using official MongoDB Atlas AWS CloudFormation Resource Types.

Until these resources a more easily available you can use the get-started-aws-cfn project to bootstrap each AWS region with the Atlas CFN Resource Types:

curl https://raw.githubusercontent.com/mongodb-developer/get-started-aws-cfn/main/get-setup.sh | bash -s us-west-2

The above command will deploy and seutp the MongoDB Atlas CFN resources into the us-west-2 region. For advanced use, including sample AWS IAM policy suitable for aws sts assume-role, see: the aws-iam-permissions note in the Get-Started project.

Usage

Generate a new SAM based Serverless App: sam init --location gh:mongodb/cookiecutter-mongodb-atlas-aws-sam-python

You'll be prompted a few questions to help this cookiecutter template to scaffold this project and after its completed you should see a new folder at your current path with the name of the project you gave as input.

• Create an organizational-level MongoDB Atlas Programmatic API. The key needs Project Creator permissions.

• The aws and sam cli's setup and configured on your development machine.

• We also recommend mongocli for the easiest way to manage all your MongoDB Atlas needs, cluster and apikeys included!

You can then deploy your SAM app directly using your mongocli configuration - this will create the sam app, stack-name, and Atlas Project all with <APP_NAME>:

OVERRIDES=$(curl https://raw.githubusercontent.com/monogdb-developer/get-started-aws-cfn/main/export-mongocli-config.py | bash -s --  default parameter-override <APP_NAME>)
sam deploy --guided --parameter-overrides ${OVERRIDES} --stack-name <APP_NAME>

Options

Option	Description
include_safe_deployment	Sends by default 10% of traffic for every 1 minute to a newly deployed function using CodeDeploy + SAM integration - Linear10PercentEvery1Minute

Deployment Parameters

To deploy your serverless app you will need to supply the following:

Parameter	Required	Description	Default
PublicKey	Y	Your MongoDB Cloud Public API Key
PrivateKey	Y	Your MongoDB Cloud Private API Key
OrgId	Y	Your MongoDB Cloud Organization Id
ProjectName	N	The name of the project."	get-started-aws-lambda-python
ClusterName	N	Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed.	Cluster-1
ClusterInstanceSize	N	Atlas Cluster Tier	M10
ClusterRegion	N	The AWS Region where the Atlas DB Cluster will run. (AWS Region format)	us-east-1
ClusterMongoDBMajorVersion	N The version of MongoDB	latest

Credits

• This project was copied and started from coookiecutter-aws-sam-python project.

• This project has been generated with Cookiecutter

• Bruno Alla's Lambda function template

License

This project is licensed under the terms of the MIT License with no attribution