Présentation des tests dans le cloud avec sam remote test-event

Utilisez la AWS Serverless Application Model commande Command Line Interface (AWS SAM CLI) sam remote test-event pour accéder aux événements de test partageables pour vos AWS Lambda fonctions et les gérer.

Pour en savoir plus sur les événements de test partageables, consultez la rubrique relative aux événements de test partageables dans le Guide du développeur AWS Lambda .

Prérequis

Pour utiliser sam remote test-event, installez la CLI AWS SAM en procédant comme suit :

• AWS SAM prérequis.

• Installer la CLI  AWS SAM.

Si vous l'avez déjà AWS SAM CLI installé, nous vous recommandons de passer à la dernière version de la AWS SAMCLI version. Pour en savoir plus, veuillez consulter la section Mise à niveau de la CLI  AWS SAM en cours.

Avant d'utiliser sam remote test-event, nous vous recommandons d'avoir des connaissances de base sur les points suivants :

• Configuration de la CLI  AWS SAM.

• Créez votre application à l'aide de la sam init commande.

• Présentation de la construction avec la sam build commande.

• Présentation du déploiement à l'aide de la sam deploy commande.

• Présentation de l'utilisation sam sync de la synchronisation avec AWS Cloud.

Configurer l'CLIAWS SAM pour utiliser sam remote test-event

Effectuez les étapes de configuration suivantes pour utiliser la AWS SAM CLI sam remote test-event commande :

1. Configurez le AWS SAM CLI pour utiliser votre Compte AWS — Les événements de test partageables pour Lambda sont accessibles et gérés par les utilisateurs de Lambda. Compte AWS Pour configurer le AWS SAM CLI afin d'utiliser votre Compte AWS, voirConfiguration de la CLI  AWS SAM.

2. Configurer les autorisations pour les événements de test partageables – Pour accéder aux événements de test partageables et les gérer, vous devez disposer des autorisations appropriées. Pour en savoir plus, consultez la rubrique relative aux événements de test partageables dans le Guide du développeur AWS Lambda .

Utilisation de la commande sam remote test-event

La AWS SAM CLI sam remote test-event commande fournit les sous-commandes suivantes que vous pouvez utiliser pour accéder à vos événements de test partageables et les gérer :

• delete— Supprime un événement de test partageable du registre des EventBridge schémas Amazon.

• get— Obtenez un événement de test partageable depuis le registre des EventBridge schémas.

• list— Répertorie les événements de test partageables existants pour une fonction dans le registre des EventBridge schémas.

• put— Enregistrez un événement depuis un fichier local dans le registre des EventBridge schémas.

Pour répertorier ces sous-commandes à l'aide du AWS SAM CLI, exécutez ce qui suit :

$ sam remote test-event --help

Suppression d'événements de test partageables

Vous pouvez supprimer un événement de test partageable à l'aide de la sous-commande delete et en indiquant :

• le nom de l'événement de test partageable à supprimer ;

• un ID acceptable pour la fonction Lambda associée à l'événement ;

• Si vous fournissez l'ID logique de la fonction Lambda, vous devez également fournir le nom de AWS CloudFormation pile associé à la fonction Lambda.

Voici un exemple :

$ sam remote test-event delete HelloWorldFunction --stack-name sam-app --name demo-event

Pour obtenir la liste des options à utiliser avec la sous-commande delete, consultez sam remote test-event delete. Vous pouvez également exécuter les opérations suivantes depuis AWS SAM CLI :

$ sam remote test-event delete --help

Obtention d'événements de test partageables

Vous pouvez obtenir un événement de test partageable à partir du registre des EventBridge schémas en utilisant la get sous-commande associée à ce qui suit :

• le nom de l'événement de test partageable à obtenir ;

• un ID acceptable pour la fonction Lambda associée à l'événement ;

• Si vous fournissez l'ID logique de la fonction Lambda, vous devez également fournir le nom de AWS CloudFormation pile associé à la fonction Lambda.

Voici un exemple qui permet d'obtenir un événement de test partageable nommé demo-event qui est associé à la fonction Lambda HelloWorldFunction de la pile sam-app. Cette commande imprime l'événement sur votre console.

$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event

Pour obtenir un événement de test partageable et l'enregistrer sur votre machine locale, utilisez l'option --output-file et fournissez un chemin et un nom de fichier. Voici un exemple d'enregistrement de demo-event.json comme demo-event dans le répertoire de travail actuel :

$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

