Déboguer et exécuter des suites de tests personnalisées - AWS IoT Greengrass

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Déboguer et exécuter des suites de tests personnalisées

Une fois la configuration requise définie, IDT peut exécuter votre suite de tests. Le temps d'exécution de la suite de tests complète dépend du matériel et de la composition de la suite de tests. À titre de référence, il faut environ 30 minutes pour terminer la suite complète de tests de AWS IoT Greengrass qualification sur un Raspberry Pi 3B.

Lorsque vous écrivez votre suite de tests, vous pouvez utiliser IDT pour exécuter la suite de tests en mode débogage afin de vérifier votre code avant de l'exécuter ou de le fournir aux testeurs.

Exécutez IDT en mode debug

Étant donné que les suites de tests dépendent de l'IDT pour interagir avec les appareils, fournir le contexte et recevoir les résultats, vous ne pouvez pas simplement déboguer vos suites de tests dans un IDE sans aucune interaction IDT. Pour ce faire, la CLI IDT fournit la debug-test-suite commande qui vous permet d'exécuter IDT en mode de débogage. Exécutez la commande suivante pour afficher les options disponibles pour debug-test-suite :

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

Lorsque vous exécutez IDT en mode de débogage, IDT ne lance pas réellement la suite de tests ni n'exécute l'orchestrateur de test ; il interagit plutôt avec votre IDE pour répondre aux demandes émanant de la suite de tests exécutée dans l'IDE et imprime les journaux sur la console. L'IDT n'expire pas et attend de sortir jusqu'à ce qu'il soit interrompu manuellement. En mode débogage, IDT n'exécute pas non plus l'orchestrateur de test et ne génère aucun fichier de rapport. Pour déboguer votre suite de tests, vous devez utiliser votre IDE pour fournir certaines informations que IDT obtient généralement à partir des fichiers JSON de configuration. Assurez-vous de fournir les informations suivantes :

  • Variables d'environnement et arguments pour chaque test. IDT ne lira pas ces informations depuis test.json ousuite.json.

  • Arguments pour sélectionner les périphériques de ressources. IDT ne lira pas ces informations depuistest.json.

Pour déboguer vos suites de tests, procédez comme suit :

  1. Créez les fichiers de configuration des paramètres requis pour exécuter la suite de tests. Par exemple, si votre suite de tests nécessite le device.jsonresource.json, etuser data.json, assurez-vous de tous les configurer selon vos besoins.

  2. Exécutez la commande suivante pour placer IDT en mode de débogage et sélectionnez les appareils nécessaires pour exécuter le test.

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

    Après avoir exécuté cette commande, IDT attend les demandes de la suite de tests, puis y répond. IDT génère également les variables d'environnement requises pour le traitement des dossiers pour le SDK client IDT.

  3. Dans votre IDE, utilisez la debug configuration run or pour effectuer les opérations suivantes :

    1. Définissez les valeurs des variables d'environnement générées par IDT.

    2. Définissez la valeur de toutes les variables ou arguments d'environnement que vous avez spécifiés dans votre suite.json fichier test.json and.

    3. Définissez les points d'arrêt selon vos besoins.

  4. Exécutez la suite de tests dans votre IDE.

    Vous pouvez déboguer et réexécuter la suite de tests autant de fois que nécessaire. Le délai d'expiration de l'IDT n'est pas dépassé en mode débogage.

  5. Une fois le débogage terminé, interrompez IDT pour quitter le mode de débogage.

Commandes IDT CLI pour exécuter des tests

La section suivante décrit les commandes de la CLI IDT :

IDT v4.0.0
help

Répertorie les informations sur la commande spécifiée.

list-groups

Répertorie les groupes dans une suite de tests donnée.

list-suites

Répertorie les suites de tests disponibles.

list-supported-products

Répertorie les produits pris en charge pour votre version d'IDT, en l'occurrence AWS IoT Greengrass les versions, et les versions de la suite de tests de AWS IoT Greengrass qualification disponibles pour la version IDT actuelle.

list-test-cases

Répertorie les cas de tests d'un groupe de tests donné. L'option suivante est prise en charge :

  • group-id. Le groupe de test à rechercher. Cette option est obligatoire et doit spécifier un groupe unique.

run-suite

Exécute une suite de tests sur un groupe d'appareils. Les options les plus fréquemment utilisées sont les suivantes :

  • suite-id. Version de la suite de tests à exécuter. Si celle-ci n’est pas spécifiée, IDT utilise la dernière version dans le dossier tests.

  • group-id. Les groupes de test à exécuter, sous forme de liste séparée par des virgules. Si cette option n'est pas spécifiée, IDT exécute tous les groupes de tests de la suite de tests.

  • test-id. Les cas de test à exécuter, sous forme de liste séparée par des virgules. Lorsqu'il est spécifié, group-id doit spécifier un seul groupe.

  • pool-id. Le pool d'appareils à tester. Les testeurs doivent spécifier un pool s'ils ont plusieurs pools d'appareils définis dans votre device.json fichier.

  • timeout-multiplier. Configure IDT pour modifier le délai d'exécution du test spécifié dans le test.json fichier pour un test avec un multiplicateur défini par l'utilisateur.

  • stop-on-first-failure. Configure IDT pour arrêter l'exécution lors du premier échec. Cette option doit être utilisée avec group-id pour déboguer les groupes de tests spécifiés.

  • userdata. Définit le fichier contenant les informations de données utilisateur requises pour exécuter la suite de tests. Cela n'est obligatoire que s'userdataRequiredil est défini sur true dans le suite.json fichier de la suite de tests.

Pour de plus amples informations sur les options run-suite, utilisez l' option help suivante :

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

Exécutez la suite de tests en mode debug. Pour plus d'informations, consultez Exécutez IDT en mode debug.