使用 Ruby 建置 Lambda 函數 - AWS Lambda

使用 Ruby 建置 Lambda 函數

您可以在 AWS Lambda 中執行 Ruby 程式碼。Lambda 提供用於執行程式碼來處理事件的 Ruby 執行時間。您的程式碼將使用您所管理的 AWS Identity and Access Management (IAM) 角色的登入資料,在含有 AWS SDK for Ruby 的環境中執行。

Lambda 支援以下 Ruby 執行時間。

Ruby 執行時間
名稱 識別符 適用於 Ruby 的 SDK 作業系統 架構

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. 進行下列設定:

    • Name (名稱) – my-function

    • Runtime (執行時間) - Ruby 2.7

    • Role (角色) – 選擇現有的角色

    • Existing role (現有角色) - lambda-role

  4. 選擇 Create function (建立函數)。

  5. 若要設定測試事件,請選擇 Test (測試)

  6. Event name (事件名稱) 輸入 test

  7. 選擇 Save changes (儲存變更)。

  8. 若要叫用函數,請選擇 Test (測試)。

主控台將建立一個 Lambda 函數,其具有名為 lambda_function.rb 的單一來源檔案。您可以使用內建的程式碼編輯器編輯該檔案並加入更多檔案。選擇 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 會對該錯誤進行格式化之後傳回給叫用端。