Pengantar pengujian cloud dengan sam remote test-event

Gunakan AWS Serverless Application Model perintah Command Line Interface (AWS SAM CLI) sam remote test-event untuk mengakses dan mengelola peristiwa pengujian yang dapat dibagikan untuk AWS Lambda fungsi Anda.

Untuk mempelajari lebih lanjut tentang peristiwa pengujian yang dapat dibagikan, lihat Acara pengujian yang dapat dibagikan di Panduan AWS Lambda Pengembang.

Prasyarat

Untuk menggunakansam remote test-event, instal AWS SAMCLI dengan menyelesaikan yang berikut ini:

• AWS SAM prasyarat.

• Instal AWS SAMCLI.

Jika Anda sudah AWS SAM CLI menginstal, kami sarankan untuk meningkatkan ke versi terbaru dari AWS SAMCLI versi. Untuk mempelajari selengkapnya, lihat Upgrade AWS SAMCLI.

Sebelum menggunakansam remote test-event, kami merekomendasikan pemahaman dasar tentang hal-hal berikut:

• Mengkonfigurasi AWS SAMCLI.

• Buat aplikasi Anda dengan sam init perintah.

• Pengantar bangunan dengan sam build perintah.

• Pengantar penerapan dengan perintah sam deploy.

• Pengantar penggunaan sam sync untuk menyinkronkan ke AWS Cloud.

Siapkan AWS SAMCLI untuk digunakan sam remote test-event

Selesaikan langkah-langkah pengaturan berikut untuk menggunakan AWS SAM CLI sam remote test-event perintah:

1. Konfigurasikan AWS SAM CLI untuk menggunakan Akun AWS - Acara pengujian yang dapat dibagikan untuk Lambda dapat diakses dan dikelola oleh pengguna dalam hal yang sama. Akun AWS Untuk mengkonfigurasi AWS SAM CLI untuk menggunakan Anda Akun AWS, lihatMengkonfigurasi AWS SAMCLI.

2. Konfigurasikan izin untuk acara pengujian yang dapat dibagikan — Untuk mengakses dan mengelola peristiwa pengujian yang dapat dibagikan, Anda harus memiliki izin yang tepat. Untuk mempelajari selengkapnya, lihat Acara pengujian yang dapat dibagikan di Panduan AWS Lambda Pengembang.

Menggunakan sam remote test-event perintah

AWS SAM CLIsam remote test-eventPerintah ini menyediakan subperintah berikut yang dapat Anda gunakan untuk mengakses dan mengelola peristiwa pengujian yang dapat dibagikan:

• delete— Hapus acara pengujian yang dapat dibagikan dari registri EventBridge skema Amazon.

• get— Dapatkan acara uji yang dapat dibagikan dari registri EventBridge skema.

• list— Buat daftar peristiwa pengujian yang dapat dibagikan untuk fungsi dari registri EventBridge skema.

• put— Simpan acara dari file lokal ke registri EventBridge skema.

Untuk membuat daftar subperintah ini menggunakan AWS SAM CLI, jalankan yang berikut ini:

$ sam remote test-event --help

Menghapus acara pengujian yang dapat dibagikan

Anda dapat menghapus peristiwa pengujian yang dapat dibagikan dengan menggunakan delete subperintah bersama dengan yang berikut:

• Berikan nama acara pengujian yang dapat dibagikan untuk dihapus.

• Berikan ID yang dapat diterima dari fungsi Lambda yang terkait dengan acara tersebut.

• Jika Anda memberikan ID logis fungsi Lambda, Anda juga harus memberikan nama AWS CloudFormation tumpukan yang terkait dengan fungsi Lambda.

Berikut adalah contohnya:

$ sam remote test-event delete HelloWorldFunction --stack-name sam-app --name demo-event

Untuk daftar opsi yang akan digunakan dengan delete subperintah, lihatsam remote test-event delete. Anda juga dapat menjalankan yang berikut ini dari AWS SAM CLI:

$ sam remote test-event delete --help

Mendapatkan acara uji yang dapat dibagikan

Anda bisa mendapatkan acara pengujian yang dapat dibagikan dari registri EventBridge skema dengan menggunakan get subperintah bersama dengan yang berikut:

• Berikan nama acara uji yang dapat dibagikan untuk didapatkan.

• Berikan ID yang dapat diterima dari fungsi Lambda yang terkait dengan acara tersebut.

• Jika Anda memberikan ID logis fungsi Lambda, Anda juga harus memberikan nama AWS CloudFormation tumpukan yang terkait dengan fungsi Lambda.

Berikut ini adalah contoh yang mendapatkan acara pengujian yang dapat dibagikan bernama demo-event yang terkait dengan fungsi HelloWorldFunction Lambda dari sam-app tumpukan. Perintah ini akan mencetak acara ke konsol Anda.

$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event

Untuk mendapatkan acara pengujian yang dapat dibagikan dan menyimpannya ke mesin lokal Anda, gunakan --output-file opsi dan berikan jalur dan nama file. Berikut ini adalah contoh yang menyimpan demo-event seperti demo-event.json pada direktori kerja saat ini:

$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

Untuk daftar opsi yang akan digunakan dengan get subperintah, lihatsam remote test-event get. Anda juga dapat menjalankan yang berikut ini dari AWS SAM CLI:

$ sam remote test-event get --help

