lambci/lambda

lambci/lambda镜像说明

镜像概述

该镜像提供了一个沙箱化的本地环境，几乎完全复制AWS Lambda的线上运行环境，包括已安装的软件库、文件结构与权限、环境变量、上下文对象及行为，甚至用户和运行进程都与线上一致。用户可通过该镜像在本地验证Lambda函数的行为，确保部署到线上后表现一致，也可用于编译原生依赖以适配Lambda环境。

核心功能

1. 环境高度还原：复制Lambda线上环境的软件版本、文件系统结构和权限设置；
2. 多运行时支持：覆盖Node.js、Python、Java、Go、.NET等主流Lambda运行时；
3. 双运行模式：支持单次执行模式（输出结果到stdout）和API服务模式（避免冷启动，快速多次调用）；
4. 构建支持：提供带开发工具的构建镜像，用于编译原生依赖或打包函数；
5. 灵活配置：通过环境变量调整运行行为（如API端口、事件输入方式等）；
6. 层支持：可挂载Lambda层代码到指定目录，模拟线上层依赖。

使用场景

• 本地开发调试：快速验证Lambda函数逻辑，无需频繁调用线上服务；
• 原生依赖编译：确保依赖库与Lambda环境的兼容性；
• CI/CD自动化测试：在持续集成流程中自动运行函数测试；
• 多环境验证：模拟不同运行时版本的函数行为。

配置说明

关键环境变量

• DOCKER_LAMBDA_STAY_OPEN=1：开启API服务模式；
• DOCKER_LAMBDA_API_PORT：修改API服务端口（默认9001）；
• DOCKER_LAMBDA_USE_STDIN=1：通过stdin输入事件数据；
• AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY：配置AWS服务访问凭证。

部署示例

单次执行模式（Node.js 12.x）

sh
docker run --rm \
  -v "$PWD":/var/task:ro,delegated \
  lambci/lambda:nodejs12.x index.handler '{"key": "value"}'

API服务模式（Go 1.x）

sh
docker run --rm -d \
  -e DOCKER_LAMBDA_STAY_OPEN=1 \
  -p 9001:9001 \
  -v "$PWD":/var/task:ro,delegated \
  lambci/lambda:go1.x my_handler
# 调用示例
curl -d '{"key": "value"}' http://localhost:9001/2015-03-31/functions/myfunction/invocations

构建原生依赖（Python 3.8）

sh
docker run --rm -v "$PWD":/var/task lambci/lambda:build-python3.8 pip install -r requirements.txt --target .

镜像标签

支持的运行时标签包括nodejs12.x、python3.8、java11、go1.x等，构建镜像标签以build-前缀开头（如build-nodejs12.x）。