How do I deploy a CDK pattern using the cdkp CLI?

Run `npx cdkp init {pattern-name}` for TypeScript or add `--lang=python` for Python, then use `npx cdk deploy` after setting up AWS credentials. The README provides step-by-step instructions for both languages.

CDK Patterns vs AWS SAM: which is better for serverless?

CDK Patterns offers concrete, deployable examples for learning and bootstrapping with CDK, while AWS SAM is a framework for building custom serverless apps with simplified YAML. Choose CDK Patterns for ready-to-use patterns, but SAM for more flexible, from-scratch development.

Are the patterns really production-ready?

Yes, each pattern is designed as a complete stack aligned with AWS Well-Architected best practices, but you should always review and customize the code for your specific production requirements, such as security hardening and cost optimization.

How can I contribute a new pattern to CDK Patterns?

Fork the repository, follow the contributing guidelines in CONTRIBUTING.md, and submit a pull request. The project welcomes community contributions, and patterns are often credited to individual experts.

Can I use CDK Patterns with Azure or Google Cloud?

No, CDK Patterns is exclusively built for AWS serverless architectures using AWS CDK, so it's not compatible with other cloud providers. For multi-cloud projects, you'd need alternative solutions.

What are the costs of deploying these patterns?

Costs vary based on the AWS services in each pattern, like Lambda, DynamoDB, or EventBridge. Always check AWS pricing and set up billing alerts, as some patterns may incur ongoing charges for resources like RDS or MediaLive.

Open-Awesome

cdkpatterns/serverless

MITTypeScript

A collection of official AWS Serverless architecture patterns built with AWS CDK, available in TypeScript and Python.

Visit Website GitHub

2.4k stars270 forks0 contributors

What is cdkpatterns/serverless?

CDK Patterns is a curated collection of official AWS Serverless architecture patterns built with the AWS Cloud Development Kit (CDK). It provides ready-to-deploy CDK stacks for common serverless use cases like web services, event processing, data pipelines, and machine learning, helping developers implement best practices quickly.

Target Audience

AWS developers and architects building serverless applications who want to accelerate development using proven, production-ready patterns with Infrastructure as Code.

Value Proposition

It offers a library of concrete, deployable CDK implementations for standard serverless architectures, saving time and ensuring alignment with AWS Well-Architected best practices, all available in both TypeScript and Python.

Overview

This is intended to be a repo containing all of the official AWS Serverless architecture patterns built with CDK for developers to use. All patterns come in Typescript and Python with the exported CloudFormation also included.

Use Cases

Best For

Learning AWS serverless architecture best practices through deployable examples
Bootstrapping new serverless projects with production-ready CDK stacks
Implementing event-driven architectures with AWS Lambda, EventBridge, and Step Functions
Building serverless data processing pipelines (ETL) from CSV to DynamoDB
Deploying serverless machine learning models in containers on AWS Lambda
Creating well-architected CloudWatch dashboards and alerts for serverless applications

Not Ideal For

Teams building multi-cloud or hybrid architectures requiring portability beyond AWS
Developers seeking low-code or no-code infrastructure solutions without CDK coding
Projects needing extensive, out-of-the-box customization beyond the fixed pattern templates
Organizations requiring official AWS support and SLAs, as it's community-maintained by an individual

Pros & Cons

Pros

Production-Ready Implementations

Each pattern is a complete, deployable CDK stack for common serverless architectures, saving development time by providing tested, working code from the start.

Multi-Language CDK Support

All patterns are available in both TypeScript and Python CDK implementations, allowing teams to choose their preferred Infrastructure as Code language.

Well-Architected Alignment

Patterns are mapped to AWS Well-Architected Framework best practices, ensuring built-in reliability, security, and efficiency without extra design effort.

Community-Driven Expertise

Contributed and maintained by AWS experts and the serverless community, offering diverse, real-world solutions that evolve with industry trends.

Easy Deployment CLI

The `cdkp` CLI enables quick initialization and deployment of any pattern with single commands, streamlining setup and reducing boilerplate code.

Cons

Incomplete Python Support

Python patterns often reuse JavaScript lambdas from TypeScript versions, limiting native Python development and testing, as admitted in the README with plans for future refactoring.

Individual Maintenance Risk

Maintained by a single individual (@nideveloper) rather than AWS or a larger organization, which could lead to slower updates, limited support, and potential abandonment.

AWS and CDK Lock-In

Tightly coupled to AWS services and the CDK framework, making it unsuitable for projects targeting other clouds or using different Infrastructure as Code tools like Terraform.

Setup Complexity

Requires Node.js, npm, AWS CLI configuration, and virtual environments for Python, adding overhead compared to simpler deployment methods or managed services.

Frequently Asked Questions

Related Projects

localstack

💻 A fully functional local AWS cloud stack. Develop and test your cloud & Serverless apps offline

Stars65,152

Forks4,771

Last commit4 months ago

chaosmonkey

Chaos Monkey is a resiliency tool that helps applications tolerate random instance failures.

Stars17,038

Forks1,289

Last commit1 year ago

zuul

Zuul is a gateway service that provides dynamic routing, monitoring, resiliency, security, and more.

Stars14,050

Forks2,442

Last commit18 hours ago

eureka

AWS Service registry for resilient mid-tier load balancing and failover.

Stars12,724

Forks3,768