amazon/aws-lambda-go

AWS Lambda Go语言基础镜像文档

概述

AWS提供的Lambda基础镜像包含在AWS Lambda上运行容器镜像打包的函数所需的所有组件。这些基础镜像包含Amazon Linux基础操作系统、Go语言运行时环境、依赖项以及Lambda Runtime Interface Client (RIC)，后者实现了Lambda Runtime API。Lambda Runtime Interface Client允许运行时从Lambda服务接收请求并向其发送响应。

要了解基础镜像的更多组成信息，请访问https://github.com/aws/aws-lambda-base-images%E3%80%82

核心功能与特性

• 完整运行环境：内置Amazon Linux基础操作系统，提供与AWS Lambda云执行环境高度相似的运行环境
• Go语言支持：包含Go语言1.x版本运行时，满足Go函数执行需求
• Runtime Interface Client：集成Lambda Runtime Interface Client，实现与Lambda服务的通信协议
• 容器化兼容：支持将Go函数打包为容器镜像，便于本地开发、测试和部署到AWS Lambda

维护政策

• AWS会定期为基础镜像提供安全补丁和更新
• 镜像设计与AWS Lambda云执行环境保持一致，简化函数容器化打包流程
• AWS可能会优化容器镜像，调整包含的组件或依赖项
• 部署到AWS Lambda时，镜像将按原样运行，确保执行一致性

使用方法

基础使用流程

1. 在Dockerfile中引用该基础镜像
2. 将函数代码复制到镜像的/var/task目录（对应环境变量LAMBDA_TASK_ROOT）
3. 配置函数处理程序（通过Dockerfile的CMD指令或外部参数）

示例Dockerfile

dockerfile
FROM public.ecr.aws/lambda/go:1.x

# 复制函数代码到任务根目录
COPY app ${LAMBDA_TASK_ROOT}

# 设置CMD为处理程序（也可在Dockerfile外部通过参数覆盖）
CMD [ "app" ]

本地构建与测试

构建镜像

bash
docker build -t <镜像名称> .

本地运行镜像

bash
docker run -p 9000:8080 <镜像名称>

本地调用函数

在另一个终端中，使用cURL调用运行中的函数：

bash
curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{"payload":"hello world!"}'

部署到AWS Lambda

要将构建好的镜像部署到AWS Lambda，需先将镜像推送到Amazon ECR仓库。详细步骤请参考AWS官方文档：

• 创建ECR仓库
• 推送镜像到ECR