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.
Présentation des tests avec start-lambda sam local
Utilisez le AWS SAM CLI sous-commande sam local start-lambda pour appeler votre fonction événementielle Lambda via le AWS CLI et des kits de développement logiciel. Cette commande démarre un point de terminaison local qui émule Lambda.
-
Pour une introduction à la AWS SAM CLI, voir Qu'est-ce que AWS SAM INTERFACE DE LIGNE DE COMMANDE (CLI)?
-
Pour obtenir la liste des options de commande
sam local start-lambda, consultez start-lambda sam local.
Le point de terminaison local exécute le code de fonction sur votre machine, et non dans le service Lambda. Pour isoler le code non fiable de votre environnement local, invoquez-le dans le service Lambda.
sam local start-lambda prend en charge des fonctions durables avec des fonctions de contrôle et de relecture automatiques. Les fonctions durables fonctionnent parfaitement avec le terminal Lambda local.
Pour utiliser sam local start-lambda, installez la CLI AWS SAM en procédant comme suit :
Avant d'utiliser sam local start-lambda, nous vous recommandons d'avoir des connaissances de base sur les points suivants :
Utilisation de sam local start-lambda
Lorsque vous utilisez sam local start-lambda, la CLI AWS SAM suppose que le répertoire de travail actuel est le répertoire racine du projet. La CLI AWS SAM recherche d'abord un fichier template.[yaml|yml] dans un sous-dossier .aws-sam. Si elle ne le trouve pas, la CLI AWS SAM recherche un fichier template.[yaml|yml] dans votre répertoire de travail actuel.
Pour utiliser sam local start-lambda
-
À partir du répertoire racine de votre projet, effectuez les actions suivantes :
$sam local start-lambda<options> -
La CLI AWS SAM crée vos fonctions Lambda dans un conteneur Docker local. Elle transmet ensuite l'adresse locale au point de terminaison de votre serveur HTTP. Voici un exemple :
$sam local start-lambdaInitializing the lambda functions containers. Local image is up-to-date Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64. Mounting /Users/.../sam-app/hello_world as /var/task:ro,delegated, inside runtime container Containers Initialization is done. Starting the Local Lambda Service. You can now invoke your Lambda Functions defined in your template through the endpoint. 2023-04-13 07:25:43 WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead. * Running on http://127.0.0.1:3001 2023-04-13 07:25:43 Press CTRL+C to quit -
Utilisez le AWS CLI ou des kits SDK pour invoquer votre fonction Lambda localement.
Voici un exemple avec utilisation de la AWS CLI :
$aws lambda invoke --function-nameStatusCode: 200 (END)"HelloWorldFunction"--endpoint-url"http://127.0.0.1:3001"--no-verify-ssl out.txtVoici un exemple utilisant le AWS SDK pour Python:
import boto3 from botocore.config import Config from botocore import UNSIGNED lambda_client = boto3.client('lambda', endpoint_url="http://127.0.0.1:3001", use_ssl=False, verify=False, config=Config(signature_version=UNSIGNED, read_timeout=1, retries={'max_attempts': 0} ) ) lambda_client.invoke(FunctionName="HelloWorldFunction")
Options
Spécifier un modèle
Pour spécifier un modèle à référencer par la CLI AWS SAM, utilisez l'option --template. Le AWS SAM CLI chargera juste ça AWS SAM modèle et les ressources vers lesquelles il pointe. Voici un exemple :
$sam local start-lambda --templatemyTemplate.yaml
Pour plus d'informations sur AWS SAM modèles, voir AWS SAM anatomie du modèle.
Bonnes pratiques
Si votre application possède un répertoire .aws-sam qui exécute sam build, assurez-vous d'exécuter sam build chaque fois que vous mettez à jour le code de votre fonction. Exécutez ensuite sam local start-lambda pour tester localement votre code de fonction mis à jour.
Les tests locaux constituent une excellente solution pour un développement et des tests rapides avant le déploiement dans le cloud. Toutefois, les tests locaux ne valident pas tout, notamment les autorisations entre vos ressources dans le cloud. Dans la mesure du possible, testez vos applications dans le cloud. Nous vous recommandons d'utiliser sam sync pour accélérer vos flux de travail de test dans le cloud.
En savoir plus
Pour obtenir la liste de toutes les options sam local start-lambda, consultez start-lambda sam local.