Tutorial: Esegui end-to-end i test utilizzando Greengrass Testing Framework e Greengrass Development Kit

• Inizializza una cartella vuota con un progetto GDK. Scarica il HelloWorld componente implementato in Python eseguendo il seguente comando.

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

  Questo comando crea una nuova directory denominata HelloWorld nella directory corrente.

• GDK consente di scaricare il modello del modulo di test costituito da un'implementazione di funzionalità e fasi. Esegui il comando seguente per aprire la HelloWorld directory e inizializzare il progetto GDK esistente utilizzando un modulo di test.

  cd HelloWorld
  gdk test-e2e init

  Questo comando crea una nuova directory denominata gg-e2e-tests all'interno della HelloWorld directory. Questa directory di test è un progetto Maven che dipende dal JAR standalone di test Greengrass.

1. Crea un file di funzionalità con uno scenario di test

   Una funzionalità descrive in genere una funzionalità specifica del software che viene testato. In Cucumber, ogni funzionalità è specificata come un singolo file di funzionalità con un titolo, una descrizione dettagliata e uno o più esempi di casi specifici chiamati scenari. Ogni scenario è composto da un titolo, una descrizione dettagliata e una serie di passaggi che definiscono le interazioni e i risultati attesi. Gli scenari sono scritti in un formato strutturato utilizzando le parole chiave «given», «when» e «then».

2. Implementa le definizioni dei

   Una definizione di fase collega la fase Gherkin in un linguaggio semplice al codice programmatico. Quando Cucumber identifica un passaggio Gherkin in uno scenario, cercherà una definizione di fase corrispondente da eseguire.

• È possibile assegnare tag alle funzionalità e agli scenari per organizzare il processo di test. È possibile utilizzare i tag per classificare i sottoinsiemi di scenari e anche selezionare gli hook in modo condizionale da eseguire. Le funzionalità e gli scenari possono avere più tag separati da uno spazio.

  In questo esempio, stiamo usando il HelloWorld componente.

  Nel file delle funzionalità, aggiungete un nuovo tag denominato @HelloWorld accanto al @Sample tag.

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

1. Costruisci il componente. È necessario creare il componente prima di creare il modulo di test.

   gdk component build

2. Costruite il modulo di test utilizzando il seguente comando. Questo comando creerà il JAR di test nella greengrass-build cartella.

   gdk test-e2e build

Quando esegui un test case personalizzato, GTF automatizza il ciclo di vita del test oltre alla gestione delle risorse create durante il test. Innanzitutto esegue il provisioning di un dispositivo in fase di test (DUT) come dispositivo e installa su di esso il software di base Greengrass. AWS IoT Creerà quindi un nuovo componente denominato HelloWorld utilizzando la ricetta specificata in quel percorso. Il HelloWorld componente viene quindi distribuito sul dispositivo principale tramite una distribuzione di oggetti Greengrass. Verrà quindi verificato se l'implementazione è riuscita. Lo stato di distribuzione verrà modificato COMPLETED entro 3 minuti se la distribuzione ha esito positivo.

1. Vai al gdk-config.json file nella directory del progetto per indirizzare i test con il HelloWorld tag. Aggiorna la test-e2e chiave usando il seguente comando.

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

2. Prima di eseguire i test, è necessario fornire AWS le credenziali al dispositivo host. GTF utilizza queste credenziali per gestire le AWS risorse durante il processo di test. Assicurati che il ruolo che fornisci disponga delle autorizzazioni necessarie per automatizzare le operazioni necessarie incluse nel test.

   Esegui i seguenti comandi per fornire le credenziali. AWS

   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. Eseguite il test utilizzando il seguente comando.

   gdk test-e2e run

   Questo comando scarica l'ultima versione del nucleo Greengrass nella greengrass-build cartella ed esegue i test utilizzandola. Questo comando si rivolge inoltre solo agli scenari con il HelloWorld tag e genera un report per tali scenari. Vedrai che le AWS risorse create durante questo test vengono scartate alla fine del test.