教學課程：使用 Step Functions 和 CLI Local AWS SAM測試工作流程 - AWS Step Functions
步驟 1：設定AWS SAM步驟 2：測試 AWS SAMCLI Local步驟 3：啟動本機 AWS SAMCLI步驟 4：啟動 Step Functions Local步驟 5：建立參考 CLI Local Function AWS SAM的狀態機器步驟 6：開始您本機狀態機器的執行

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

教學課程：使用 Step Functions 和 CLI Local AWS SAM測試工作流程

不支援 Step Functions Local

Step Functions Local 不提供功能同位，且不受支援。

您可以考慮將模擬 Step Functions 的第三方解決方案用於測試目的。

作為 Step Functions Local 的替代方案，您可以使用 TestState API 在部署到AWS您的帳戶之前，先單元測試您的狀態機器邏輯。如需詳細資訊，請參閱使用 TestState API 測試狀態機器。

在本機電腦上同時AWS Lambda執行 AWS Step Functions和 時，您可以測試狀態機器和 Lambda 函數，而無需將程式碼部署到其中AWS。

如需詳細資訊，請參閱下列主題：

步驟 1：設定AWS SAM

AWS Serverless Application Model(AWS SAM) CLI Local 需要安裝 AWS Command Line InterfaceAWS SAM、 和 Docker。

  1. 安裝 AWS SAMCLI。

    注意

    安裝 AWS SAMCLI 之前，您需要安裝 AWS CLI和 Docker。請參閱安裝 CLI AWS SAM的先決條件。

  2. 請參閱 AWS SAM Quick Start 文件。請務必遵循步驟來執行以下作業：

    1. 初始化應用程式

    2. 在本機測試應用程式

    這會建立sam-app目錄，並建置包含 Python Hello World Lambda 函數的環境。

步驟 2：測試 AWS SAMCLI Local

現在您已安裝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 SAMCLI

現在您已測試 函數是否正常運作，請啟動 AWS SAMCLI Local。在 sam-app 目錄中，輸入下列命令：

sam local start-lambda

這會啟動 AWS SAMCLI 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 的檔案版本，請啟動 Step Functions 並指定 Lambda 端點。在您解壓縮.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 account-id, region us-east-1

Docker

如果您使用的是 Step Functions Local 的 Docker 版本，請使用下列命令啟動 Step Functions：

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

如需安裝 Step Functions Docker 版本的相關資訊，請參閱 在 Docker 中設定 Step Functions Local （可下載版本）。

注意

如果您從 .jar 檔案啟動 Step Functions，您可以透過命令列或設定環境變數來指定端點。針對 Docker 版本，您必須在文字檔案中指定端點和登入資料。請參閱 設定 Step Functions Local 的組態選項。

步驟 5：建立參考 CLI Local Function AWS SAM的狀態機器

在 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:region:account-id:function:HelloWorldFunction\",\
      \"End\": true\
    }\
  }\
}\" --name "HelloWorld" --role-arn "arn:aws:iam::012345678901:role/DummyRole"

這會建立狀態機器，並提供可用來啟動執行的 Amazon Resource Name (ARN)。

{
    "creationDate": 1548805711.403, 
    "stateMachineArn": "arn:aws:states:region:account-id:stateMachine:HelloWorld"
}

步驟 6：開始您本機狀態機器的執行

建立狀態機器後，請開始執行。使用下列aws stepfunctions命令時，您將需要參考端點和狀態機器 ARN：

aws stepfunctions --endpoint http://localhost:8083 start-execution --state-machine arn:aws:states:region:account-id:stateMachine:HelloWorld --name test

這會啟動名為 HelloWorld 狀態機器test的執行。

{
    "startDate": 1548810641.52, 
    "executionArn": "arn:aws:states:region:account-id:execution:HelloWorld:test"
}

現在 Step Functions 已在本機執行，您可以使用 與其互動AWS CLI。例如，若要取得此執行的相關資訊，請使用下列命令：

aws stepfunctions --endpoint http://localhost:8083 describe-execution --execution-arn arn:aws:states:region:account-id:execution:HelloWorld:test

呼叫 describe-execution 執行可提供更完整的詳細資訊，類似於下列輸出：

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