Flask API with DynamoDB backend. Deployment to AWS Lambda with Serverless Framework

This project demonstrates how a simple Flask API backed by DynamoDB can be deployed to AWS Lambda using the Serverless Framework.

🚀 Setup

1. Create and Load Environment Variables

• Copy the example environment file:

  cp env.example .env

• Edit .env and add your environment variables.
• Load the variables into your shell:

  source .env

2. Build and Run the Docker Container

• Build the Docker image:

  docker compose build

• Start the container:

  docker compose up -d

• The API will be available at:

  http://127.0.0.1:${PORT}/home
  

3. Access the Running Container

To enter the container shell:

docker compose exec app bash

4. Deploy to AWS Lambda

To deploy the API using Serverless Framework, run:

serverless deploy

---

🛠 Technologies Used

• Flask – Web framework for Python
• DynamoDB - Amazon NoSQL database service
• Docker – Containerization for local development
• Serverless Framework – Deployment automation for AWS Lambda
• AWS Lambda – Serverless compute service

📄 License

This project is licensed under the MIT License.

---

📌 Notes

• If you need to update environment variables, update .env and restart the container with:

  docker compose up -d --build

• For debugging deployment issues, check logs with:

  serverless logs -f function_name