Pour obtenir la liste des options à utiliser avec la sous-commande get, consultez sam remote test-event get. Vous pouvez également exécuter les opérations suivantes depuis AWS SAM CLI :

$ sam remote test-event get --help

Liste d'événements de test partageables

Vous pouvez répertorier tous les événements de test partageables pour une fonction Lambda spécifique à partir du registre de schémas. Utilisez la sous-commande list en indiquant :

• un ID acceptable pour la fonction Lambda associée aux événements ;

• Si vous fournissez l'ID logique de la fonction Lambda, vous devez également fournir le nom de AWS CloudFormation pile associé à la fonction Lambda.

Voici un exemple qui permet d'obtenir une liste de tous les événements de test partageables associés à la fonction Lambda HelloWorldFunction de la pile sam-app :

$ sam remote test-event list HelloWorldFunction --stack-name sam-app

Pour obtenir la liste des options à utiliser avec la sous-commande list, consultez sam remote test-event list. Vous pouvez également exécuter les opérations suivantes depuis AWS SAM CLI :

$ sam remote test-event list --help

Enregistrement d'événements de test partageables

Vous pouvez enregistrer des événements de test partageables dans le registre des EventBridge schémas. Utilisez la sous-commande put en indiquant :

• un ID acceptable pour la fonction Lambda associée à l'événement de test partageable ;

• un nom d'événement de test partageable ;

• le chemin du fichier et le nom de l'événement local à charger.

Voici un exemple qui enregistre l'événement local demo-event.json comme demo-event et qui l'associe à la fonction Lambda HelloWorldFunction de la pile sam-app :

$ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json

Si un événement de test partageable portant le même nom existe dans le registre du EventBridge schéma, il ne le AWS SAM CLI remplacera pas. Pour le remplacer, ajoutez l'option --force à votre commande.

Pour obtenir la liste des options à utiliser avec la sous-commande put, consultez sam remote test-event put. Vous pouvez également exécuter les opérations suivantes depuis AWS SAM CLI :

$ sam remote test-event put --help

Utilisation des événements de test partageables

Utilisez des événements de test partageables pour tester vos fonctions Lambda dans AWS Cloud la commande. sam remote invoke Pour en savoir plus, veuillez consulter la section Transmettre des événements de test partageables à une fonction Lambda dans le cloud.

Gestion des événements de test partageables

Cette rubrique contient des exemples de gestion et d'utilisation d'événements de test partageables.

Obtenir un événement de test partageable, le modifier et l'utiliser

Vous pouvez obtenir un événement de test partageable depuis le registre des EventBridge schémas, le modifier localement et utiliser l'événement de test local avec votre fonction Lambda dans le. AWS Cloud Voici un exemple :

1. Récupérer l'événement de test partageable – Utilisez la sous-commande sam remote test-event get pour récupérer un événement de test partageable pour une fonction Lambda spécifique et l’enregistrer localement :

   $ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

2. Modifier l'événement de test partageable – Utilisez l'éditeur de texte de votre choix pour modifier l'événement de test partageable.

3. Utiliser l'événement de test partageable – Utilisez la commande sam remote invoke et indiquez le chemin et le nom du fichier de l'événement avec --event-file :

   $ sam remote invoke HelloWorldFunction --stack-name sam-app --event-file demo-event.json

Obtenir un événement de test partageable, le modifier, le charger et l'utiliser

Vous pouvez obtenir un événement de test partageable à partir du registre des EventBridge schémas, le modifier localement et le télécharger. Vous pouvez ensuite transmettre l'événement de test partageable directement à votre fonction Lambda dans l' AWS Cloud. Voici un exemple :

1. Récupérer l'événement de test partageable – Utilisez la sous-commande sam remote test-event get pour récupérer un événement de test partageable pour une fonction Lambda spécifique et l’enregistrer localement :

   $ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

2. Modifier l'événement de test partageable – Utilisez l'éditeur de texte de votre choix pour modifier l'événement de test partageable.

3. Télécharger l'événement de test partageable : utilisez la sam remote test-event put sous-commande pour télécharger et enregistrer l'événement de test partageable dans le registre du EventBridge schéma. Dans cet exemple, nous utilisons l'option --force pour remplacer une ancienne version de notre test partageable :

   $ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json --force

4. Transmettre l'événement de test partageable à votre fonction Lambda – Utilisez la commande sam remote invoke pour transmettre l'événement de test partageable directement à votre fonction Lambda dans l' AWS Cloud :

   $ sam remote invoke HelloWorldFunction --stack-name sam-app --test-event-name demo-event