Daftar acara uji yang dapat dibagikan

Anda dapat mencantumkan semua peristiwa pengujian yang dapat dibagikan untuk fungsi Lambda tertentu dari registri skema. Gunakan list subperintah bersama dengan yang berikut ini:

• Berikan ID yang dapat diterima dari fungsi Lambda yang terkait dengan peristiwa.

• Jika Anda memberikan ID logis fungsi Lambda, Anda juga harus memberikan nama AWS CloudFormation tumpukan yang terkait dengan fungsi Lambda.

Berikut ini adalah contoh yang memperoleh daftar semua peristiwa pengujian yang dapat dibagikan yang terkait dengan fungsi HelloWorldFunction Lambda dari tumpukan: sam-app

$ sam remote test-event list HelloWorldFunction --stack-name sam-app

Untuk daftar opsi yang akan digunakan dengan list subperintah, lihatsam remote test-event list. Anda juga dapat menjalankan yang berikut ini dari AWS SAM CLI:

$ sam remote test-event list --help

Menyimpan acara uji yang dapat dibagikan

Anda dapat menyimpan peristiwa pengujian yang dapat dibagikan ke registri EventBridge skema. Gunakan put subperintah bersama dengan yang berikut ini:

• Berikan ID yang dapat diterima dari fungsi Lambda yang terkait dengan peristiwa pengujian yang dapat dibagikan.

• Berikan nama untuk acara pengujian yang dapat dibagikan.

• Berikan jalur file dan nama ke acara lokal untuk diunggah.

Berikut ini adalah contoh yang menyimpan demo-event.json acara lokal sebagai demo-event dan mengaitkannya dengan fungsi HelloWorldFunction Lambda dari sam-app tumpukan:

$ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json

Jika peristiwa pengujian yang dapat dibagikan dengan nama yang sama ada di registri EventBridge skema, AWS SAM CLI maka tidak akan menimpa. Untuk menimpa, tambahkan --force opsi ke perintah Anda.

Untuk daftar opsi yang akan digunakan dengan put subperintah, lihatsam remote test-event put. Anda juga dapat menjalankan yang berikut ini dari AWS SAM CLI:

$ sam remote test-event put --help

Menggunakan acara uji yang dapat dibagikan

Gunakan peristiwa pengujian yang dapat dibagikan untuk menguji fungsi Lambda Anda di dengan AWS Cloud sam remote invoke perintah. Untuk mempelajari selengkapnya, lihat Lulus peristiwa pengujian yang dapat dibagikan ke fungsi Lambda di cloud.

Mengelola acara uji yang dapat dibagikan

Topik ini berisi contoh bagaimana Anda dapat mengelola dan menggunakan peristiwa pengujian yang dapat dibagikan.

Dapatkan acara pengujian yang dapat dibagikan, modifikasi, dan gunakan

Anda bisa mendapatkan acara pengujian yang dapat dibagikan dari registri EventBridge skema, memodifikasinya secara lokal, dan menggunakan peristiwa pengujian lokal dengan fungsi Lambda Anda di. AWS Cloud Berikut adalah contohnya:

1. Mengambil peristiwa pengujian yang dapat dibagikan - Gunakan sam remote test-event get subperintah untuk mengambil peristiwa pengujian yang dapat dibagikan untuk fungsi Lambda tertentu dan menyimpannya secara lokal:

   $ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

2. Ubah acara pengujian yang dapat dibagikan - Gunakan editor teks pilihan Anda untuk memodifikasi acara pengujian yang dapat dibagikan.

3. Gunakan acara pengujian yang dapat dibagikan - Gunakan sam remote invoke perintah dan berikan jalur file dan nama acara dengan--event-file:

   $ sam remote invoke HelloWorldFunction --stack-name sam-app --event-file demo-event.json

Dapatkan acara pengujian yang dapat dibagikan, modifikasi, unggah, dan gunakan

Anda bisa mendapatkan acara pengujian yang dapat dibagikan dari registri EventBridge skema, memodifikasinya secara lokal, dan mengunggahnya. Kemudian, Anda dapat lulus acara pengujian yang dapat dibagikan langsung ke fungsi Lambda Anda di. AWS Cloud Berikut adalah contohnya:

1. Mengambil peristiwa pengujian yang dapat dibagikan - Gunakan sam remote test-event get subperintah untuk mengambil peristiwa pengujian yang dapat dibagikan untuk fungsi Lambda tertentu dan menyimpannya secara lokal:

   $ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

2. Ubah acara pengujian yang dapat dibagikan - Gunakan editor teks pilihan Anda untuk memodifikasi acara pengujian yang dapat dibagikan.

3. Unggah peristiwa pengujian yang dapat dibagikan — Gunakan sam remote test-event put subperintah untuk mengunggah dan menyimpan peristiwa pengujian yang dapat dibagikan ke registri skema. EventBridge Dalam contoh ini, kami menggunakan --force opsi untuk menimpa versi lama dari pengujian kami yang dapat dibagikan:

   $ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json --force

4. Lulus peristiwa pengujian yang dapat dibagikan ke fungsi Lambda Anda — Gunakan sam remote invoke perintah untuk meneruskan peristiwa pengujian yang dapat dibagikan langsung ke fungsi Lambda Anda di: AWS Cloud

   $ sam remote invoke HelloWorldFunction --stack-name sam-app --test-event-name demo-event