amazon/aws-lambda-ruby

AWS Lambda Ruby 基础镜像

镜像概述与主要用途

AWS Lambda Ruby 基础镜像是 AWS 提供的容器镜像，包含在 AWS Lambda 上运行以容器镜像形式打包的 Ruby 函数所需的全部组件。该镜像基于 Amazon Linux 操作系统，内置 Ruby 运行时环境、依赖项以及 Lambda 运行时接口客户端（Runtime Interface Client, RIC）。RIC 实现了 Lambda 运行时 API，使运行时能够与 Lambda 服务进行请求收发交互。

核心功能与特性

• 完整运行时环境：包含 Ruby 特定版本运行时、Amazon Linux 基础系统及必要依赖项，满足 Lambda 函数执行要求。
• 运行时接口客户端：集成 RIC，实现 Lambda 运行时 API，确保函数与 Lambda 服务的通信。
• 本地测试支持：可通过 Docker 命令本地构建和运行镜像，模拟 Lambda 环境进行函数调试。
• 标准化路径：使用环境变量 LAMBDA_TASK_ROOT（默认 /var/task）作为函数代码和依赖的存放路径，简化配置。
• 定期安全更新：AWS 会定期提供安全补丁及更新，同时可能优化镜像组件或依赖以提升性能。

使用场景与适用范围

• Ruby Lambda 函数容器化部署：适用于将 Ruby 编写的 Lambda 函数打包为容器镜像，部署至 AWS Lambda。
• 自定义依赖管理：需安装特定 RubyGems 或系统依赖的场景，可通过 Dockerfile 定制环境。
• 本地开发与测试：需要在本地模拟 Lambda 运行环境，验证函数逻辑和依赖兼容性。

使用方法与配置说明

Dockerfile 配置示例

以下是使用 Ruby 2.7 基础镜像的 Dockerfile 示例，包含代码复制、依赖安装及处理器配置：

dockerfile
FROM public.ecr.aws/lambda/ruby:2.7

# 复制函数代码至 Lambda 任务根目录
COPY app.rb ${LAMBDA_TASK_ROOT}

# 复制依赖管理文件（如 Gemfile）
COPY Gemfile ${LAMBDA_TASK_ROOT}

# 配置依赖安装路径并安装依赖
ENV GEM_HOME=${LAMBDA_TASK_ROOT}  # 将 gems 安装至任务根目录，避免权限问题
RUN bundle install

# 设置函数处理器（也可通过外部参数覆盖）
CMD [ "app.LambdaFunction::Handler.process" ]

关键配置说明：

• LAMBDA_TASK_ROOT：Lambda 环境变量，指向函数代码和依赖的存放路径（默认 /var/task）。
• COPY 指令：将函数代码（如 app.rb）和依赖管理文件（如 Gemfile）复制到 LAMBDA_TASK_ROOT。
• ENV GEM_HOME：指定 RubyGems 安装路径为 LAMBDA_TASK_ROOT，确保依赖被 Lambda 运行时识别。
• CMD：定义函数入口点，格式为 [ "<handler>" ]，需替换为实际处理器路径（如 app.LambdaFunction::Handler.process）。

构建镜像

使用 docker build 命令构建镜像：

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

示例：docker build -t ruby-lambda-function .

本地运行镜像

构建完成后，通过以下命令本地运行镜像，映射容器端口 8080 至本地 9000 端口：

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

示例：docker run -p 9000:8080 ruby-lambda-function

本地调用测试

在另一个终端中，使用 curl 发送 POST 请求调用函数：

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

请求路径 /2015-03-31/functions/function/invocations 符合 Lambda 运行时 API 规范，请求体 {"payload":"hello world!"} 为函数输入。

部署参考

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

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

维护策略

• 安全更新：AWS 定期为基础镜像提供安全补丁及更新，确保运行环境安全性。
• 环境一致性：镜像设计与云端 Lambda 执行环境保持高度一致，降低部署差异风险。
• 优化调整：AWS 可能调整镜像组件或依赖项以优化性能，部署至 Lambda 时镜像将按原样运行。

更多信息

镜像组成细节可参考 GitHub 仓库：https://github.com/aws/aws-lambda-base-images