AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

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.

Didacticiel : Développer une suite de tests IDT simple

Une suite de tests combine les éléments suivants :

Ce didacticiel vous montre comment utiliser IDT pourAWS IoT Greengrasspour développer une suite de tests Python contenant un seul cas de test. Dans ce didacticiel, vous allez réaliser les étapes suivantes :

Prérequis

Pour suivre ce didacticiel, vous aurez besoin des éléments suivants :

Création d'un répertoire de suite de tests

IDT sépare logiquement les cas de test en groupes de tests au sein de chaque suite de tests. Chaque scénario de test doit se trouver à l'intérieur d'un groupe de tests. Pour ce didacticiel, créez un dossier appeléMyTestSuite_1.0.0et créez l'arborescence de répertoires suivante dans ce dossier :

MyTestSuite_1.0.0
└── suite
    └── myTestGroup
        └── myTestCase

Créez des fichiers de configuration JSON

Votre suite de tests doit contenir ce qui suit :Fichiers de configuration JSON :

L'arborescence du répertoire de votreMyTestSuite_1.0.0folder devrait ressembler à ce qui suit :

MyTestSuite_1.0.0
└── suite
    ├── suite.json
    └── myTestGroup
        ├── group.json
        └── myTestCase
            └── test.json

Obtenez le SDK client IDT

Vous utilisez leKit SDK client IDTpour permettre à IDT d'interagir avec l'appareil testé et de signaler les résultats des tests. Pour ce didacticiel, vous allez utiliser la version Python du SDK.

De la<device-tester-extract-location>/sdks/python/, copiez le dossieridt_clientdans votre dossierMyTestSuite_1.0.0/suite/myTestGroup/myTestCasefolder.

Pour vérifier que le kit SDK a bien été copié, exécutez la commande suivante.

cd MyTestSuite_1.0.0/suite/myTestGroup/myTestCase
python3 -c 'import idt_client'

Créer l'exécutable du cas de test

Les exécutables de scénario de test contiennent la logique de test que vous voulez exécuter. Une suite de tests peut contenir plusieurs exécutables de cas de test. Pour ce didacticiel, vous allez créer un seul exécutable de cas de test.

Configuration des informations sur les appareils pour IDT

Configurez les informations de votre appareil pour qu'IDT puisse exécuter le test. Vous devez mettre à jour ladevice.jsonmodèle situé dans le<device-tester-extract-location>/configsdossier contenant les informations suivantes.

[
  {
    "id": "pool",
    "sku": "N/A",
    "devices": [
      {
        "id": "<device-id>",
        "connectivity": {
          "protocol": "ssh",
          "ip": "<ip-address>",
          "port": "<port>",
          "auth": {
            "method": "pki | password",
            "credentials": {
              "user": "<user-name>",
              "privKeyPath": "/path/to/private/key",
              "password": "<password>"
            }
          }
        }
      }
    ]
  }
]

Dansdevices, fournissez les informations suivantes :

Exécutez la suite de tests

Une fois que vous avez créé votre suite de tests, vous devez vous assurer qu'elle fonctionne comme prévu. Effectuez les étapes suivantes pour exécuter la suite de tests avec votre pool de périphériques existant.

IDT exécute votre suite de tests et diffuse les résultats vers la console. Lorsque le test est terminé, les informations suivantes s'affichent :

time="2020-10-19T09:24:47-07:00" level=info msg=Using pool: pool
time="2020-10-19T09:24:47-07:00" level=info msg=Using test suite "MyTestSuite_1.0.0" for execution
time="2020-10-19T09:24:47-07:00" level=info msg=b'hello world\n' suiteId=MyTestSuite groupId=myTestGroup testCaseId=myTestCase deviceId=my-device executionId=9a52f362-1227-11eb-86c9-8c8590419f30
time="2020-10-19T09:24:47-07:00" level=info msg=All tests finished. executionId=9a52f362-1227-11eb-86c9-8c8590419f30
time="2020-10-19T09:24:48-07:00" level=info msg=

========== Test Summary ==========
Execution Time:         1s
Tests Completed:        1
Tests Passed:           1
Tests Failed:           0
Tests Skipped:          0
----------------------------------
Test Groups:
    myTestGroup:        PASSED
----------------------------------
Path to IoT Device Tester Report: /path/to/devicetester/results/9a52f362-1227-11eb-86c9-8c8590419f30/awsiotdevicetester_report.xml
Path to Test Execution Logs: /path/to/devicetester/results/9a52f362-1227-11eb-86c9-8c8590419f30/logs
Path to Aggregated JUnit Report: /path/to/devicetester/results/9a52f362-1227-11eb-86c9-8c8590419f30/MyTestSuite_Report.xml

Dépannage

Utilisez les informations suivantes pour résoudre les problèmes liés à la réalisation du didacticiel.