翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

チュートリアル: Step Functions と を使用したワークフローのテスト AWS SAM CLI ローカル

両方を使用 AWS Step Functions また、 AWS Lambda ローカルマシンで を実行すると、コードを にデプロイしなくてもステートマシンと Lambda 関数をテストできます。 AWS.

詳細については、次のトピックを参照してください。

ステップ 1: セットアップ AWS SAM

AWS Serverless Application Model (AWS SAM) CLI Local には が必要です AWS Command Line Interface, AWS SAM、およびインストールする Docker。

ステップ 2: テスト AWS SAM CLI ローカル

これで、 がインストールされました。 AWS SAM と が Hello World Lambda 関数を作成しました。関数をテストできます。sam-app ディレクトリで、次のコマンドを入力します。

sam local start-api

これにより、Lambda 関数のローカルインスタンスが起動されます。次のような出力が表示されます:

2019-01-31 16:40:27 Found credentials in shared credentials file: ~/.aws/credentials
2019-01-31 16:40:27 Mounting HelloWorldFunction at http://127.0.0.1:3000/hello [GET]
2019-01-31 16:40:27 You can now browse to the above endpoints to invoke your functions. You do not need to restart/reload SAM CLI while working on your functions changes will be reflected instantly/automatically. You only need to restart SAM CLI if you update your AWS SAM template
2019-01-31 16:40:27  * Running on http://127.0.0.1:3000/ (Press CTRL+C to quit)

ブラウザを開き、次のように入力します。

http://127.0.0.1:3000/hello

これにより、次のようなレスポンスが出力されます。

{"message": "hello world", "location": "72.21.198.66"}

CTRL+C を入力して Lambda を終了しますAPI。

ステップ 3: 開始 AWS SAM CLI ローカル

関数が機能することをテストしたので、 を起動します。 AWS SAM CLI ローカル。sam-app ディレクトリで、次のコマンドを入力します。

sam local start-lambda

これにより、 AWS SAM CLI Local と は、次の出力のように、使用するエンドポイントを提供します。

2019-01-29 15:33:32 Found credentials in shared credentials file: ~/.aws/credentials
2019-01-29 15:33:32 Starting the Local Lambda Service. You can now invoke your Lambda Functions defined in your template through the endpoint.
2019-01-29 15:33:32  * Running on http://127.0.0.1:3001/ (Press CTRL+C to quit)

ステップ 4: Step Functions Local のスタート

JAR ファイル

Step Functions Local の .jar ファイルバージョンを使用している場合は、Lambda エンドポイントを指定して Step Functions をスタートします。.jar ファイルを展開したディレクトリで、次のコマンドを入力します。

java -jar StepFunctionsLocal.jar --lambda-endpoint http://localhost:3001

Step Functions Local がスタートすると、環境に続いて、~/.aws/credentials ファイルで設定した認証情報がチェックされます。デフォルトでは、架空のユーザー ID を使用して起動し、region us-east-1 としてリスト表示されます。

2019-01-29 15:38:06.324: Failed to load credentials from environment because Unable to load AWS credentials from environment variables (AWS_ACCESS_KEY_ID (or AWS_ACCESS_KEY) and AWS_SECRET_KEY (or AWS_SECRET_ACCESS_KEY))
2019-01-29 15:38:06.326: Loaded credentials from profile: default
2019-01-29 15:38:06.326: Starting server on port 8083 with account 123456789012, region us-east-1

Docker

Docker バージョンの Step Functions Local を使用している場合、次のコマンドを使用して Step Functions を起動します。

docker run -p 8083:8083 amazon/aws-stepfunctions-local

Docker バージョンの Step Functions のインストールについては、Docker での Step Functions Local (ダウンロード可能バージョン) のセットアップ を参照してください。

ステップ 5: を参照するステートマシンを作成する AWS SAM CLI ローカル関数

Step Functions Local が実行されたら、 でHelloWorldFunction初期化した を参照するステートマシンを作成しますステップ 1: セットアップ AWS SAM。

aws stepfunctions --endpoint http://localhost:8083 create-state-machine --definition "{\
  \"Comment\": \"A Hello World example of the Amazon States Language using an AWS Lambda Local function\",\
  \"StartAt\": \"HelloWorld\",\
  \"States\": {\
    \"HelloWorld\": {\
      \"Type\": \"Task\",\
      \"Resource\": \"arn:aws:lambda:us-east-1:123456789012:function:HelloWorldFunction\",\
      \"End\": true\
    }\
  }\
}\" --name "HelloWorld" --role-arn "arn:aws:iam::012345678901:role/DummyRole"

これにより、ステートマシンが作成され、実行を開始するために使用できる Amazon リソースネーム (ARN) が提供されます。

{
    "creationDate": 1548805711.403, 
    "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld"
}

ステップ 6: ローカルステートマシンの実行を開始する

ステートマシンを作成したら、実行を開始します。次のaws stepfunctionsコマンドARNを使用する場合は、エンドポイントとステートマシンを参照する必要があります。

aws stepfunctions --endpoint http://localhost:8083 start-execution --state-machine arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld --name test

これにより、HelloWorld ステートマシンの test という実行が開始されます。

{
    "startDate": 1548810641.52, 
    "executionArn": "arn:aws:states:us-east-1:123456789012:execution:HelloWorld:test"
}

Step Functions がローカルで実行されたので、 を使用して操作できます。 AWS CLI。 例えば、この実行に関する情報を取得するには、次のコマンドを使用します。

aws stepfunctions --endpoint http://localhost:8083 describe-execution --execution-arn arn:aws:states:us-east-1:123456789012:execution:HelloWorld:test

実行のために describe-execution を呼び出すと、次のような出力により、完全な詳細が提供されます。

{
    "status": "SUCCEEDED", 
    "startDate": 1549056334.073, 
    "name": "test", 
    "executionArn": "arn:aws:states:us-east-1:123456789012:execution:HelloWorld:test", 
    "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld", 
    "stopDate": 1549056351.276, 
    "output": "{\"statusCode\": 200, \"body\": \"{\\\"message\\\": \\\"hello world\\\", \\\"location\\\": \\\"72.21.198.64\\\"}\"}", 
    "input": "{}"
}