First write!
"); responseStream.write("${loremIpsum1}
`); await new Promise(r => setTimeout(r, 1000)); responseStream.write("DONE!
"); responseStream.write(""); responseStream.end(); } ); ``` 以下是我們的`template.yaml`檔案範例。使用 `FunctionUrlConfig` 屬性設定 Lambda 函數的回應串流。 ``` AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 Description: > Sample SAM Template for lambda-streaming-nodejs-app Resources: StreamingFunction: Type: AWS::Serverless::Function Properties: CodeUri: src/ Handler: index.handler Runtime: nodejs18.x Architectures: - x86_64 Timeout: 10 FunctionUrlConfig: AuthType: AWS_IAM InvokeMode: RESPONSE_STREAM Outputs: StreamingFunction: Description: "Streaming Lambda Function ARN" Value: !GetAtt StreamingFunction.Arn StreamingFunctionURL: Description: "Streaming Lambda Function URL" Value: !GetAtt StreamingFunctionUrl.FunctionUrl ``` 一般而言，您可以使用 `sam build` 和 `sam deploy --guided`來建置和部署生產應用程式。在此範例中，我們將假設開發環境，並使用 `sam sync`命令來建置和部署我們的應用程式。 **注意** 建議開發環境使用 `sam sync`命令。如需詳細資訊，請參閱 [使用 sam sync 同步至 的簡介 AWS 雲端](using-sam-cli-sync.md)。 在執行 之前`sam sync`，我們會驗證我們的專案是否已在 `samconfig.toml` 檔案中正確設定。最重要的是，我們會驗證 `stack_name`和 的值`watch`。有了組態檔案中指定的這些值，我們就不必在命令列提供這些值。 ``` version = 0.1 [default] [default.global.parameters] stack_name = "lambda-streaming-nodejs-app" [default.build.parameters] cached = true parallel = true [default.validate.parameters] lint = true [default.deploy.parameters] capabilities = "CAPABILITY_IAM" confirm_changeset = true resolve_s3 = true s3_prefix = "lambda-streaming-nodejs-app" region = "us-west-2" image_repositories = [] [default.package.parameters] resolve_s3 = true [default.sync.parameters] watch = true [default.local_start_api.parameters] warm_containers = "EAGER" [default.local_start_lambda.parameters] warm_containers = "EAGER" ``` 接下來，我們會執行 `sam sync`來建置和部署應用程式。由於 `--watch`選項是在我們的組態檔案中設定，因此 AWS SAM CLI會建置我們的應用程式、部署我們的應用程式，並留意變更。 ``` $ sam sync The SAM CLI will use the AWS Lambda, Amazon API Gateway, and AWS StepFunctions APIs to upload your code without performing a CloudFormation deployment. This will cause drift in your CloudFormation stack. **The sync command should only be used against a development stack**. Queued infra sync. Waiting for in progress code syncs to complete... Starting infra sync. Building codeuri: /Users/.../lambda-streaming-nodejs-app/src runtime: nodejs18.x metadata: {} architecture: x86_64 functions: StreamingFunction package.json file not found. Continuing the build without dependencies. Running NodejsNpmBuilder:CopySource Build Succeeded Successfully packaged artifacts and wrote output template to file /var/folders/45/5ct135bx3fn2551_ptl5g6_80000gr/T/tmpavrzdhgp. Execute the following command to deploy the packaged template sam deploy --template-file /var/folders/45/5ct135bx3fn2551_ptl5g6_80000gr/T/tmpavrzdhgp --stack-nameFirst write!
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque vitae mi tincidunt tellus ultricies dignissim id et diam. Morbi pharetra eu nisi et finibus. Vivamus diam nulla, vulputate et nisl cursus, pellentesque vehicula libero. Cras imperdiet lorem ante, non posuere dolor sollicitudin a. Vestibulum ipsum lacus, blandit nec augue id, lobortis dictum urna. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia curae; Morbi auctor orci eget tellus aliquam, non maximus massa porta. In diam ante, pulvinar aliquam nisl non, elementum hendrerit sapien. Vestibulum massa nunc, mattis non congue vitae, placerat in quam. Nam vulputate lectus metus, et dignissim erat varius a.
DONE!
START RequestId: 1e4cdf04-60de-4769-b3a2-c1481982deb4 Version: $LATEST END RequestId: 1e4cdf04-60de-4769-b3a2-c1481982deb4 REPORT RequestId: 1e4cdf04-60de-4769-b3a2-c1481982deb4 Duration: 4088.66 ms Billed Duration: 4089 ms Memory Size: 128 MB Max Memory Used: 68 MB Init Duration: 168.45 ms ``` 當我們修改函數程式碼時， 會 AWS SAM CLI立即偵測並立即部署變更。以下是變更函數程式碼後輸出 AWS SAM CLI的範例： ``` Syncing Lambda Function StreamingFunction... Building codeuri: /Users/.../lambda-streaming-nodejs-app/src runtime: nodejs18.x metadata: {} architecture: x86_64 functions: StreamingFunction package.json file not found. Continuing the build without dependencies. Running NodejsNpmBuilder:CopySource Finished syncing Lambda Function StreamingFunction. Syncing Layer StreamingFunctione9cfe924DepLayer... SyncFlow [Layer StreamingFunctione9cfe924DepLayer]: Skipping resource update as the content didn't change Finished syncing Layer StreamingFunctione9cfe924DepLayer. ``` 我們現在可以`sam remote invoke`再次使用 與雲端中的 函式互動，並測試我們的變更。 ### SQS 範例 #### 基本範例 **透過提供 ARN 做為資源 ID 來叫用 Amazon SQS 佇列：** ``` $ sam remote invoke arn:aws:sqs:us-west-2:01234567890:sqs-example-4DonhBsjsW1b --event '{"hello": "world"}' --output json Sending message to SQS queue MySqsQueue { "MD5OfMessageBody": "49dfdd54b01cbcd2d2ab5e9e5ee6b9b9", "MessageId": "4f464cdd-15ef-4b57-bd72-3ad225d80adc", "ResponseMetadata": { "RequestId": "95d39377-8323-5ef0-9223-ceb198bd09bd", "HTTPStatusCode": 200, "HTTPHeaders": { "x-amzn-requestid": "95d39377-8323-5ef0-9223-ceb198bd09bd", "date": "Wed, 08 Nov 2023 23:27:26 GMT", "content-type": "application/x-amz-json-1.0", "content-length": "106", "connection": "keep-alive" }, "RetryAttempts": 0 } }% ``` ### Step Functions 範例 #### 基本範例 **透過提供其實體 ID 做為資源 ID 來叫用狀態機器：** 首先，我們使用 `sam list resources` 來取得實體 ID： ``` $ sam list resources --stack-name state-machine-example --output json [ { "LogicalResourceId": "HelloWorldStateMachine", "PhysicalResourceId": "arn:aws:states:us-west-2:513423067560:stateMachine:HelloWorldStateMachine-z69tFEUx0F66" }, { "LogicalResourceId": "HelloWorldStateMachineRole", "PhysicalResourceId": "simple-state-machine-HelloWorldStateMachineRole-PduA0BDGuFXw" } ] ``` 接著，我們使用實體 ID 做為資源 ID 來調用狀態機器。我們透過 `--event`選項在命令列傳入事件： ``` $ sam remote invoke arn:aws:states:us-west-2:01234567890:stateMachine:HelloWorldStateMachine-z69tFEUx0F66 --event '{"is_developer": true}' Invoking Step Function arn:aws:states:us-west-2:01234567890:stateMachine:HelloWorldStateMachine-z69tFEUx0F66 "Hello Developer World"% ``` **透過傳遞空事件來叫用狀態機器：** ``` $ sam remote invoke HelloWorldStateMachine --stack-name state-machine-example Invoking Step Function HelloWorldStateMachine "Hello World"% ``` ## 相關連結 如需與 `sam remote invoke` 和使用 相關的文件 AWS SAM CLI，請參閱以下內容： + [sam remote invoke](sam-cli-command-reference-remote-invoke.md) + [AWS SAM CLI 故障診斷](sam-cli-troubleshooting.md) # 使用 自動化本機整合測試 AWS SAM 雖然您可以使用 [使用 進行測試的簡介 sam local invoke](using-sam-cli-local-invoke.md) 手動測試程式碼，但 AWS SAM 也可讓您使用自動化整合測試來測試程式碼。整合測試可協助您在開發週期早期偵測問題、改善程式碼品質，並節省時間，同時降低成本。 若要在 中編寫自動化整合測試 AWS SAM，您必須先針對本機 Lambda 函數執行測試，再部署至 AWS 雲端。[使用 進行測試的簡介 sam local start-lambda](using-sam-cli-local-start-lambda.md) 命令會啟動模擬 Lambda 調用端點的本機端點。您可以從自動化測試叫用它。由於此端點模擬 Lambda 叫用端點，因此您可以撰寫測試一次，然後針對本機 Lambda 函數或已部署的 Lambda 函數執行測試 （無需任何修改）。您也可以針對 CI/CD 管道中已部署的 AWS SAM 堆疊執行相同的測試。 這是程序的運作方式： 1. 啟動本機 Lambda 端點。 在包含 AWS SAM 範本的目錄中執行下列命令，啟動本機 Lambda 端點： ``` sam local start-lambda ``` 此命令會在 `http://127.0.0.1:3001` 模擬時啟動本機端點 AWS Lambda。您可以針對此本機 Lambda 端點執行自動化測試。當您使用 AWS CLI 或 SDK 叫用此端點時，它會在本機執行請求中指定的 Lambda 函數，並傳回回應。 1. 針對本機 Lambda 端點執行整合測試。 在整合測試中，您可以使用 AWS SDK 來使用測試資料叫用 Lambda 函數、等待回應，並確認回應是您所預期的。若要在本機執行整合測試，您應該設定 AWS SDK 傳送 Lambda 調用 API 呼叫，以調用您在上一個步驟中啟動的本機 Lambda 端點。 以下是 Python 範例 （其他語言的 AWS SDKs具有類似的組態）： ``` import boto3 import botocore # Set "running_locally" flag if you are running the integration test locally running_locally = True if running_locally: # Create Lambda SDK client to connect to appropriate Lambda endpoint lambda_client = boto3.client('lambda', region_name="us-west-2", endpoint_url="http://127.0.0.1:3001", use_ssl=False, verify=False, config=botocore.client.Config( signature_version=botocore.UNSIGNED, read_timeout=15, retries={'max_attempts': 0}, ) ) else: lambda_client = boto3.client('lambda') # Invoke your Lambda function as you normally usually do. The function will run # locally if it is configured to do so response = lambda_client.invoke(FunctionName="HelloWorldFunction") # Verify the response assert response == "Hello World" ``` 您可以使用此程式碼，透過將 `running_locally`設定為 來測試已部署的 Lambda 函數`False`。這會將 AWS SDK 設定為在 AWS 雲端中連線至 AWS Lambda 。 # 使用 產生範例事件承載 AWS SAM 若要測試 Lambda 函數，您可以產生和自訂範例事件承載，以模擬 Lambda 函數在由其他服務觸發時將接收的資料 AWS 。這包括 API Gateway、 CloudFormation、Amazon S3 等服務。 產生範例事件承載可協助您使用各種不同的輸入來測試 Lambda 函數的行為，而不需要在即時環境中工作。相較於手動建立 AWS 服務事件範例以測試函數，此方法也會節省時間。 如需可產生範例事件承載的服務完整清單，請使用下列命令： ``` sam local generate-event --help ``` 如需可用於特定服務的選項清單，請使用下列命令： ``` sam local generate-event [SERVICE] --help ``` 範例： ``` #Generates the event from S3 when a new object is created sam local generate-event s3 put # Generates the event from S3 when an object is deleted sam local generate-event s3 delete ``` # 測試和偵錯耐用函數 在本機測試和偵錯耐用函數的運作方式與一般 Lambda 函數類似，並自動支援檢查點和重播。本指南涵蓋常見的測試案例和故障診斷技術。 ## 本機測試工作流程 在本機測試耐用函數時，工作流程與一般 Lambda 函數不同： **耐用的函數測試工作流程** 1. 建置您的應用程式： ``` $ sam build ``` 1. 叫用您的耐久函數： ``` $ sam local invoke MyDurableFunction --durable-execution-name test ``` 1. 如有需要，請檢查執行歷史記錄： ``` $ sam local execution history execution-id ``` ## 常見測試案例 ### 測試檢查點行為 若要測試您的函數是否正確檢查點狀態： ``` # Example Python durable function def handler(event, context): # This will create a checkpoint context.wait(10) # Wait 10 seconds # Function resumes here after wait return {"message": "Function resumed after wait"} ``` 當您在本機叫用此函數時，會自動處理等待期間。 ### 測試回呼案例 對於等待外部回呼的函數： 1. 啟動等待回呼的耐久函數 1. 在另一個終端機中，解析回呼： ``` $ sam local callback succeed callback-id ``` 1. 觀察函數繼續執行 ## 疑難排解 ### 耐用函數未正確執行 **問題：** 函數無法做為持久的函數。 **解決方案：** + 確認 `DurableConfig` 已在您的 SAM 範本中設定 + 確保您的函數程式碼使用耐用的函數 SDK 方法 （例如 `context.wait()`) + 檢查您是否使用支援的執行期 (TypeScript、JavaScript、Python) ### 無法擷取執行歷史記錄 **問題：**`local execution history`命令不會傳回任何結果。 **解決方案：** + 驗證執行 ID 是否正確 + 檢查是否已調用該函數至少一次 ### 回呼命令無法運作 **問題：**回呼命令無法解決待處理的操作。 **解決方案：** + 驗證回呼 ID 是否正確 + 確保函數實際正在等待回呼 + 確認您使用的是正確的回呼命令語法 ## 偵錯秘訣 + **使用執行歷史記錄** - 檢閱執行歷史記錄，以了解您耐用函數的流程 + **遞增測試** - 在新增複雜邏輯之前，從簡單的等待操作開始 + **使用詳細記錄** - 啟用詳細記錄以追蹤執行流程 ## 進一步了解 如需測試和偵錯的詳細資訊，請參閱： + [使用 進行測試的簡介 sam local invoke](using-sam-cli-local-invoke.md) - 本機調用文件 + [sam local execution history](sam-cli-command-reference-sam-local-execution-history.md) - 執行歷史記錄