A sample product API built with API Gateway, Lambda (Java), and DynamoDB, designed for collaborative debugging workflows using LocalStack Cloud Pods. Follow the end-to-end walkthrough for this project: https://docs.localstack.cloud/aws/tutorials/cloud-pods-collaborative-debugging/

Prerequisites

• A valid LocalStack for AWS license, which provides a LOCALSTACK_AUTH_TOKEN required to run this sample.
• Docker for running LocalStack.
• Maven and Java 21 for building the Lambda functions.
• Terraform or OpenTofu with tflocal.

export LOCALSTACK_AUTH_TOKEN=<your-auth-token>

Sample Variants

• Terraform sample
• OpenTofu sample

Quick Start

1. Start LocalStack:

docker compose up -d

2. Build Lambda artifacts:

cd lambda-functions
mvn clean package

3. Deploy infrastructure:

cd terraform
./run-tflocal.sh

4. Invoke the API:

./invoke.sh

For OpenTofu, set TF_CMD=tofu and run tflocal in opentofu/ (see opentofu/instructions.md).

License

Licensed under Apache License 2.0. See LICENSE.