使用 AWS SAM CLI 取代為 Terraform 用於本機偵錯和測試 - AWS Serverless Application Model
使用 進行本機測試 sam local invoke使用 進行本機測試 sam local start-api使用 進行本機測試 sam local start-lambdaTerraform 限制

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

使用 AWS SAM CLI 取代為 Terraform 用於本機偵錯和測試

本主題說明如何使用支援的 AWS Serverless Application Model 命令列界面 (AWS SAM CLI) 命令搭配您的 Terraform 專案和 Terraform Cloud.

若要提供意見回饋並提交功能請求，請建立 GitHub 問題。

使用 進行本機測試 sam local invoke

注意

使用 AWS SAM CLI 若要在本機測試，您必須安裝並設定 Docker。如需說明，請參閱 安裝 Docker 以搭配 使用 AWS SAM CLI。

以下是透過傳入事件在本機測試 Lambda 函數的範例：

$ sam local invoke --hook-name terraform hello_world_function -e events/event.json -

若要進一步了解如何使用此命令，請參閱 使用 進行測試的簡介 sam local invoke。

使用 進行本機測試 sam local start-api

sam local start-api 搭配 使用 Terraform，請執行下列動作：

$ sam local start-api --hook-name terraform

以下是範例：

$ sam local start-api --hook-name terraform                                                                                                                                                                                                                                                                                           
                                                                                                                                                                                                          
Running Prepare Hook to prepare the current application                                                                                                                                                   
Executing prepare hook of hook "terraform"                                                                                                                                                                
Initializing Terraform application                                                                                                                                                                        
...
Creating terraform plan and getting JSON output                                                                                                                                                           
....
Generating metadata file                                                                                                                                                                                  
                                                                                                                                                                                                          
Unresolvable attributes discovered in project, run terraform apply to resolve them.                                                                                                                       
                                                                                                                                                                                                          
Finished generating metadata file. Storing in...
Prepare hook completed and metadata file generated at: ...    
Mounting HelloWorldFunction at http://127.0.0.1:3000/hello [GET]                                                                                                                                          
Mounting None at http://127.0.0.1:3000/hello [POST]                                                                                                                                                       
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. If you  
used sam build before running local commands, you will need to re-run sam build for the changes to be picked up. You only need to restart SAM CLI if you update your AWS SAM template                     
2023-06-26 13:21:20  * Running on http://127.0.0.1:3000/ (Press CTRL+C to quit)

若要進一步了解此命令，請參閱 使用 進行測試的簡介 sam local start-api。

使用 Lambda 授權方的 Lambda 函數

對於設定為使用 Lambda 授權方的 Lambda 函數， AWS SAM CLI 在叫用 Lambda 函數端點之前， 會自動叫用您的 Lambda 授權方。

使用 進行本機測試 sam local start-lambda

以下是使用 AWS Command Line Interface () 在本機測試 Lambda 函數的範例AWS CLI：

  1. 使用 AWS SAM CLI 建立本機測試環境：

    $ sam local start-lambda --hook-name terraform hello_world_function

  2. 使用 AWS CLI 在本機叫用您的 函數：

    $ aws lambda invoke --function-name hello_world_function --endpoint-url http://127.0.0.1:3001/ response.json --cli-binary-format raw-in-base64-out --payload file://events/event.json

若要進一步了解此命令，請參閱 使用 進行測試的簡介 sam local start-lambda。

Terraform 限制

以下是使用 時的限制 AWS SAM CLI 取代為 Terraform:

  • 連結至多層的 Lambda 函數。

  • Terraform 定義資源之間連結的本機變數。

  • 參考尚未建立的 Lambda 函數。這包括在RESTAPI資源的內文屬性中定義的函數。

若要避免這些限制，您可以在新增資源terraform apply時執行 。