Ruby Lambda 関数のレイヤーを操作する

Lambda レイヤー は、補助的なコードやデータを含む .zip ファイルアーカイブです。レイヤーには通常、ライブラリの依存関係、カスタムランタイム、または設定ファイルが含まれています。レイヤーの作成には、次の 3 つの一般的な手順が含まれます。

このトピックには、外部ライブラリの依存関係を持つ 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 とそのドキュメントを検査する必要があります。extensions が Gem 仕様で定義されているかどうかを確認することで、gem が拡張機能を使用しているかどうかを特定できます。Ruby は、RUBY_PLATFORM グローバル定数を通じて実行されているプラットフォームを識別します。Lambda Ruby ランタイムは、arm64 アーキテクチャで実行する場合は aarch64-linux として、または x86_64 アーキテクチャで実行する場合は x86_64-linux としてプラットフォームを定義します。Gem がこれらのプラットフォームと互換性があるかどうかを確認する保証はありませんが、platform Gem 仕様属性を介してサポートされているプラットフォームを宣言する Gem もあります。

Ruby ランタイムのレイヤーパス

関数にレイヤーを追加すると、Lambda はレイヤーのコンテンツをその実行環境の /opt ディレクトリに読み込みます。Lambda ランタイムごとに、PATH 変数には /opt ディレクトリ内の特定のフォルダパスがあらかじめ含まれます。Lambda がレイヤーコンテンツを取得できるようにするには、レイヤーの .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"

レスポンスでは、arn:aws:lambda:us-east-1:123456789012:layer:ruby-requests-layer:1 に似ている LayerVersionArn に注目してください。この Amazon リソースネーム (ARN) は、このチュートリアルの次の手順で、レイヤーを関数に追加するときに必要になります。

レイヤーを関数に追加する

このセクションでは、関数コードで tzinfo ライブラリを使用するサンプル Lambda 関数をデプロイし、Layer をアタッチします。関数をデプロイするには、実行ロールを使用した 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