test-e2e - AWS IoT Greengrass
initbuildrun

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.

test-e2e

Utilisez la test-e2e commande de l'interface de ligne de commande du kit de AWS IoT Greengrass développement (CLI GDK) pour initialiser, créer et end-to-end exécuter des modules de test dans le projet GDK.

Sous-commandes

init

Initialisez un projet GDK CLI existant avec un module de test qui utilise Greengrass Testing Framework (GTF).

Par défaut, la CLI GDK récupère le modèle de module maven depuis le référentiel de modèles de AWS IoT Greengrass composants sur. GitHub Ce module maven est livré avec une dépendance au fichier aws-greengrass-testing-standalone JAR.

Cette commande crée un nouveau répertoire appelé gg-e2e-tests inside of the GDK project. Si le répertoire du module de test existe déjà et qu'il n'est pas vide, la commande s'arrête sans rien faire. Ce gg-e2e-tests dossier contient la fonctionnalité Cucumber et les définitions d'étapes structurées dans un projet Maven.

Par défaut, cette commande essaie d'utiliser la dernière version de GTF.

Résumé
$ gdk test-e2e init
    [--gtf-version]
Arguments

  • -ov, --gtf-version — (Facultatif) Version du GTF à utiliser avec le module de end-to-end test dans le projet GDK. Cette valeur doit être l'une des versions GTF des versions. Cet argument remplace celui de la configuration gtf_version de la CLI GDK.

Sortie

L'exemple suivant montre le résultat produit lorsque vous exécutez cette commande pour initialiser le projet GDK avec le module de test.

$ gdk test-e2e init
[2023-12-06 12:20:28] INFO - Using the GTF version provided in the GDK test config 1.2.0
[2023-12-06 12:20:28] INFO - Downloading the E2E testing template from GitHub into gg-e2e-tests directory...

build

Note

Vous devez créer le composant en l'exécutant gdk component build avant de créer le module de end-to-end test.

Créez le module end-to-end de test. La CLI GDK crée le module de test à l'aide du système de génération que vous spécifiez dans le fichier de configuration de la CLI GDKgdk-config.json, sous la test-e2e propriété. Vous devez exécuter cette commande dans le dossier où se trouve le gdk-config.json fichier.

Par défaut, la CLI GDK utilise le système de construction maven pour créer le module de test. Maven est requis pour exécuter la gdk test-e2e build commande.

Vous devez créer le composant en l'exécutant gdk-component-build avant de créer le module de test, si les fichiers de fonctionnalités de test contiennent des variables telles que GDK_COMPONENT_NAME et GDK_COMPONENT_RECIPE_FILE à interpoler.

Lorsque vous exécutez cette commande, la CLI GDK interpole toutes les variables de la configuration du projet GDK et crée le gg-e2e-tests module pour générer le fichier JAR de test final.

Résumé
$ gdk test-e2e build
Arguments

Aucun

Sortie

L'exemple suivant montre le résultat produit lorsque vous exécutez cette commande.

$ gdk test-e2e build
[2023-07-20 15:36:48] INFO - Updating feature file: file:///path/to//HelloWorld/greengrass-build/gg-e2e-tests/src/main/resources/greengrass/features/component.feature
[2023-07-20 15:36:48] INFO - Creating the E2E testing recipe file:///path/to/HelloWorld/greengrass-build/recipes/e2e_test_recipe.yaml
[2023-07-20 15:36:48] INFO - Building the E2E testing module
[2023-07-20 15:36:48] INFO - Running the build command 'mvn package'
.........

run

Exécutez le module de test avec les options de test du fichier de configuration GDK.

Note

Vous devez créer le module de test en l'exécutant gdk test-e2e build avant d'exécuter les end-to-end tests.

Résumé
$ gdk test-e2e run
    [--gtf-options]
Arguments

  • -oo, --gtf-options — (Facultatif) Spécifiez une liste d'options pour exécuter les end-to-end tests. L'argument doit être une chaîne JSON valide ou un chemin de fichier vers un fichier JSON contenant les options GTF. Les options fournies dans le fichier de configuration sont fusionnées avec celles fournies dans les arguments de commande. Si une option est présente aux deux endroits, celle en argument a priorité sur celle du fichier de configuration.

    Si l'tagsoption n'est pas spécifiée dans cette commande, GDK l'utilise Sample pour les balises. Si ggc-archive ce n'est pas spécifié, GDK télécharge la dernière version de l'archive Greengrass nucleus.

Sortie

L'exemple suivant montre le résultat produit lorsque vous exécutez cette commande.

$ gdk test-e2e run
[2023-07-20 16:35:53] INFO - Downloading latest nucleus archive from url https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-latest.zip
[2023-07-20 16:35:57] INFO - Running test jar with command java -jar /path/to/greengrass-build/gg-e2e-tests/target/uat-features-1.0.0.jar —ggc-archive=/path/to/aws-greengrass-gdk-cli/HelloWorld/greengrass-build/greengrass-nucleus-latest.zip —tags=Sample

16:35:59.693 [] [] [] [INFO] com.aws.greengrass.testing.modules.GreengrassContextModule - Extracting /path/to/workplace/aws-greengrass-gdk-cli/HelloWorld/greengrass-build/greengrass-nucleus-latest.zip into /var/folders/7g/ltzcb_3s77nbtmkzfb6brwv40000gr/T/gg-testing-7718418114158172636/greengrass
16:36:00.534 [gtf-1.1.0-SNAPSHOT] [] [] [INFO] com.aws.greengrass.testing.features.LoggerSteps - GTF Version is gtf-1.1.0-SNAPSHOT
.......