使用 Ruby 构建 Lambda 函数 - AWS Lambda

使用 Ruby 构建 Lambda 函数

您可以在 AWS Lambda 中运行 Ruby 代码。Lambda 可为 Ruby 提供运行时,用于运行代码来处理事件。您的代码在包含 AWS SDK for Ruby 的环境中运行,其中包含来自您管理的 AWS Identity and Access Management (IAM) 角色的凭证。

Lambda 支持以下 Ruby 运行时:

Ruby 运行时
名称 标识符 SDK for Ruby 操作系统 架构

Ruby 2.7

ruby2.7

3.0.1

Amazon Linux 2

x86_64,arm64

注意

有关 Ruby 2.5 的支持终止信息,请参阅 运行时弃用策略

Lambda 函数使用执行角色获得将日志写入 Amazon CloudWatch Logs 以及访问其他服务和资源的权限。如果您还没有函数开发的执行角色,请创建一个。

创建执行角色

  1. 在 IAM 控制台中,打开 Roles(角色)页面

  2. 选择 Create role(创建角色)。

  3. 创建具有以下属性的角色。

    • Trusted entity(可信任的实体)– Lambda

    • Permissions(权限)– AWSLambdaBasicExecutionRole

    • Role name(角色名称)– lambda-role

    AWSLambdaBasicExecutionRole 策略具有函数将日志写入 CloudWatch Logs 所需的权限。

您可以稍后向此角色添加权限,或将其与特定于单一函数的其他角色交换。

创建 Ruby 函数

  1. 打开 Lambda 控制台

  2. 选择 Create function(创建函数)。

  3. 配置以下设置:

    • 名称my-function.

    • Runtime(运行时)Ruby 2.7

    • Role(角色)– Choose an existing role(选择现有角色)。

    • Existing role(现有角色)– lambda-role

  4. 选择 Create function(创建函数)。

  5. 要配置测试事件,请选择测试

  6. 对于事件名称,输入 test

  7. 选择 Save changes(保存更改)。

  8. 要调用该函数,请选择 Test(测试)。

控制台将使用名为 lambda_function.rb 的源文件创建一个 Lambda 函数。您可以在内置代码编辑器中编辑此文件并添加更多文件。要保存您的更改,请选择 Save(保存)。然后,要运行代码,请选择 Test(测试)。

注意

Lambda 控制台使用 AWS Cloud9 在浏览器中提供集成开发环境。您还可以使用 AWS Cloud9 在您自己的环境中开发 Lambda 函数。有关更多信息,请参阅 AWS Cloud9 用户指南中的使用 Lambda 函数

lambda_function.rb 文件会导出一个名为 lambda_handler 的函数,此函数将接受事件对象和上下文对象。这是 Lambda 在调用函数时调用的处理函数。Ruby 函数运行时从 Lambda 获取调用事件并将其传递到处理程序。在函数配置中,处理程序值为 lambda_function.lambda_handler

保存函数代码时,Lambda 控制台会创建一个 .zip 文件归档部署包。在控制台外部开发函数代码时(使用 SDE),您需要创建部署程序包将代码上载到 Lambda 函数。

注意

要在本地环境中开始应用程序开发,请部署本指南的 GitHub 存储库中提供的其中一个示例应用程序。

Ruby 中的示例 Lambda 应用程序

  • blank-ruby – 一个 Ruby 函数,显示日志记录、环境变量、AWS X-Ray 跟踪、层、单元测试和AWS开发工具包的使用情况。

  • 适用于 AWS Lambda 的 Ruby 代码示例 – 在 Ruby 中编写的代码示例,演示了如何与 AWS Lambda 互动。

除了调用事件之外,函数运行时还将上下文对象传递给处理程序。上下文对象包含有关调用、函数和执行环境的其他信息。环境变量中提供了更多信息。

您的 Lambda 函数附带了 CloudWatch Logs 日志组。函数运行时会将每次调用的详细信息发送到 CloudWatch Logs。该运行时会中继调用期间函数输出的任何日志。如果您的函数返回错误,则 Lambda 将为错误设置格式,并将其返回给调用方。