Tutorial: Führen Sie end-to-end Tests mit dem Greengrass Testing Framework und dem Greengrass Development Kit durch

• 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 Vorlage für das Testmodul herunterladen, die aus einer Funktion und einer schrittweisen Implementierung besteht. Führen Sie den folgenden Befehl aus, um das HelloWorld Verzeichnis zu öffnen und das vorhandene GDK-Projekt mithilfe eines Testmoduls 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-Testing-JAR abhängig ist.

1. Erstellen Sie eine Feature-Datei mit einem Testszenario

   Ein Feature beschreibt in der Regel eine bestimmte Funktionalität der Software, die getestet wird. In Cucumber wird jedes Feature als einzelne Feature-Datei mit einem Titel, einer detaillierten Beschreibung und einem oder mehreren Beispielen für bestimmte Fälle, die als Szenarien bezeichnet werden, spezifiziert. Jedes Szenario besteht aus einem Titel, einer detaillierten Beschreibung und einer Reihe von Schritten, die die Interaktionen und erwarteten Ergebnisse definieren. Szenarien werden in einem strukturierten Format mit den Schlüsselwörtern „gegeben“, „wann“ und „dann“ geschrieben.

2. Implementieren Sie Schrittdefinitionen

   Eine Schrittdefinition verknüpft den Gherkin-Schritt im Klartext mit dem Programmcode. Wenn Cucumber in einem Szenario einen Gherkin-Schritt identifiziert, sucht es nach einer passenden Schrittdefinition, die ausgeführt werden kann.

• 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 Hooks auch unter bestimmten Bedingungen auszuführen. Features und Szenarien können mehrere durch ein Leerzeichen getrennte Tags haben.

  In diesem Beispiel verwenden wir die HelloWorld Komponente.

  Fügen Sie in der Feature-Datei ein neues Tag mit dem Namen @HelloWorld neben dem @Sample Tag hinzu.

  @Sample @HelloWorld
  Scenario: As a developer, I can create a component and deploy it on my device
  ....

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. Dieser Befehl erstellt die Test-JAR im greengrass-build Ordner.

   gdk test-e2e build

Wenn Sie einen benutzerdefinierten Testfall ausführen, automatisiert GTF den Lebenszyklus des Tests sowie die Verwaltung der Ressourcen, die während des Tests erstellt wurden. Es stellt zunächst ein zu testendes Gerät (DUT) als AWS IoT Ding bereit und installiert die Greengrass-Kernsoftware darauf. Anschließend wird eine neue Komponente erstellt, die nach dem in diesem Pfad angegebenen Rezept benannt HelloWorld wird. Die HelloWorld Komponente wird dann über eine Greengrass-Dingbereitstellung auf dem Kerngerät bereitgestellt. Anschließend wird überprüft, ob die Bereitstellung erfolgreich ist. Der Bereitstellungsstatus wird COMPLETED innerhalb von 3 Minuten auf einen Wert geändert, wenn die Bereitstellung erfolgreich ist.

1. Gehen Sie zu der gdk-config.json Datei im Projektverzeichnis, um die Tests mit dem HelloWorld Tag als Ziel festzulegen. Aktualisieren Sie den test-e2e Schlüssel mit dem folgenden Befehl.

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

2. Bevor Sie die Tests ausführen, müssen Sie AWS Anmeldeinformationen für das Hostgerät angeben. GTF verwendet diese Anmeldeinformationen, um die AWS Ressourcen während des Testprozesses zu verwalten. Stellen Sie sicher, dass die von Ihnen angegebene Rolle über die erforderlichen Berechtigungen verfügt, um die im Test enthaltenen erforderlichen Vorgänge zu automatisieren.

   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"

      anchoranchoranchor
      • Linux or Unix
      • Windows Command Prompt (CMD)
      • PowerShell

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

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

   gdk test-e2e run

   Mit diesem Befehl wird die neueste Version von Greengrass Nucleus in den greengrass-build Ordner heruntergeladen und Tests damit ausgeführt. Dieser Befehl zielt auch nur auf die Szenarien ab, die mit dem HelloWorld Tag gekennzeichnet sind, und generiert einen Bericht für diese Szenarien. Sie werden sehen, dass die AWS Ressourcen, die während dieses Tests erstellt wurden, am Ende des Tests verworfen werden.