amazon/aws-lambda-provided

AWS Lambda 自定义运行时基础镜像

镜像概述和主要用途

AWS Lambda 自定义运行时基础镜像是由 AWS 提供的官方容器镜像，用于将函数打包为容器镜像并在 AWS Lambda 上运行。这些镜像包含运行 Lambda 函数所需的全部核心组件，旨在简化自定义运行时场景下的函数开发、测试与部署流程。

核心功能和特性

• 完整运行时环境：集成 Amazon Linux Base 操作系统、指定语言运行时、依赖项及 Lambda Runtime Interface Client (RIC)
• Runtime API 支持：RIC 实现 Lambda Runtime API，支持运行时与 Lambda 服务的请求收发
• 环境一致性：镜像配置与 AWS Lambda 云执行环境高度一致，确保本地开发与云端运行行为一致
• 定期安全更新：AWS 定期提供安全补丁和组件更新，保障运行环境安全性
• 灵活定制能力：支持通过 Dockerfile 自定义运行时依赖、函数代码及启动配置

使用场景和适用范围

• 自定义运行时开发：需使用 Lambda 官方未提供的编程语言或特定版本运行时的场景
• 本地开发与测试：在本地环境构建、调试容器化 Lambda 函数，验证功能正确性
• 容器化部署：通过容器镜像打包 Lambda 函数，简化复杂依赖管理
• 迁移与扩展：将现有容器化应用迁移至 Lambda，或扩展 Lambda 函数的运行时能力

使用方法和配置说明

前提条件

• 安装 Docker Engine（20.10.x 或更高版本）
• 熟悉 Dockerfile 语法及容器基本操作

Dockerfile 编写

基础镜像格式为 public.ecr.aws/lambda/provided:al2（基于 Amazon Linux 2），典型 Dockerfile 结构如下：

dockerfile
FROM public.ecr.aws/lambda/provided:al2

# 复制自定义运行时引导程序至运行时目录
COPY bootstrap ${LAMBDA_RUNTIME_DIR}
# 复制函数代码至任务目录
COPY function.sh ${LAMBDA_TASK_ROOT}

# 设置函数处理程序（可通过运行时参数覆盖）
CMD [ "function.handler" ]

构建镜像

使用以下命令构建容器镜像：

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

本地运行与测试

启动容器

运行容器并映射端口 9000（Lambda Runtime API 本地默认端口）：

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

本地调用函数

在另一个终端通过 HTTP POST 请求调用函数：

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

环境变量说明

部署至 AWS ECR

构建完成的镜像需推送至 Amazon ECR（Elastic Container Registry）后方可部署到 Lambda。具体步骤参考 AWS 官方文档：

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

维护与更新策略

• 组件优化：AWS 可能调整镜像中的组件或依赖项以优化性能，部署时镜像将原样运行
• 更新建议：建议定期更新基础镜像版本，以获取最新安全补丁和系统更新
• 兼容性保障：镜像设计确保与 Lambda 云执行环境的兼容性，减少部署差异导致的问题

相关资源

• 镜像组成详情：https://github.com/aws/aws-lambda-base-images
• Lambda 容器镜像文档：AWS Lambda 容器镜像支持