本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

針對 Ruby Lambda 函數使用層

Lambda 層是含有補充程式碼或資料的 .zip 封存檔。層通常具備程式庫相依性、自訂執行期或組態檔案。建立層包含三個一般步驟：

本主題包含如何正確封裝和建立具有外部程式庫相依項的 Ruby Lambda 層的步驟和指導。

必要條件

若要完成本節中的步驟，您必須執行下列各項：

在本主題中，我們會參考 awsdocs GitHub 儲存庫上的 layer-ruby 範例應用程式。此應用程式包含可下載相依項並產生層的指令碼。該應用程式也包含對應的函數，這些函數使用來自層的相依項。建立層之後，您可以部署並調用對應的函數，以驗證一切是否正常運作。由於您針對函數使用 Ruby 3.3 執行時期，因此層也必須與 Ruby 3.3 相容。

在 layer-ruby 範例應用程式中，您將 tzinfo 程式庫封裝到 Lambda 層中。layer/ 目錄包含用於產生層的指令碼。function/ 目錄包含一個範例函數，可協助測試層是否正常運作。本教學課程的主要部分會逐步說明如何建立和封裝此層。

Ruby 層與 Lambda 執行時期環境的相容性

當您在 Ruby 層中封裝程式碼時，可以指定與程式碼相容的 Lambda 執行時期環境。若要評估程式碼與執行時期的相容性，請考慮程式碼適用的 Ruby 版本、作業系統以及指令集架構。

Lambda Ruby 執行時期會指定其 Ruby 版本和作業系統。在本文件中，您會使用以 AL2023 為基礎的 Ruby 3.3 執行時期。如需執行時期版本的詳細資訊，請參閱支援的執行期。建立 Lambda 函數時，可以指定指令集架構。在此文件中，您會使用 x86_64 架構。如需 Lambda 架構的詳細資訊，請參閱選取和設定 Lambda 函數的指令集架構。

當您使用套件中的程式碼時，每個套件維護器會獨立定義其相容性。大多數 Gem 套件完全以 Ruby 編寫，並且與使用相容 Ruby 語言版本的任何執行時期相容。

有時候，Gem 套件會使用稱為延伸項目的 Ruby 功能來編譯程式碼，或在安裝程序中包含預先編譯的程式碼。如果您依賴具有原生擴展的 Gem 套件，則必須評估作業系統和指令集架構相容性。若要評估 Gem 套件與 Ruby 執行時期之間的相容性，您需要檢查 Gem 套件及其文件。您可以透過檢查 Gem 套件規格中是否定義了 extensions，來識別 Gem 套件是否使用了延伸項目。Ruby 透過 RUBY_PLATFORM 全域常數來識別其正在執行的平台。Lambda Ruby 執行時期會將平台定義為 aarch64-linux (當在 arm64 架構上執行時) 或 x86_64-linux (當在 x86_64 架構上執行時)。沒有確鑿的方法檢查 Gem 套件是否與這些平台相容，但有些 Gem 套件會透過 platform Gem 規格屬性宣告其支援的平台。

Ruby 執行時期的層路徑

將層新增至函數時，Lambda 會將層內容載入該執行環境的 /opt 目錄。在每一次 Lambda 執行期中，PATH 變數已包含 /opt 目錄中的特定資料夾路徑。為確定 PATH 變數能夠擷取您的層內容，您的層 .zip 檔案應該在下列資料夾路徑中有其相依項：

在此文件中，使用 ruby/gems/x 路徑。Lambda 預計此目錄的內容會對應至 Bundler 安裝目錄的結構。將您的 Gem 套件相依項與其他中繼資料子目錄一起存放在層路徑的 /gems 子目錄中。例如，您在本教學課程中建立的層 .zip 檔案具有下列目錄結構：

layer_content.zip
└ ruby
    └ gems
        └ 3.3.0
            └ gems
                └ tzinfo-2.0.6
                └ <other_dependencies> (i.e. dependencies of the tzinfo package)
                └ ...
            └ <metadata generated by bundle>

tzinfo 程式庫位於正確的 ruby/gems/3.3.0/ 目錄中。這樣可以確保 Lambda 能夠在函數調用期間找到程式庫。

封裝層內容

在此範例中，您會將 Ruby tzinfo 程式庫封裝到層 .zip 檔案中。請完成下列步驟，以安裝和封裝層內容。

建立層

在本節中，您會取得您在上一節中產生的 layer_content.zip 檔案，並將其上傳為 Lambda 層。您可以透過 AWS Command Line Interface (AWS CLI) 使用 AWS Management Console或 Lambda API 上傳層。當您上傳層 .zip 檔案時，請在下列 PublishLayerVersion AWS CLI 命令中，將 ruby3.3 指定為相容的執行時期，將 arm64 指定為相容的架構。

aws lambda publish-layer-version --layer-name ruby-requests-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes ruby3.3 \
    --compatible-architectures "arm64"

從回應中記下 LayerVersionArn，它類似於 arn:aws:lambda:us-east-1:123456789012:layer:ruby-requests-layer:1。在本教學課程的下一個步驟中，當您將層新增至函數時，將需要此 Amazon Resource Name (ARN)。

將層新增至函數

在本節中，您會部署一個在函數程式碼中使用 tzinfo 程式庫的範例 Lambda 函數，然後連接層。若要部署函數，您需要使用執行角色定義 Lambda 函數許可。如果沒有現有的執行角色，請依可摺疊區段中的步驟操作。

Lambda 函數程式碼會匯入 tzinfo 程式庫，然後傳回狀態碼和當地語系化日期字串。

require 'json'
require 'tzinfo'

def lambda_handler(event:, context:)
    tz = TZInfo::Timezone.get('America/New_York')
    { statusCode: 200, body: tz.to_local(Time.utc(2018, 2, 1, 12, 30, 0)) }
end