Menggunakan AWS SAMCLI with Terraform untuk debugging dan pengujian lokal

Topik ini mencakup cara menggunakan AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI) yang didukung dengan Terraform proyek Anda danTerraform Cloud.

Untuk memberikan umpan balik dan mengirimkan permintaan fitur, buat GitHubMasalah.

Pengujian lokal dengan sam local invoke

catatan

Untuk menggunakan AWS SAMCLI to test secara lokal, Anda harus memiliki Docker intalled dan dikonfigurasi. Untuk petunjuk, lihat Menginstal Docker untuk digunakan dengan AWS SAMCLI.

Berikut ini adalah contoh pengujian fungsi Lambda Anda secara lokal dengan meneruskan suatu peristiwa:

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

Untuk mempelajari lebih lanjut tentang menggunakan perintah ini, lihatPengantar pengujian dengan sam local invoke.

Pengujian lokal dengan sam local start-api

Untuk menggunakannya sam local start-apiTerraform, jalankan yang berikut ini:

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

Berikut adalah contohnya:

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

Untuk mempelajari lebih lanjut tentang perintah ini, lihatPengantar pengujian dengan sam local start-api.

Fungsi Lambda yang menggunakan otorisasi Lambda

Untuk fungsi Lambda yang dikonfigurasi untuk menggunakan otorisasi Lambda, Lambda akan AWS SAMCLI secara otomatis memanggil otorisasi Lambda Anda sebelum menjalankan titik akhir fungsi Lambda Anda.

• Untuk mempelajari lebih lanjut tentang fitur ini di AWS SAMCLI, lihatFungsi Lambda yang menggunakan otorisasi Lambda.

• Untuk informasi selengkapnya tentang penggunaan otorisasi Lambda diTerraform, lihat Resource: aws_api_gateway_authorizerdi registri. Terraform

Pengujian lokal dengan sam local start-lambda

Berikut ini adalah contoh pengujian fungsi Lambda Anda secara lokal dengan (): AWS Command Line Interface AWS CLI

1. Gunakan AWS SAMCLI untuk membuat lingkungan pengujian lokal:

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

2. Gunakan tombol AWS CLI untuk menjalankan fungsi Anda secara lokal:

   $ 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

Untuk mempelajari lebih lanjut tentang perintah ini, lihatPengantar pengujian dengan sam local start-lambda.

Batasan Terraform

Berikut ini adalah batasan saat menggunakan AWS SAMCLI withTerraform:

• Fungsi Lambda ditautkan ke beberapa lapisan.

• Terraformvariabel lokal yang mendefinisikan hubungan antar sumber daya.

• Mereferensikan fungsi Lambda yang belum dibuat. Ini termasuk fungsi yang didefinisikan dalam atribut body REST API sumber daya.

Untuk menghindari keterbatasan ini, Anda dapat menjalankan terraform apply ketika sumber daya baru ditambahkan.