Debug dan jalankan rangkaian tes kustom - AWS IoT Greengrass
Jalankan IDT dalam mode debugPerintah IDT CLI untuk menjalankan percobaan

AWS IoT Greengrass Version 1 memasuki fase umur panjang pada 30 Juni 2023. Untuk informasi selengkapnya, lihat kebijakan AWS IoT Greengrass V1 pemeliharaan. Setelah tanggal ini, tidak AWS IoT Greengrass V1 akan merilis pembaruan yang menyediakan fitur, penyempurnaan, perbaikan bug, atau patch keamanan. Perangkat yang berjalan AWS IoT Greengrass V1 tidak akan terganggu dan akan terus beroperasi dan terhubung ke cloud. Kami sangat menyarankan Anda bermigrasi ke AWS IoT Greengrass Version 2, yang menambahkan fitur baru yang signifikan dan dukungan untuk platform tambahan.

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

Debug dan jalankan rangkaian tes kustom

Setelah konfigurasi yang diperlukan diatur, IDT dapat menjalankan rangkaian tes Anda. Waktu aktif dari rangkaian tes penuh akan tergantung pada perangkat keras dan komposisi rangkaian tes. Untuk referensi, dibutuhkan waktu sekitar 30 menit untuk menyelesaikan rangkaian tes kualifikasi AWS IoT Greengrass pada 3B Raspberry Pi.

Ketika Anda menyusun rangkaian tes Anda, Anda dapat menggunakan IDT untuk menjalankan rangkaian tes dalam mode debug untuk memeriksa kode Anda sebelum Anda menjalankannya atau memberikannya kepada test runner.

Jalankan IDT dalam mode debug

Karena rangkaian tes tergantung pada IDT untuk berinteraksi dengan perangkat, menyediakan konteks, dan menerima hasil, Anda tidak bisa hanya men-debug rangkaian tes Anda di IDE tanpa berinteraksi dengan IDT. Untuk melakukannya, IDT CLI menyediakan perintah debug-test-suite yang memungkinkan Anda menjalankan IDT dalam mode debug. Jalankan perintah berikut untuk menampilkan opsi yang tersedia untuk debug-test-suite:

devicetester_[linux | mac | win_x86-64] debug-test-suite -h

Ketika Anda menjalankan IDT dalam mode debug, IDT tidak benar-benar meluncurkan rangkaian tes atau menjalankan state machine; sebaliknya, IDT berinteraksi dengan IDE Anda untuk menanggapi permintaan yang dibuat dari rangkaian tes yang berjalan di IDE dan mencetak log ke konsol. IDT tidak melakukan timeout dan menunggu untuk keluar hingga secara manual terinterupsi. Dalam mode debug, IDT juga tidak menjalankan state machine dan tidak akan menghasilkan file laporan. Untuk men-debug rangkaian tes Anda, Anda harus menggunakan IDE Anda untuk memberikan beberapa informasi yang biasanya diperoleh IDT dari file JSON konfigurasi. Pastikan Anda memberikan informasi berikut:

  • Variabel lingkungan dan argumen untuk setiap tes. IDT tidak akan membaca informasi ini dari test.json atau suite.json.

  • Argumen untuk memilih perangkat sumber daya. IDT tidak akan membaca informasi ini dari test.json.

Untuk men-debug rangkaian tes Anda, selesaikan langkah berikut:

  1. Buat file konfigurasi pengaturan yang diperlukan untuk menjalankan rangkaian tes. Misalnya, jika rangkaian tes Anda memerlukan device.json, resource.json, dan user data.json, pastikan Anda mengonfigurasi semuanya sesuai kebutuhan.

  2. Jalankan perintah berikut untuk menempatkan IDT dalam mode debug dan pilih perangkat yang diperlukan untuk menjalankan tes.

    devicetester_[linux | mac | win_x86-64] debug-test-suite [options]

    Setelah Anda menjalankan perintah ini, IDT akan menunggu permintaan dari rangkaian tes dan kemudian menanggapinya. IDT juga akan menghasilkan variabel lingkungan yang diperlukan untuk proses kasus untuk IDT Client SDK.

  3. Dalam IDE Anda, gunakan konfigurasi run atau debug untuk melakukan hal berikut:

    1. Menetapkan nilai-nilai variabel lingkungan yang dihasilkan IDT.

    2. Tetapkan nilai dari setiap variabel lingkungan atau argumen yang Anda tentukan dalam file test.json dan suite.json Anda.

    3. Menetapkan breakpoint sesuai kebutuhan.

  4. Menjalankan rangkaian tes di IDE Anda.

    Anda dapat men-debug dan kembali menjalankan rangkaain tes sebanyak mungkin yang diperlukan. IDT tidak melakukan timeout dalam mode debug.

  5. Setelah Anda menyelesaikan debugging, interupsi IDT untuk keluar dari mode debug.

Perintah IDT CLI untuk menjalankan percobaan

Bagian berikut menjelaskan perintah IDT CLI:

IDT v4.0.0
help

Mendaftar informasi tentang perintah yang ditentukan.

list-groups

Mendaftar grup dalam rangkaian tes yang diberikan.

list-suites

Mendaftar rangkaian tes yang tersedia.

list-supported-products

Mencantumkan produk yang didukung untuk versi IDT Anda, dalam hal ini versi AWS IoT Greengrass, dan versi rangkaian uji kualifikasi AWS IoT Greengrass yang tersedia untuk versi IDT saat ini.

list-test-cases

Daftar uji kasus dalam grup uji yang diberikan. Opsi berikut didukung:

  • group-id. Grup uji yang harus dicari. Opsi ini diperlukan dan harus menentukan satu grup.

run-suite

Menjalankan serangkaian tes pada kolam perangkat. Berikut ini adalah beberapa opsi yang umum digunakan:

  • suite-id. Versi rangkaian tes yang akan dijalankan. Jika tidak ditentukan, IDT akan menggunakan versi terbaru dalam folder tests.

  • group-id. Grup uji yang akan jalankan, sebagai daftar yang dipisahkan koma. Jika tidak ditentukan, IDT akan menjalankan semua grup uji di rangkaian tes.

  • test-id. Uji kasus yang akan dijalankan, sebagai daftar yang dipisahkan koma. Ketika ditentukan, group-id harus menentukan satu grup.

  • pool-id. Kolam perangkat yang akan diuji. Test runner harus menentukan kolam jika memiliki beberapa perangkat kolam yang ditentukan dalam file device.json.

  • timeout-multiplier. Mengkonfigurasi IDT untuk mengubah batas waktu eksekusi tes yang ditentukan dalam file test.json untuk tes dengan pengganda yang ditetapkan pengguna.

  • stop-on-first-failure. Mengkonfigurasi IDT untuk menghentikan eksekusi pada kegagalan pertama. Pilihan ini harus digunakan dengan group-id untuk men-debug grup uji yang ditentukan.

  • userdata. Menetapkan file yang berisi informasi data pengguna yang diperlukan untuk menjalankan rangkaian tes. Hal ini hanya diperlukan jika userdataRequired diatur ke BETUL di file suite.jsonuntuk rangkaian uji itu.

Untuk informasi lebih lanjut tentang opsi run-suite, gunakan opsi help:

devicetester_[linux | mac | win_x86-64] run-suite -h
debug-test-suite

Jalankan rangkaian tes dalam mode debug. Untuk informasi selengkapnya, lihat Jalankan IDT dalam mode debug.