Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Tutorial: Entwickeln einer einfachen IDT-Testsuite

Eine Testsuite kombiniert Folgendes:

Dieses Tutorial zeigt Ihnen, wie Sie IDT für verwenden, AWS IoT Greengrass um eine Python-Testsuite zu entwickeln, die einen einzelnen Testfall enthält. In diesem Tutorial führen Sie die folgenden Schritte aus:

Voraussetzungen

Erstellen eines Testsuite-Verzeichnisses

IDT unterteilt Testfälle logisch in Testgruppen innerhalb jeder Testsuite. Jeder Testfall muss sich innerhalb einer Testgruppe befinden. Erstellen Sie für dieses Tutorial einen Ordner mit dem Namen MyTestSuite_1.0.0 und erstellen Sie die folgende Verzeichnisstruktur in diesem Ordner:

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

Erstellen von Konfigurationsdateien

Ihre Testsuite muss die folgenden erforderlichen Konfigurationsdateien enthalten:

Die Verzeichnisstruktur für Ihren MyTestSuite_1.0.0 Ordner sollte jetzt wie folgt aussehen:

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

Abrufen des IDT-Client-SDK

Sie verwenden das IDT-Client-SDK, um es IDT zu ermöglichen, mit dem getesteten Gerät zu interagieren und Testergebnisse zu melden. Für dieses Tutorial verwenden Sie die Python-Version des SDK.

Kopieren Sie den idt_client Ordner aus dem <device-tester-extract-location>/sdks/python/ Ordner in Ihren MyTestSuite_1.0.0/suite/myTestGroup/myTestCase Ordner.

Führen Sie den folgenden Befehl aus, um zu überprüfen, ob das SDK erfolgreich kopiert wurde.

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

Erstellen der ausführbaren Testfall-Datei

Testfall-ausführbare Dateien enthalten die Testlogik, die Sie ausführen möchten. Eine Testsuite kann mehrere ausführbare Testfälle enthalten. Für dieses Tutorial erstellen Sie nur eine ausführbare Testfalldatei.

Konfigurieren von Geräteinformationen für IDT

Konfigurieren Sie Ihre Geräteinformationen für IDT, um den Test auszuführen. Sie müssen die device.json Vorlage im <device-tester-extract-location>/configs Ordner mit den folgenden Informationen aktualisieren.

[
  {
    "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>"
            }
          }
        }
      }
    ]
  }
]

Geben Sie im devices Objekt die folgenden Informationen an:

Ausführen der Testsuite

Nachdem Sie Ihre Testsuite erstellt haben, möchten Sie sicherstellen, dass sie wie erwartet funktioniert. Führen Sie dazu die folgenden Schritte aus, um die Testsuite mit Ihrem vorhandenen Gerätepool auszuführen.

IDT führt Ihre Testsuite aus und streamt die Ergebnisse an die Konsole. Wenn die Ausführung des Tests abgeschlossen ist, sehen Sie die folgenden Informationen:

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

Fehlerbehebung

Verwenden Sie die folgenden Informationen, um Probleme beim Abschließen des Tutorials zu beheben.