elthrasher/http-lambda-invoker

http-lambda-invoker

镜像概述和主要用途

http-lambda-invoker是一个轻量级（小于20m）的Docker镜像，旨在通过HTTP协议调用Lambda函数。它解决了AWS SAM框架在基于docker-compose的现有开发工作流中集成困难的问题，使开发者能够在混合无服务器和容器的本地开发环境中便捷地调用Lambda函数。

核心功能和特性

• 轻量级：镜像体积小于20m，资源占用低
• HTTP代理：自动将请求的路径、查询参数、请求体和头信息传递给Lambda函数，并将响应映射回客户端
• CORS支持：自动设置Access-Control-Allow-Origin: *，避免开发环境中的CORS错误
• 环境变量配置：通过简单的环境变量即可完成核心配置
• 与docker-compose集成：可无缝融入基于容器的开发工作流

使用场景和适用范围

适用于本地开发环境中需要将无服务器Lambda函数与基于容器的应用（如通过docker-compose管理的服务）集成的场景。特别适合在混合架构开发中，需要通过HTTP接口调用Lambda函数的开发者。

使用方法和配置说明

docker-compose配置示例

yaml
version: '3.7'

services:
  api:
    container_name: api
    image: elthrasher/http-lambda-invoker
    environment:
      - LAMBDA_ENDPOINT=http://lambda:9001  # Lambda容器的地址和端口
      - LAMBDA_NAME=MyFunctionName          # 要调用的Lambda函数名称
      - PORT=8080                           # http-lambda-invoker运行端口
    ports:
      - '8080:8080'                         # 端口映射
  lambda:
    container_name: lambda
    image: lambci/lambda:nodejs12.x         # 使用lambci镜像运行Lambda
    command: app.MyFunctionName             # 指定函数入口
    environment:
      - DOCKER_LAMBDA_STAY_OPEN=1           # 保持容器运行
    volumes:
      - ./build:/var/task:ro,delegated      # 挂载Lambda函数代码

也可参考https://github.com/elthrasher/http-lambda-invoker-example%E8%8E%B7%E5%8F%96%E6%9B%B4%E5%A4%9A%E4%BD%BF%E7%94%A8%E6%A1%88%E4%BE%8B%E3%80%82

环境变量说明

HTTP代理行为

http-lambda-invoker会将以下请求元素传递给Lambda函数，并将Lambda的响应映射回客户端：

• 请求路径
• 查询参数
• 请求体
• 请求头

CORS配置

为简化开发环境中的配置，镜像自动设置Access-Control-Allow-Origin: *，无需额外配置即可避免CORS错误。

限制

• 每个http-lambda-invoker实例仅支持调用一个Lambda函数
• 如需调用多个函数，需部署多个实例并映射不同端口

未来计划通过解析SAM/CloudFormation模板来支持多函数调用，类似于SAM CLI中的flask应用实现方式。

API Gateway与HTTP Gateway支持

目前正在完善对两种网关类型的支持，未来版本将提供更全面的兼容性。

构建和测试

自行构建镜像

bash
docker build . -t <自定义标签>

运行测试

bash
go test