View a markdown version of this page

Panggil Fungsi Peristiwa Lambda secara lokal dengan AWS SAM - AWS Serverless Application Model

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Panggil Fungsi Peristiwa Lambda secara lokal dengan AWS SAM

Memanggil Lambda Event Function secara lokal sebelum pengujian atau penerapan di cloud dapat memiliki berbagai manfaat. Ini memungkinkan Anda untuk menguji logika fungsi Anda lebih cepat. Menguji secara lokal terlebih dahulu mengurangi kemungkinan mengidentifikasi masalah saat pengujian di cloud atau selama penerapan, yang dapat membantu Anda menghindari biaya yang tidak perlu. Selain itu, pengujian lokal membuat debugging lebih mudah dilakukan.

Anda dapat memanggil fungsi Lambda Anda secara lokal dengan menggunakan pemanggilan lokal sam perintah dan menyediakan ID logis fungsi dan file peristiwa. sam local invoke juga menerima stdin sebagai sebuah acara. Untuk informasi selengkapnya tentang peristiwa, lihat Peristiwa di Panduan Developer AWS Lambda . Untuk informasi tentang format pesan acara dari yang berbeda AWS layanan, lihat Menggunakan AWS Lambda dengan layanan lain di AWS Lambda Panduan Pengembang.

penting

Pemanggilan lokal menjalankan kode fungsi di lingkungan lokal Anda. Untuk kode yang tidak Anda tulis atau tinjau, gunakan layanan Lambda, yang menjalankannya secara terpisah dari mesin Anda.

catatan

Yang sam local invoke perintah sesuai dengan AWS Command Line Interface (AWS CLI) perintah aws lambda invoke. Anda dapat menggunakan salah satu perintah untuk memanggil fungsi Lambda.

Anda harus menjalankan sam local invoke perintah dalam direktori proyek yang berisi fungsi yang ingin Anda panggil.

Contoh:

# Invoking function with event file $ sam local invoke "Ratings" -e event.json # Invoking function with event via stdin $ echo '{"message": "Hey, are you there?" }' | sam local invoke --event - "Ratings" # For more options $ sam local invoke --help

File variabel lingkungan

Untuk mendeklarasikan variabel lingkungan secara lokal yang mengganti nilai yang ditentukan dalam template Anda, lakukan hal berikut:

  1. Buat JSON atau .env file yang berisi variabel lingkungan untuk diganti.

  2. Gunakan --env-vars argumen untuk mengganti nilai yang ditentukan dalam template Anda.

Yang --env-vars opsi mendukung dua format file. Format file secara otomatis terdeteksi berdasarkan konten file.

Mendeklarasikan variabel lingkungan dengan JSON

Untuk mendeklarasikan variabel lingkungan yang berlaku secara global ke semua sumber daya, tentukan Parameters objek seperti berikut:

{ "Parameters": { "TABLE_NAME": "localtable", "BUCKET_NAME": "amzn-s3-demo-bucket", "STAGE": "dev" } }

Untuk mendeklarasikan variabel lingkungan yang berbeda untuk setiap sumber daya, tentukan objek untuk setiap sumber daya seperti berikut:

{ "MyFunction1": { "TABLE_NAME": "localtable", "BUCKET_NAME": "amzn-s3-demo-bucket", }, "MyFunction2": { "TABLE_NAME": "localtable", "STAGE": "dev" } }

Saat menentukan objek untuk setiap sumber daya, Anda dapat menggunakan pengidentifikasi berikut, yang tercantum dalam urutan prioritas tertinggi hingga terendah:

  1. logical_id

  2. function_id

  3. function_name

  4. Pengidentifikasi jalur lengkap

Anda dapat menggunakan kedua metode sebelumnya untuk mendeklarasikan variabel lingkungan bersama-sama dalam satu file. Saat melakukannya, variabel lingkungan yang Anda sediakan untuk sumber daya tertentu diutamakan daripada variabel lingkungan global.

Simpan variabel lingkungan Anda dalam file JSON, seperti env.json.

Mendeklarasikan variabel lingkungan dengan file.env

Anda juga dapat menggunakan a .env file untuk mendeklarasikan variabel lingkungan. Variabel yang dideklarasikan dalam a .env file berlaku secara global untuk semua fungsi, setara dengan Parameters objek dalam format JSON.

TABLE_NAME=localtable BUCKET_NAME=amzn-s3-demo-bucket STAGE=dev

Yang .env format mendukung komentar (baris dimulai dengan #) dan nilai-nilai yang dikutip.

catatan

.env format hanya mendukung variabel lingkungan global. Untuk mendeklarasikan variabel lingkungan spesifik fungsi, gunakan format JSON.

Mengganti nilai variabel lingkungan

Untuk mengganti variabel lingkungan dengan yang ditentukan dalam file variabel lingkungan Anda, gunakan --env-vars Argumen dengan invoke atau start-api perintah. Contoh:

# Using a JSON file sam local invoke --env-vars env.json # Using a .env file sam local invoke --env-vars .env

Lapisan

Jika aplikasi Anda menyertakan lapisan, untuk informasi tentang cara men-debug masalah dengan lapisan di host lokal Anda, lihat Tingkatkan efisiensi menggunakan lapisan Lambda dengan AWS SAM.

Pelajari selengkapnya

Untuk contoh langsung memanggil fungsi secara lokal, lihat Modul 2 - Jalankan secara lokal di Yang Lengkap AWS SAM Lokakarya.