Esegui il debug ed esegui suite di test personalizzate - AWS IoT Greengrass
Esegui IDT in modalità di debugComandi IDT CLI per eseguire test

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esegui il debug ed esegui suite di test personalizzate

Dopo aver impostato la configurazione richiesta, IDT può eseguire la suite di test. Il tempo di esecuzione della suite di test completa dipende dall'hardware e dalla composizione della suite di test. Per riferimento, sono necessari circa 30 minuti per completare l'intera suite di test di AWS IoT Greengrass qualificazione su un Raspberry Pi 3B.

Durante la scrittura della suite di test, è possibile utilizzare IDT per eseguire la suite di test in modalità debug per controllare il codice prima di eseguirlo o fornirlo ai test runner.

Esegui IDT in modalità di debug

Poiché le suite di test dipendono da IDT per interagire con i dispositivi, fornire il contesto e ricevere risultati, non è possibile semplicemente eseguire il debug delle suite di test in un IDE senza alcuna interazione IDT. A tale scopo, la CLI IDT fornisce debug-test-suite il comando che consente di eseguire IDT in modalità di debug. Eseguite il comando seguente per visualizzare le opzioni disponibili per: debug-test-suite

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

Quando eseguite IDT in modalità debug, IDT non avvia effettivamente la suite di test né esegue il test orchestrator; interagisce invece con l'IDE per rispondere alle richieste fatte dalla suite di test in esecuzione nell'IDE e stampa i log sulla console. IDT non scade e attende di uscire fino a quando non viene interrotto manualmente. In modalità debug, IDT inoltre non esegue il test orchestrator e non genererà alcun file di report. Per eseguire il debug della suite di test, è necessario utilizzare l'IDE per fornire alcune informazioni che IDT di solito ottiene dai file JSON di configurazione. Assicurati di fornire le seguenti informazioni:

  • Variabili di ambiente e argomenti per ogni test. IDT non leggerà queste informazioni da test.json osuite.json.

  • Argomenti per selezionare i dispositivi di risorse. IDT non leggerà queste informazioni datest.json.

Per eseguire il debug delle tue suite di test, completa i seguenti passaggi:

  1. Crea i file di configurazione delle impostazioni necessari per eseguire la suite di test. Ad esempio, se la tua suite di test richiede device.json resource.jsonuser data.json, e, assicurati di configurarli tutti secondo necessità.

  2. Eseguite il comando seguente per mettere IDT in modalità debug e selezionare tutti i dispositivi necessari per eseguire il test.

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

    Dopo aver eseguito questo comando, IDT attende le richieste dalla suite di test e quindi risponde ad esse. IDT genera anche le variabili di ambiente necessarie per il processo di elaborazione dei casi per IDT Client SDK.

  3. Nel tuo IDE, usa la debug configurazione run o per effettuare le seguenti operazioni:

    1. Imposta i valori delle variabili di ambiente generate da IDT.

    2. Imposta il valore di tutte le variabili o gli argomenti di ambiente che hai specificato nel file test.json andsuite.json.

    3. Imposta i punti di interruzione in base alle esigenze.

  4. Esegui la suite di test nel tuo IDE.

    Puoi eseguire il debug e rieseguire la suite di test tutte le volte che è necessario. IDT non scade in modalità di debug.

  5. Dopo aver completato il debug, interrompi IDT per uscire dalla modalità di debug.

Comandi IDT CLI per eseguire test

La sezione seguente descrive i comandi IDT CLI:

IDT v4.0.0
help

Elenca le informazioni sul comando specificato.

list-groups

Elenca i gruppi in una determinata suite di test.

list-suites

Elenca le suite di test disponibili.

list-supported-products

Elenca i prodotti supportati per la versione di IDT in uso, in questo caso AWS IoT Greengrass le versioni, e le versioni della suite di test di AWS IoT Greengrass qualificazione disponibili per la versione IDT corrente.

list-test-cases

Elenca i casi di test in un determinato gruppo di test. È supportata la seguente opzione:

  • group-id. Il gruppo di test da cercare. Questa opzione è obbligatoria e deve specificare un singolo gruppo.

run-suite

Esegue una suite di test in un determinato pool di dispositivi. Di seguito sono riportate alcune opzioni di uso comune:

  • suite-id. La versione della suite di test da eseguire. Se non specificato, IDT utilizza la versione più recente nella cartella tests.

  • group-id. I gruppi di test da eseguire, sotto forma di elenco separato da virgole. Se non specificato, IDT esegue tutti i gruppi di test nella suite di test.

  • test-id. I casi di test da eseguire, come elenco separato da virgole. Quando specificato, group-id deve specificare un singolo gruppo.

  • pool-id. Il pool di dispositivi da testare. I test runner devono specificare un pool se hanno più pool di dispositivi definiti nel device.json file.

  • timeout-multiplier. Configura IDT per modificare il timeout di esecuzione del test specificato nel test.json file per un test con un moltiplicatore definito dall'utente.

  • stop-on-first-failure. Configura IDT per interrompere l'esecuzione al primo errore. Questa opzione deve essere utilizzata con group-id per eseguire il debug dei gruppi di test specificati.

  • userdata. Imposta il file che contiene le informazioni sui dati utente necessarie per eseguire la suite di test. Questo è richiesto solo se userdataRequired è impostato su true nel suite.json file della suite di test.

Per ulteriori informazioni sulle opzioni run-suite, utilizzare l'opzione help:

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

Esegui la suite di test in modalità debug. Per ulteriori informazioni, consulta Esegui IDT in modalità di debug.