Serverless Python

Description:

The Serverless Python Demo repository offers a pragmatic approach to building, deploying, and managing serverless applications in Python. Designed as a comprehensive template, it simplifies the complexities of serverless application development by integrating best practices, robust tooling, and a production-ready architecture.

This repository is ideal for developers aiming to create scalable, secure, and efficient serverless applications using AWS services, AWS Lambda Powertools, and AWS CDK, while embracing CI/CD and automation.

Features:

• Python Serverless Service:

  • A structured, production-ready serverless template.
  • Modular architecture with handler, logic, and data access layers.

• Infrastructure Management:

  • AWS CDK (Cloud Development Kit) for infrastructure as code.
  • Comprehensive infrastructure and security tests.

• CI/CD Integration:

  • GitHub Actions-based pipelines.
  • Automated deployment to dev, staging, and production environments.
  • Built-in checks: Python linters, complexity checks, and style formatters.

• Security and Authentication:

  • Cognito user pool with test user integration.
  • Authentication-protected REST API.
  • Web Application Firewall (WAF) with managed rules for production.

• Observability:

  • CloudWatch dashboards (high-level and detailed).
  • Integrated CloudWatch alarms for proactive monitoring.

• Testing Capabilities:

  • End-to-end (E2E) tests with automated JWT-based authentication.
  • Unit, integration, infrastructure, and security tests.

• AWS Lambda Best Practices:

  • Idempotent APIs.
  • Usage of AWS Lambda Powertools for logging, tracing, and metrics.
  • Async testing design for efficient validation.

• Developer Experience:

  • Makefile for streamlined workflows.
  • All-inclusive setup for quick project initiation.

Requirements:

• Programming Language: Python 3.9 or later.
• AWS Tools:
  • AWS CLI
  • AWS CDK (v2.x)
• Other Tools:
  • GitHub account and access to GitHub Actions.
  • Node.js (for CDK installation).
  • Make (for Makefile support).
  • Python virtual environment tools (e.g., venv, pipenv).

Instructions:

1. Clone the Repository:

   bash

   Copy code

   git clone https://github.com/your-username/serverless-python-demo.git cd serverless-python-demo

2. Set Up the Environment:

   bash

   Copy code

   python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -r requirements.txt

3. Install AWS CDK:

   bash

   Copy code

   npm install -g aws-cdk

4. Deploy Infrastructure: Update cdk.json with your AWS account and region, then run:

   bash

   Copy code

   cdk deploy

5. Run CI/CD Pipelines: Push changes to GitHub to trigger the predefined GitHub Actions pipelines.

6. Test the Application: Execute all tests using the Makefile:

   bash

   Copy code

   make test