Serverless

<img src="img/cdkpatterns_logo.png" width="450" />

This is intended to be a repo containing all of the official AWS Serverless architecture patterns built with AWS CDK for developers to use.

Follow @CdkPatterns for live discussion / new pattern announcements. I plan to add a new pattern weekly so check back regularly!

You can also check out our Deconstructing CDKPatterns YouTube channel for in depth walk throughs of the patterns.

Note, this is maintained by @nideveloper not AWS. For my motivation, please read this blog post

New to AWS CDK?

• To learn more visit the AWS getting started guide
• To do a workshop on CDK visit cdkworkshop.com
• Visit the Hey CDK "How To" series for some detailed answers
• Check out Awesome CDK for a curated list of awesome projects related to CDK

Pattern Usage

All patterns are available in Typescript and Python so pick your favourite language! Note the Typescript patterns all include unit tests but right now I have not seen a standard python testing approach

You can always clone this repo which contains every pattern in python/typescript but if you just want a single pattern in one language follow these steps:

1) Choose your pattern

Browse the "Grouped Alphabetically" patterns list below or run:

npx cdkp list

2) Download Pattern In Python or Typescript CDK

Something to be aware of is that the Python version may reuse the JS lambdas from the TypeScript version. This is to reduce the amount of development effort when creating these patterns. It means at launch the TypeScript and Python patterns are effectively identical when deployed but you get the choice of Python or TypeScript for the CDK implementation.

I will look to refactor the Python patterns slowly to full Python after initial launch. If you want to help with this effort, pull requests are always welcome!

<details> <summary>TypeScript</summary> <br /> All Patterns support the same commands so you can just run: <br />

npx cdkp init {pattern-name}
cd {pattern-name}
npm run test
# requires you to be using cloud9 or have ran aws configure to setup your local credentials
npm run deploy 

</details> <details> <summary>Python</summary> <br /> The CDK CLI is still installed via npm so make sure you have the latest version of node installed or the npx commands will fail. Then you can just run: <br />

npx cdkp init {pattern-name} --lang=python
cd {pattern-name}

# create a virtual env and install your dependencies
python -m venv .env
source .env/bin/activate
pip install -r requirements.txt

# test everything is working by outputting the cloudformation
npx cdk synth
# requires you to be using cloud9 or have ran aws configure to setup your local credentials
npx cdk deploy

</details>

Patterns

The Filter Pattern By Component Used Page allows you to filter patterns by a serverless component e.g. Lambda or API Gateway HTTP API visit, otherwise:

<details> <summary> Grouped Alphabetically </summary>

Polly

Use Amazon Polly to translate text to speech from inside a Lambda Function. You can also take advantage of Amazon Translate to change the language of the spoken text

<br /><hr /><br />

Single Page Application S3 Website Deploy

These are built using https://www.npmjs.com/package/cdk-spa-deploy and allow you to deploy a website in as little as 5 lines of CDK code.

• S3 Angular Deploy
• S3 React Deploy

<br /><hr /><br />

The Alexa Skill

Deploy an Alexa Skill backed by a Lambda Function and a DynamoDB Table.

<br /><hr /><br />

The Basic MQ

In this example we have private Amazon MQ brokers behind an internet-facing network load balancer endpoint using a subdomain.

<br /><hr /><br />

The Big Fan

You can integrate API Gateway directly with SNS and then add some resiliency by integrating your event consumers via sqs and message filtering.

<br /><hr /><br />

The CloudWatch Dashboard

Build and deploy a well architected CloudWatch dashboard with alerts for the simple webservice pattern

<br /><hr /><br />

The Destined Lambda

This is a stock implementation of Lambda Destinations with Amazon EventBridge

You can decouple your event driven architectures with EventBridge rules and now you can strip the custom EventBridge code from your Lambda functions with Lambda Destinations.

<br /><hr /><br />

The Dynamo Streamer

This was taken from this Tweet<br />

You can integrate API Gateway directly with DynamoDB and that way your systems can be more resilient! "Code is a liability" so less lambda functions, less liability

<br /><hr /><br />

The EFS Lambda

This was taken from this Blogpost<br />

You can now attach an EFS File System to your Lambda Function for persistence between executions or across different Functions <br /><br />

<br /><hr /><br />

The EventBridge ATM

This was taken from this Blogpost<br />

You can easily create routing rules in EventBridge to send the same event to multiple sources based on conditions. This example shows you how<br /><br />

<br /><hr /><br />

The EventBridge Circuit Breaker

Integrate with unreliable external services? Build a circuit breaker and handle the risk <br />

<br /><hr /><br />

The EventBridge ETL

Build a fully serverless CSV to DynamoDB pipeline <br />

<br /><hr /><br />

The Lambda Circuit Breaker

Deploy Gunnar Grosch's circuitbreaker-lambda inside a reference architecture

<br /><hr /><br />

The Lambda Power Tuner

Use the Lambda Power Tuner state machine to work out the optimum configuration settings for your Lambda Function

<br /><hr /><br />

The Lambda Trilogy

See the 3 states of Lambda in action (Single Purpose Function, Fat Lambda and Lambda-lith)

<br /><hr /><br />

The Media Live Stream

This is an example of how to deploy a Serverless environment to stream live event content.

<br /><hr /><br />

The Predictive Lambda

Deploy a custom Python ML model inside a Docker container running on AWS Lambda

<br /><hr /><br />

The RDS Proxy

Use RDS Proxy to protect a MySQL RDS Instance from the massively scalable Lambda Function querying it

<br /><hr /><br />

The Saga Step Function

A mechanism for handling distributed transactions within your system.

<br /><hr /><br />

The Scalable Webhook

Need to integrate a non serverless resource like RDS with a serverless one like Lambda? This is your pattern <br /><br />

<br /><hr /><br />

The Scheduled Lambda

Use EventBridge to trigger a Lambda Fuction on a schedule <br /><br />

<br /><hr /><br />

The Simple GraphQL Service

Simple graphQL service built with AppSync<br /><br />

<br /><hr /><br />

The Simple Webservice

The most basic pattern on cdkpatterns, the start of most peoples serverless journ