使用 Ruby 构建 Lambda 函数
您可以在 Amazon Lambda 中运行 Ruby 代码。Lambda 可为 Ruby 提供运行时，用于运行代码来处理事件。您的代码在包含 Amazon SDK for Ruby 的环境中运行，其中包含来自您管理的 Amazon Identity and Access Management (IAM) 角色的凭证。
Lambda 支持以下 Ruby 运行时：
Ruby | |||||
|---|---|---|---|---|---|
| 名称 | 标识符 | SDK | 操作系统 | 架构 | 弃用（阶段 1） |
|
Ruby 2.7 |
|
3.1.0 |
Amazon Linux 2 |
x86_64，arm64 |
有关 Ruby 2.5 的支持终止信息，请参阅 运行时弃用策略：
Lambda 函数使用执行角色获得将日志写入 Amazon CloudWatch Logs 以及访问其他服务和资源的权限。如果您还没有函数开发的执行角色，请创建一个。
创建执行角色
-
在 IAM 控制台中，打开 Roles（角色）页面
。 -
选择 Create role（创建角色）。
-
创建具有以下属性的角色。
-
Trusted entity（可信任的实体）– Lambda。
-
Permissions（权限）– AWSLambdaBasicExecutionRole。
-
Role name（角色名称）–
lambda-role。
AWSLambdaBasicExecutionRole 策略具有函数将日志写入 CloudWatch Logs 所需的权限。
-
您可以稍后向此角色添加权限，或将其与特定于单一函数的其他角色交换。
创建 Ruby 函数
-
打开 Lambda 控制台
。 -
选择 Create function（创建函数）。
-
配置以下设置：
-
名称 –
my-function. -
Runtime（运行时）– Ruby 2.7。
-
Role（角色）– Choose an existing role（选择现有角色）。
-
Existing role（现有角色）–
lambda-role。
-
-
选择 Create function（创建函数）。
-
要配置测试事件，请选择测试。
-
对于事件名称，输入
test。 -
选择 Save changes（保存更改）。
-
要调用该函数，请选择 Test（测试）。
控制台将使用名为 lambda_function.rb 的源文件创建一个 Lambda 函数。您可以在内置代码编辑器中编辑此文件并添加更多文件。要保存您的更改，请选择 Save（保存）。然后，要运行代码，请选择 Test（测试）。
Lambda 控制台使用 Amazon Cloud9 在浏览器中提供集成开发环境。您还可以使用 Amazon Cloud9 在您自己的环境中开发 Lambda 函数。有关更多信息，请参阅 Amazon Cloud9 用户指南中的使用 Lambda 函数。
lambda_function.rb 文件会导出一个名为 lambda_handler 的函数，此函数将接受事件对象和上下文对象。这是 Lambda 在调用函数时调用的处理函数。Ruby 函数运行时从 Lambda 获取调用事件并将其传递到处理程序。在函数配置中，处理程序值为 lambda_function.lambda_handler。
保存函数代码时，Lambda 控制台会创建一个 .zip 文件归档部署包。在控制台外部开发函数代码时（使用 IDE），您需要创建部署程序包将代码上载到 Lambda 函数。
要在本地环境中开始应用程序开发，请部署本指南的 GitHub 存储库中提供的其中一个示例应用程序。
Ruby 中的示例 Lambda 应用程序
-
blank-ruby
– 一个 Ruby 函数，显示日志记录、环境变量、Amazon X-Ray 跟踪、层、单元测试和Amazon开发工具包的使用情况。 适用于 Amazon Lambda 的 Ruby 代码示例 – 在 Ruby 中编写的代码示例，演示了如何与 Amazon Lambda 互动。
除了调用事件之外，函数运行时还将上下文对象传递给处理程序。上下文对象包含有关调用、函数和执行环境的其他信息。环境变量中提供了更多信息。
您的 Lambda 函数附带了 CloudWatch Logs 日志组。函数运行时会将每次调用的详细信息发送到 CloudWatch Logs。该运行时会中继调用期间函数输出的任何日志。如果您的函数返回错误，则 Lambda 将为错误设置格式，并将其返回给调用方。
主题