awslabs/aws-sam-local
Aws Sam Local
aws-sam-local is a Docker-based emulator used for running and debugging AWS Lambda functions and API Gateway configurations on a local machine. It provides a local execution environment that mimics the AWS Lambda runtime, allowing for the verification of function code and serverless application mocks before cloud deployment.
The project utilizes a runtime orchestrator to manage ephemeral containers, replicating the isolated execution environment of cloud functions. It includes a serverless API gateway simulator and event mocking tools to synthesize payloads from sources such as Kafka and other cloud triggers.
The tool supports the broader development cycle for the Serverless Application Model by enabling local prototyping of serverless APIs and simulation of various cloud event sources. It provides a debugging environment for identifying errors in serverless functions with full control over the execution state.
Features
- Local Lambda Simulation - Simulates AWS Lambda runtimes locally to verify function behavior and event handling before cloud deployment.
- Local Emulation Environments - Provides a local emulation environment that uses containers to simulate AWS cloud service behavior for development.
- AWS Local Development Environments - Provides a local simulation environment specifically tailored for developing and testing AWS Serverless Application Model configurations.
- Serverless Function Development Tools - Offers a local execution setup for identifying and fixing serverless errors with full control over function state.
- Serverless Worker Debugging - Enables detailed debugging of serverless functions with full control over execution state and breakpoints.
- Web API Prototyping - Provides a local environment for prototyping and iterating on API Gateway request and response logic.
- API Gateway Simulators - Acts as a local proxy that mimics API Gateway behavior to test serverless endpoints.
- Serverless Deployment Tooling - Includes utilities for defining and localizing the deployment of serverless applications using the SAM model.
- Ephemeral Docker Runtimes - Manages ephemeral Docker runtimes to create isolated environments for executing and testing cloud functions.
- Docker Container Lifecycle Automation - Automates the lifecycle of ephemeral Docker containers to ensure each function request starts in a clean state.
- Container Runtimes - Uses isolated container runtimes to mimic specific cloud execution environments on a local machine.
- Runtime Emulators - Mimics the AWS Lambda runtime locally for running and verifying function code.
- Event Source Integrations - Integrates local functions with diverse event sources such as Kafka, Kinesis, and API Gateway.
- Cloud Event Simulators - Synthesizes mock event payloads from Kafka and other cloud triggers to validate function behavior.
- Local Serverless Testing - Simulates AWS cloud services locally to accelerate the development cycle for serverless architectures.
- Ephemeral Container Orchestrators - Manages ephemeral Docker containers to replicate the isolated execution environment of cloud functions.
- Event Handler Interfaces - Routes diverse inbound request types through a unified entry point to standardize event processing.
- Mock Event Triggering - Simulates cloud event triggers by firing mock payloads into local function handlers.
- Event Mocking for Testing - Synthesizes mock event data to simulate cloud triggers and gateways for local function testing.
- Application Frameworks - CLI tool for managing applications using the Serverless Application Model.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
