Python Lambda 関数にレイヤーを使用する

sample-apps/layer-python ディレクトリで必要なサンプルコードを含む「aws-lambda-developer-guide GitHub リポジトリ」を複製します。

git clone https://github.com/awsdocs/aws-lambda-developer-guide.git

layer-python サンプルアプリの layer ディレクトリに移動します。このディレクトリには、レイヤーを適切に作成してパッケージ化するために使用するスクリプトが含まれています。

cd aws-lambda-developer-guide/sample-apps/layer-python/layer

requirements.txt ファイルを検証する このファイルは、レイヤー (つまり requests ライブラリ) に含める依存関係を定義します。このファイルを更新し、独自のレイヤーに含める依存関係を含めることができます。

requests==2.31.0

両方のスクリプトを実行する許可があることを確認してください。

chmod 744 1-install.sh && chmod 744 2-package.sh

次のコマンドを使用して「1-install.sh」スクリプトを実行します。

./1-install.sh

このスクリプトは venv を使用し、create_layer という名前の Python 仮想環境を作成します。次に、必要な依存関係をすべて create_layer/lib/python3.11/site-packages ディレクトリにインストールします。

python3.13 -m venv create_layer
source create_layer/bin/activate
pip install -r requirements.txt

次のコマンドを使用して「2-package.sh」スクリプトを実行します。

./2-package.sh

このスクリプトは、create_layer/lib ディレクトリから python という名前の新しいディレクトリに内容をコピーします。次に、python ディレクトリの内容を layer_content.zip という名前のファイルに圧縮します。これはレイヤーの .zip ファイルです。ファイルを解凍し、Python ランタイムのレイヤーパス セクションで示されている正しいファイル構造が含まれていることを確認できます。

mkdir python
cp -r create_layer/lib python/
zip -r layer_content.zip python

function/ ディレクトリに移動します。現在、layer/ ディレクトリにいる場合、次のコマンドを実行します。

cd ../function

次のコマンドを使用し、.zip ファイルのデプロイパッケージを作成します。

zip my_deployment_package.zip lambda_function.py

関数をデプロイします。次の AWS CLI コマンドで、--role パラメータを実行ロール ARN に置き換えます。

aws lambda create-function --function-name python_function_with_layer \
    --runtime python3.13 \
    --architectures "arm64" \
    --handler lambda_function.lambda_handler \
    --role arn:aws:iam::123456789012:role/lambda-role \
    --zip-file fileb://my_deployment_package.zip

次に、レイヤーを関数にアタッチします。次の AWS CLI コマンドで、--layers パラメーターを先にメモしたレイヤーバージョン ARN に置き換えます。

aws lambda update-function-configuration --function-name python_function_with_layer \
    --cli-binary-format raw-in-base64-out \
    --layers "arn:aws:lambda:us-east-1:123456789012:layer:python-requests-layer:1"

最後に、次の AWS CLI コマンドを使用して関数の呼び出しを試みます。

aws lambda invoke --function-name python_function_with_layer \
    --cli-binary-format raw-in-base64-out \
    --payload '{ "key": "value" }' response.json

次のような出力が表示されます。

{
    "StatusCode": 200,
    "ExecutedVersion": "$LATEST"
}

出力 response.json ファイルには、レスポンスに関する詳細が含まれています。

sample-apps/layer-python ディレクトリで必要なサンプルコードを含む「aws-lambda-developer-guide GitHub リポジトリ」を複製します。

git clone https://github.com/awsdocs/aws-lambda-developer-guide.git

layer-python サンプルアプリの layer-numpy ディレクトリに移動します。このディレクトリには、レイヤーを適切に作成してパッケージ化するために使用するスクリプトが含まれています。

cd aws-lambda-developer-guide/sample-apps/layer-python/layer-numpy

requirements.txt ファイルを検証する このファイルは、レイヤー (つまり、numpy ライブラリ) に含める依存関係を定義します。ここでは、Python 3.11、Amazon Linux、x86_64 指示セットと互換性のある manylinux ホイールディストリビューションの URL を指定します。

https://files.pythonhosted.org/packages/3a/d0/edc009c27b406c4f9cbc79274d6e46d634d139075492ad055e3d68445925/numpy-1.26.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

両方のスクリプトを実行する許可があることを確認してください。

chmod 744 1-install.sh && chmod 744 2-package.sh

次のコマンドを使用して「1-install.sh」スクリプトを実行します。

./1-install.sh

このスクリプトは venv を使用し、create_layer という名前の Python 仮想環境を作成します。次に、必要な依存関係をすべて create_layer/lib/python3.11/site-packages ディレクトリにインストールします。--platform タグを manylinux2014_x86_64 として指定する必要があるため、この場合の pip コマンドは異なります。ローカルマシンが MacOS または Windows を使用している場合でも、正しい manylinux ホイールをインストールするように pip に指示します。

python3.11 -m venv create_layer
source create_layer/bin/activate
pip install -r requirements.txt --platform=manylinux2014_x86_64 --only-binary=:all: --target ./create_layer/lib/python3.11/site-packages

次のコマンドを使用して「2-package.sh」スクリプトを実行します。

./2-package.sh

このスクリプトは、create_layer/lib ディレクトリから python という名前の新しいディレクトリに内容をコピーします。次に、python ディレクトリの内容を layer_content.zip という名前のファイルに圧縮します。これはレイヤーの .zip ファイルです。ファイルを解凍し、Python ランタイムのレイヤーパス セクションに示されている正しいファイル構造が含まれていることを確認できます。

mkdir python
cp -r create_layer/lib python/
zip -r layer_content.zip python

function-numpy/ ディレクトリに移動します。現在、layer-numpy/ ディレクトリにいる場合、次のコマンドを実行します。

cd ../function-numpy

「関数コード」を確認します。関数は numpy ライブラリをインポートし、単純な numpy 配列を作成してダミーのステータスコードおよび本文を返します。

import json
import numpy as np

def lambda_handler(event, context):

    x = np.arange(15, dtype=np.int64).reshape(3, 5)
    print(x)

    return {
        'statusCode': 200,
        'body': json.dumps('Hello from Lambda!')
    }

次のコマンドを使用し、.zip ファイルのデプロイパッケージを作成します。

zip my_deployment_package.zip lambda_function.py

関数をデプロイします。次の AWS CLI コマンドで、--role パラメータを実行ロール ARN に置き換えます。

aws lambda create-function --function-name python_function_with_numpy \
    --runtime python3.11 \
    --handler lambda_function.lambda_handler \
    --role arn:aws:iam::123456789012:role/lambda-role \
    --zip-file fileb://my_deployment_package.zip

次に、レイヤーを関数にアタッチします。次の AWS CLI コマンドでは、--layers パラメータを以下のレイヤーバージョン ARN に置き換えます。

aws lambda update-function-configuration --function-name python_function_with_numpy \
    --cli-binary-format raw-in-base64-out \
    --layers "arn:aws:lambda:us-east-1:123456789012:layer:python-requests-layer:1"

最後に、次の AWS CLI コマンドを使用して関数の呼び出しを試みます。

aws lambda invoke --function-name python_function_with_numpy \
    --cli-binary-format raw-in-base64-out \
    --payload '{ "key": "value" }' response.json

次のような出力が表示されます。

{
    "StatusCode": 200,
    "ExecutedVersion": "$LATEST"
}

関数ログを調べ、コードが numpy 配列を標準出力に出力していることを確認できます。