# aws/aws-lambda-runtime-interface-emulator

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/aws-aws-lambda-runtime-interface-emulator).**

1,128 stars · 117 forks · Go · Apache-2.0

## Links

- GitHub: https://github.com/aws/aws-lambda-runtime-interface-emulator
- awesome-repositories: https://awesome-repositories.com/repository/aws-aws-lambda-runtime-interface-emulator.md

## Description

The AWS Lambda Runtime Interface Emulator is a proxy server designed to replicate the cloud-based serverless execution environment within a local container. It functions as a lightweight interface that allows developers to verify function logic, performance, and API integration by simulating the remote control plane and event invocation model on a local machine.

The tool operates by intercepting HTTP requests and translating them into the structured JSON event payloads expected by serverless function handlers. It manages the function lifecycle through a synchronous event loop and maps local configuration settings, including security credentials and metadata, directly into the container process space to ensure parity with production environments.

Beyond standard function testing, the emulator supports the validation of custom extensions and agents by providing a functional implementation of the runtime interface. This allows for the testing of containerized serverless applications and their associated components before they are deployed to the cloud.

## Tags

### Development Tools & Productivity

- [Local Lambda Simulation](https://awesome-repositories.com/f/development-tools-productivity/local-development-environments/local-lambda-simulation.md) — Provides a proxy server that mimics the cloud runtime environment to test containerized functions and extensions locally.
- [Serverless Function Development Tools](https://awesome-repositories.com/f/development-tools-productivity/development-environment-management/cloud-service-emulation-interception/cloud-infrastructure-emulation/serverless-function-development-tools.md) — Provides a utility for verifying function logic and API integration within a local container to ensure production parity.
- [Source-to-Runtime Deployers](https://awesome-repositories.com/f/development-tools-productivity/local-function-execution/cloud-function-deployers/source-to-runtime-deployers.md) — Proxies requests to a local container to simulate cloud runtime environments for verifying function logic and performance. ([source](https://github.com/aws/aws-lambda-runtime-interface-emulator#readme))
- [Local Serverless Emulation](https://awesome-repositories.com/f/development-tools-productivity/local-serverless-emulation.md) — Implements a mock server that replicates the remote control plane interface for local function registration and status reporting.

### DevOps & Infrastructure

- [Local Serverless Testing](https://awesome-repositories.com/f/devops-infrastructure/cloud-infrastructure/cloud-computing-serverless/serverless-execution-environments/serverless-function-runtimes/local-serverless-testing.md) — Simulates the cloud execution environment locally to verify function logic and performance before deployment.
- [Container Runtime Interfaces](https://awesome-repositories.com/f/devops-infrastructure/container-runtime-interfaces.md) — Acts as a lightweight web server that converts HTTP requests into JSON events to simulate cloud function execution.
- [Containerized Development Environments](https://awesome-repositories.com/f/devops-infrastructure/containerized-development-environments.md) — Packages and tests serverless functions as container images to ensure parity with production environments.
- [Execution Environment Configurations](https://awesome-repositories.com/f/devops-infrastructure/execution-environments/execution-environment-configurations.md) — Configures execution environment parameters like credentials and timeouts within a local container. ([source](https://github.com/aws/aws-lambda-runtime-interface-emulator#readme))
- [Agent Functionality Extensions](https://awesome-repositories.com/f/devops-infrastructure/release-automation/plugin-extensibility/plugin-extensible-runtimes/agent-functionality-extensions.md) — Validates custom extensions and agents by running them against a functional implementation of the runtime interface. ([source](https://github.com/aws/aws-lambda-runtime-interface-emulator/blob/develop/README.md))

### Software Engineering & Architecture

- [Extensible Integration Ecosystems](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/extensibility/extensible-integration-ecosystems.md) — Mimics the runtime interface to ensure seamless integration and operation of custom extensions with the cloud platform.

### Web Development

- [Request Translators](https://awesome-repositories.com/f/web-development/http-request-handlers/request-translators.md) — Translates incoming HTTP requests into structured JSON event payloads expected by serverless function handlers.