Verwenden von AWS SAMCLI with Terraform für lokales Debuggen und Testen

In diesem Thema erfahren Sie, wie Sie unterstützte Befehle der AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAMCLI) in Ihren Terraform Projekten verwenden und. Terraform Cloud

Um Feedback zu geben und Funktionsanfragen einzureichen, erstellen Sie ein GitHubProblem.

Lokales Testen mit sam local invoke

Anmerkung

Um das lokal testen AWS SAMCLI zu können, muss Docker installiert und konfiguriert sein. Anweisungen finden Sie unter Installation von Docker zur Verwendung mit dem AWS SAMCLI.

Im Folgenden finden Sie ein Beispiel für das lokale Testen Ihrer Lambda-Funktion, indem Sie ein Ereignis übergeben:

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

Weitere Informationen zur Verwendung dieses Befehls finden Sie unterEinführung in das Testen mit sam local invoke.

Lokales Testen mit sam local start-api

Um sam local start-api mit zu verwendenTerraform, führen Sie den folgenden Befehl aus:

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

Im Folgenden wird ein Beispiel gezeigt:

$ 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)

Weitere Informationen zu diesem Befehl finden Sie unterEinführung in das Testen mit sam local start-api.

Lambda-Funktionen, die Lambda-Autorisierer verwenden

Für Lambda-Funktionen, die für die Verwendung von Lambda-Autorisierern konfiguriert sind, rufen sie AWS SAMCLI automatisch Ihren Lambda-Autorisierer auf, bevor Sie Ihren Lambda-Funktionsendpunkt aufrufen.

• Weitere Informationen zu dieser Funktion finden Sie unter. AWS SAMCLI Lambda-Funktionen, die Lambda-Autorisierer verwenden

• Weitere Informationen zur Verwendung von Lambda-Autorisierern in finden Sie Resource: aws_api_gateway_authorizerin Terraform der Registrierung. Terraform

Lokales Testen mit sam local start-lambda

Das Folgende ist ein Beispiel für das lokale Testen Ihrer Lambda-Funktion mit der AWS Command Line Interface (AWS CLI):

1. Verwenden Sie die AWS SAMCLI, um eine lokale Testumgebung zu erstellen:

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

2. Verwenden Sie die AWS CLI , um Ihre Funktion lokal aufzurufen:

   $ 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

Weitere Informationen zu diesem Befehl finden Sie unterEinführung in das Testen mit sam local start-lambda.

Terraform-Einschränkungen

Bei der Verwendung von with gelten folgende Einschränkungen: AWS SAMCLI Terraform

• Lambda-Funktionen, die mit mehreren Ebenen verknüpft sind.

• Terraformlokale Variablen, die Verbindungen zwischen Ressourcen definieren.

• Verweisen auf eine Lambda-Funktion, die noch nicht erstellt wurde. Dazu gehören Funktionen, die im Body-Attribut der REST API Ressource definiert sind.

Um diese Einschränkungen zu vermeiden, können Sie ausführen, terraform apply wenn eine neue Ressource hinzugefügt wird.