Tutorial: Verwenden Sie einen Konfidenztest aus der Konfidenztestsuite

• Initialisieren Sie einen leeren Ordner mit einem GDK-Projekt. Laden Sie die in Python implementierte HelloWorld Komponente herunter, indem Sie den folgenden Befehl ausführen.

  gdk component init -t HelloWorld -l python -n HelloWorld

  Dieser Befehl erstellt ein neues Verzeichnis mit dem Namen HelloWorld im aktuellen Verzeichnis.

• Mit GDK können Sie die Testmodulvorlage herunterladen, die aus einer Feature- und Schrittimplementierung besteht. Führen Sie den folgenden Befehl aus, um das HelloWorld Verzeichnis zu öffnen und das vorhandene GDK-Projekt mit einem Testmodul zu initialisieren.

  cd HelloWorld
  gdk test-e2e init

  Dieser Befehl erstellt ein neues Verzeichnis mit dem Namen gg-e2e-tests innerhalb des HelloWorld Verzeichnisses . Dieses Testverzeichnis ist ein Maven-Projekt, das von der eigenständigen Greengrass-Test-JAR abhängig ist.

• Verwenden Sie die bereitgestellte Feature-Datei.

  Navigieren Sie zum gg-e2e-tests/src/main/resources/greengrass/features Ordner im aktuellen Verzeichnis. Öffnen Sie die confidenceTest.feature Beispieldatei, um den Zuverlässigkeitstest zu verwenden.

• Sie können den Funktionen und Szenarien Tags zuweisen, um den Testprozess zu organisieren. Sie können Tags verwenden, um die Teilmengen von Szenarien zu kategorisieren und auch Hooks bedingt für die Ausführung auszuwählen. Funktionen und Szenarien können mehrere Tags haben, die durch ein Leerzeichen getrennt sind.

  In diesem Beispiel verwenden wir die -HelloWorldKomponente.

  Jedes Szenario ist mit gekennzeichnet@ConfidenceTest. Ändern oder fügen Sie Tags hinzu, wenn Sie nur eine Teilmenge der Testsuite ausführen möchten. Jedes Testszenario wird oben in jedem Zuverlässigkeitstest beschrieben. Das Szenario besteht aus einer Reihe von Schritten, die dabei helfen, die Interaktionen und die erwarteten Ergebnisse jedes Testfalls zu verstehen. Sie können diese Tests erweitern, indem Sie Ihre eigenen Schritte hinzufügen oder die vorhandenen ändern.

  @ConfidenceTest
  Scenario: As a Developer, I can deploy GDK_COMPONENT_NAME to my device and see it is working as expected
  ....

1. Erstellen Sie die Komponente. Sie müssen die Komponente erstellen, bevor Sie das Testmodul erstellen.

   gdk component build

2. Erstellen Sie das Testmodul mit dem folgenden Befehl. Mit diesem Befehl wird das Test-JAR im greengrass-build Ordner erstellt.

   gdk test-e2e build

Wenn Sie einen Zuverlässigkeitstest durchführen, automatisiert die GTF den Lebenszyklus des Tests sowie die Verwaltung von Ressourcen, die während des Tests erstellt wurden. Es stellt zunächst ein getestetes Gerät (DUT) als -AWS IoTObjekt bereit und installiert darauf die Greengrass-Core-Software. Anschließend wird eine neue Komponente mit dem Namen unter HelloWorld Verwendung des in diesem Pfad angegebenen Rezepts erstellt. Die HelloWorld Komponente wird dann über eine Greengrass-Objektbereitstellung auf dem Core-Gerät bereitgestellt. Sie wird dann überprüft, wenn die Bereitstellung erfolgreich ist. Der Bereitstellungsstatus ändert sich COMPLETED innerhalb von 3 Minuten in , wenn die Bereitstellung erfolgreich ist.

1. Gehen Sie zur gdk-config.json Datei im Projektverzeichnis, um die Tests mit dem ConfidenceTest Tag oder dem in Schritt 4 angegebenen Tag io8u abzuzielen. Aktualisieren Sie den test-e2e Schlüssel mit dem folgenden Befehl.

     "test-e2e":{
       "gtf_options" : { 
            "tags":"ConfidenceTest"
        }
     }

2. Bevor Sie die Tests ausführen, müssen Sie dem Host-Gerät AWS Anmeldeinformationen bereitstellen. GTF verwendet diese Anmeldeinformationen, um die AWS Ressourcen während des Testprozesses zu verwalten. Stellen Sie sicher, dass die von Ihnen bereitgestellte Rolle über Berechtigungen zur Automatisierung der erforderlichen Operationen verfügt, die im Test enthalten sind.

   Führen Sie die folgenden Befehle aus, um die AWS Anmeldeinformationen bereitzustellen.

   1. Linux or Unix

      export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
      export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

      Windows Command Prompt (CMD)

      set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
      set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

      PowerShell

      $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
      $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"

3. Führen Sie den Test mit dem folgenden Befehl aus.

   gdk test-e2e run

   Dieser Befehl lädt die neueste Version des Greengrass-Kerns im greengrass-build Ordner herunter und führt Tests mit diesem aus. Dieser Befehl zielt auch nur auf die Szenarien mit dem -ConfidenceTestTag ab und generiert einen Bericht für diese Szenarien. Die AWS Ressourcen, die während dieses Tests erstellt wurden, werden am Ende des Tests verworfen.