amazon/aws-lambda-dotnet

AWS Lambda .NET 基础镜像

镜像概述和主要用途

AWS Lambda .NET 基础镜像是由AWS提供的容器镜像，包含在AWS Lambda上运行容器化函数所需的全部组件。该镜像旨在帮助用户将.NET函数打包为容器镜像，并部署到AWS Lambda服务中执行。

核心功能和特性

• 完整运行环境：包含Amazon Linux Base操作系统、.NET运行时、依赖项及Lambda运行时接口客户端（RIC）。
• 运行时接口支持：RIC实现Lambda 运行时API，支持运行时与Lambda服务之间的请求收发。
• 维护保障：AWS定期提供安全补丁和更新，确保镜像安全性。
• 环境一致性：镜像与AWS Lambda云执行环境高度相似，便于本地开发测试与云部署的一致性。
• 组件优化：AWS可能通过调整包含的组件或依赖项对镜像进行优化，部署到Lambda时将按原样运行。

使用场景和适用范围

适用于需要将.NET函数打包为容器镜像部署到AWS Lambda的场景，尤其适合以下需求：

• 构建自定义.NET运行时环境或依赖特定系统库的Lambda函数。
• 需在本地完整模拟Lambda执行环境进行测试的开发流程。
• 追求函数部署包与运行环境紧密集成的应用场景。

使用方法和配置说明

Dockerfile编写

基础镜像来源

可从以下仓库拉取基础镜像：

• Amazon ECR Public：public.ecr.aws/lambda/dotnet:6
• DockerHub：amazon/aws-lambda-dotnet:6

示例Dockerfile

dockerfile
FROM public.ecr.aws/lambda/dotnet:6
# 或使用 DockerHub 镜像：FROM amazon/aws-lambda-dotnet:6

# 复制函数代码到 Lambda 任务目录
COPY publish/* ${LAMBDA_TASK_ROOT}

# 设置函数处理程序（也可在镜像外部通过参数覆盖）
CMD [ "MyProject::MyFunction.Function::FunctionHandler" ]

环境变量说明

• LAMBDA_TASK_ROOT：Lambda函数代码的存放路径，对应容器内/var/task目录，需将函数代码复制到此路径。

构建镜像

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

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

本地测试

启动本地容器

运行镜像并映射端口（Lambda运行时默认监听8080端口）：

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

本地调用函数

在另一个终端中，通过cURL发送请求调用函数：

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

部署到AWS

需将镜像推送到Amazon ECR（Elastic Container Registry），具体步骤参考AWS文档：

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