amazon/aws-lambda-ruby

AWS Lambda Ruby 基础镜像

镜像概述与主要用途

AWS Lambda Ruby 基础镜像是 AWS 提供的容器镜像，包含在 AWS Lambda 上运行以容器镜像形式打包的 Ruby 函数所需的全部组件。该镜像基于 Amazon Linux 操作系统，内置 Ruby 运行时环境、依赖项以及 Lambda 运行时接口客户端（Runtime Interface Client, RIC）。RIC 实现了 Lambda https://docs.aws.amazon.com/lambda/latest/dg/runtimes-api.html%EF%BC%8C%E4%BD%BF%E8%BF%90%E8%A1%8C%E6%97%B6%E8%83%BD%E5%A4%9F%E4%B8%8E 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 官方文档：

• https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-create.html
• https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html

维护策略

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

更多信息

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