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.
Invoquez localement les fonctions événementielles Lambda avec AWS SAM
L'appel local d'une fonction d'événement Lambda avant de procéder à un test ou à un déploiement dans le cloud peut présenter de nombreux avantages. Il vous permet de tester la logique de votre fonction plus rapidement. Tester d'abord localement réduit la probabilité d'identifier des problèmes lors des tests dans le cloud ou lors du déploiement, ce qui peut vous aider à éviter des coûts inutiles. De plus, les tests locaux facilitent le débogage.
Vous pouvez appeler votre fonction Lambda localement en utilisant le appel sam local commande et fourniture de l'ID logique de la fonction et d'un fichier d'événements. sam local invoke accepte également stdin en tant qu'événement. Pour plus d’informations sur les événements, consultez Evénement dans le Guide du développeur AWS Lambda . Pour plus d'informations sur les formats de messages d'événements provenant de différents AWS services, voir En utilisant AWS Lambda avec d'autres services dans le AWS Lambda Guide du développeur.
Les appels locaux exécutent le code de fonction dans votre environnement local. Pour le code que vous n'avez pas écrit ou révisé, utilisez le service Lambda, qui l'exécute indépendamment de votre machine.
Le sam local invoke commande correspond à AWS Command Line Interface (AWS CLI) commande aws lambda invoke
Vous devez exécuter la commande sam local invoke dans le répertoire du projet qui contient la fonction que vous voulez appeler.
Exemples :
# Invoking function with event file $ sam local invoke "Ratings" -e event.json # Invoking function with event via stdin $ echo '{"message": "Hey, are you there?" }' | sam local invoke --event - "Ratings" # For more options $ sam local invoke --help
Fichier de variable d'environnement
Pour déclarer localement des variables d'environnement qui remplacent les valeurs définies dans vos modèles, procédez comme suit :
-
Créez un JSON ou
.envfichier contenant les variables d'environnement à remplacer. -
Utilisez l'argument
--env-varspour remplacer les valeurs définies dans vos modèles.
Le --env-vars l'option prend en charge deux formats de fichiers. Le format de fichier est automatiquement détecté en fonction du contenu du fichier.
Déclarer des variables d'environnement avec JSON
Pour déclarer des variables d'environnement qui s'appliquent globalement à toutes les ressources, spécifiez un objet Parameters comme suit :
{ "Parameters": { "TABLE_NAME": "localtable", "BUCKET_NAME": "amzn-s3-demo-bucket", "STAGE": "dev" } }
Pour déclarer des variables d'environnement différentes pour chaque ressource, spécifiez des objets pour chaque ressource comme suit :
{ "MyFunction1": { "TABLE_NAME": "localtable", "BUCKET_NAME": "amzn-s3-demo-bucket", }, "MyFunction2": { "TABLE_NAME": "localtable", "STAGE": "dev" } }
Lorsque vous spécifiez des objets pour chaque ressource, vous pouvez utiliser les identifiants suivants, énumérés dans l'ordre de la plus haute à la plus basse priorité :
-
logical_id -
function_id -
function_name -
Identifiant de chemin complet
Vous pouvez utiliser les deux méthodes précédentes de déclaration des variables d'environnement dans un seul fichier. Ce faisant, les variables d'environnement que vous avez fournies pour des ressources spécifiques ont la priorité sur les variables d'environnement globales.
Enregistrez vos variables d'environnement dans un fichier JSON, tel que env.json.
Déclarer des variables d'environnement avec des fichiers .env
Vous pouvez également utiliser un .env fichier pour déclarer les variables d'environnement. Variables déclarées dans un .env fichier s'applique globalement à toutes les fonctions, équivalent au Parameters objet au format JSON.
TABLE_NAME=localtable BUCKET_NAME=amzn-s3-demo-bucket STAGE=dev
Le .env le format prend en charge les commentaires (lignes commençant par #) et valeurs citées.
Le .env le format ne prend en charge que les variables d'environnement globales. Pour déclarer des variables d'environnement spécifiques à une fonction, utilisez le format JSON.
Remplacement des valeurs des variables d'environnement
Pour remplacer les variables d'environnement par celles définies dans votre fichier de variables d'environnement, utilisez le --env-vars dispute avec invoke ou start-api commandes. Par exemple :
# Using a JSON file sam local invoke --env-vars env.json # Using a .env file sam local invoke --env-vars .env
Layers
Si votre application comporte des couches, pour plus d'informations sur la façon de déboguer les problèmes liés aux couches sur votre hôte local, consultez Améliorez l'efficacité en utilisant les couches Lambda avec AWS SAM.
En savoir plus
Pour un exemple pratique d'appel de fonctions localement, voir Module 2 - Exécuter localement