sam local start-lambda を使用する

AWS Serverless Application Model コマンドラインインターフェイス (AWS SAM CLI) sam local start-lambda サブコマンドを使用して、AWS Command Line Interface (AWS CLI) または SDK を通じて AWS Lambda 関数を呼び出します。このコマンドは、AWS Lambda をエミュレートするローカルエンドポイントを起動します。

• AWS SAM CLI の概要については、「とは何ですか? AWS SAMCLI」を参照してください。

• sam local start-lambda コマンドオプションのリストについては、「sam local start-lambda」を参照してください。

前提条件

sam local start-lambda を使用するには、次を実行して AWS SAM CLI をインストールします。

• AWS SAM の前提条件.

• AWS SAM CLIのインストール.

sam local start-lambda を使用する前に、次の基本を理解しておくことをお勧めします。

• AWS SAM CLI の設定.

• sam init を使用する.

• sam build を使用する.

• sam deploy を使用する.

sam local start-lambda の使用

sam local start-lambda を実行すると、AWS SAM CLI は現在の作業ディレクトリがプロジェクトのルートディレクトリであると想定します。AWS SAM CLI は最初に .aws-sam サブフォルダ内の template.[yaml|yml] ファイルを検索します。見つからない場合、AWS SAM CLI は現在の作業ディレクトリ内で template.[yaml|yml] ファイルを探します。

sam local start-lambda を使用するには

1. プロジェクトのルートディレクトリから次のコマンドを実行します。

   $ sam local start-lambda <options>

2. AWS SAM CLI は、Lambda 関数をローカル Docker コンテナに構築します。その後、ローカルアドレスを HTTP サーバーエンドポイントに出力します。以下に例を示します。

   $ sam local start-lambda
   Initializing the lambda functions containers.
   Local image is up-to-date
   Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64.
   
   Mounting /Users/.../sam-app/hello_world as /var/task:ro,delegated, inside runtime container
   Containers Initialization is done.
   Starting the Local Lambda Service. You can now invoke your Lambda Functions defined in your template through the endpoint.
   2023-04-13 07:25:43 WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
    * Running on http://127.0.0.1:3001
   2023-04-13 07:25:43 Press CTRL+C to quit

3. AWS CLI または SDK を使用して、Lambda 関数をローカルで呼び出します。

   AWS CLI を使用した例を次に示します。

   $ aws lambda invoke --function-name "HelloWorldFunction" --endpoint-url "http://127.0.0.1:3001" --no-verify-ssl out.txt
       
   StatusCode: 200
   (END)

   Python に AWS SDK を使用した例を次に示します。

   import boto3
   from botocore.config import Config
   from botocore import UNSIGNED
   
   lambda_client = boto3.client('lambda',
                                endpoint_url="http://127.0.0.1:3001",
                                use_ssl=False,
                                verify=False,
                                config=Config(signature_version=UNSIGNED,
                                              read_timeout=1,
                                              retries={'max_attempts': 0}
                                              )
                               )
   lambda_client.invoke(FunctionName="HelloWorldFunction")

オプション

テンプレートを指定する

AWS SAM CLI が参照するテンプレートを指定するには、--template オプションを使用します。AWS SAM CLI は、その AWS SAM テンプレートとそれがポイントするリソースのみをロードします。以下に例を示します。

$ sam local start-lambda --template myTemplate.yaml

ベストプラクティス

アプリケーションに .aws-sam を実行している sam build ディレクトリがある場合は、関数コードを更新するたびに必ず sam build を実行してください。その後、更新された関数コードをローカルでテストするために sam local start-lambda を実行します。

ローカルテストは、クラウドにデプロイする前に迅速な開発とテストを行うための優れたソリューションです。ただし、ローカルテストでは、クラウド内のリソース間の許可など、すべてが検証されるわけではありません。可能な限り、アプリケーションをクラウドでテストします。クラウドテストのワークフローを高速化するために sam sync を使用することをお勧めします。

詳細はこちら

すべての sam local start-lambda オプションのリストについては、「sam local start-lambda」を参照してください。