Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Einführung in das Testen mit gleicher lokaler Aufruf
Benutze den AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAM CLI) sam local invoke Unterbefehl zum Initiieren eines einmaligen Aufrufs eines AWS Lambda Event-Funktion lokal.
-
Für eine Einführung in die AWS SAM CLI, siehe Was ist der AWS SAM CLI?
-
Für eine Liste von
sam local invokeBefehlsoptionen finden Sie unter gleicher lokaler Aufruf. -
Als Beispiel für die Verwendung
sam local invokewährend eines typischen Entwicklungsablaufs finden Sie unter Schritt 7: (Optional) Testen Sie Ihre Anwendung lokal.
sam local invoke führt Funktionscode mit Zugriff auf Ihre lokale Umgebung aus. Rufen Sie Code aus einer unbekannten Quelle im Lambda-Service auf, wodurch er von Ihrem Computer isoliert wird.
sam local invoke unterstützt langlebige Funktionen mit automatischen Checkpointing- und Wiedergabefunktionen. Beim lokalen Aufrufen dauerhafter Funktionen wird der Ausführungsstatus automatisch verwaltet.
Zu verwenden sam local invoke, installieren Sie den AWS SAM CLI indem Sie Folgendes ausfüllen:
Vor der Verwendung sam local invoke, wir empfehlen ein grundlegendes Verständnis der folgenden Aspekte:
Rufen Sie lokal eine Lambda-Ereignisfunktion auf
Wenn du rennst sam local invoke, der AWS SAM CLI geht davon aus, dass Ihr aktuelles Arbeitsverzeichnis das Stammverzeichnis Ihres Projekts ist. Das AWS SAM CLI werde zuerst nach einem suchen template.[yaml|yml] Datei innerhalb einer .aws-sam Unterordner. Wenn nicht gefunden, der AWS SAM CLI werde nach einem suchen template.[yaml|yml] Datei in Ihrem aktuellen Arbeitsverzeichnis.
Um eine Lambda-Event-Funktion lokal aufzurufen
-
Führen Sie im Stammverzeichnis Ihres Projekts Folgendes aus:
$sam local invoke<options> -
Wenn Ihre Anwendung mehr als eine Funktion enthält, geben Sie die logische ID der Funktion an. Im Folgenden wird ein Beispiel gezeigt:
$sam local invokeHelloWorldFunction -
Die AWS SAM CLI erstellt Ihre Funktion in einem lokalen Container mit Docker. Es ruft dann Ihre Funktion auf und gibt die Antwort Ihrer Funktion aus.
Im Folgenden wird ein Beispiel gezeigt:
$sam local invokeInvoking app.lambda_handler (python3.9) Local image is out of date and will be updated to the latest runtime. To skip this, pass in the parameter --skip-pull-image Building image.................................................................................................................... Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64. Mounting /Users/.../sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container START RequestId: 64bf7e54-5509-4762-a97c-3d740498d3df Version: $LATEST END RequestId: 64bf7e54-5509-4762-a97c-3d740498d3df REPORT RequestId: 64bf7e54-5509-4762-a97c-3d740498d3df Init Duration: 1.09 ms Duration: 608.42 ms Billed Duration: 609 ms Memory Size: 128 MB Max Memory Used: 128 MB {"statusCode": 200, "body": "{\"message\": \"hello world\"}"}%
Verwalten von -Protokollen
Bei der Verwendung sam local invoke, wird die Laufzeitausgabe der Lambda-Funktion (z. B. Protokolle) an ausgegeben stderr, und das Ergebnis der Lambda-Funktion wird ausgegeben an stdout.
Das Folgende ist ein Beispiel für eine grundlegende Lambda-Funktion:
def handler(event, context): print("some log") # this goes to stderr return "hello world" # this goes to stdout
Sie können diese Standardausgaben speichern. Im Folgenden wird ein Beispiel gezeigt:
$sam local invoke 1> stdout.log...$cat stdout.log"hello world"$sam local invoke 2> stderr.log...$cat stderr.logInvoking app.lambda_handler (python3.9) Local image is up-to-date Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64. Mounting /Users/.../sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container START RequestId: 0b46e646-3bdf-4b58-8beb-242d00912c46 Version: $LATEST some log END RequestId: 0b46e646-3bdf-4b58-8beb-242d00912c46 REPORT RequestId: 0b46e646-3bdf-4b58-8beb-242d00912c46 Init Duration: 0.91 ms Duration: 589.19 ms Billed Duration: 590 ms Memory Size: 128 MB Max Memory Used: 128 MB
Sie können diese Standardausgaben verwenden, um Ihre lokalen Entwicklungsprozesse weiter zu automatisieren.
Optionen
Übergeben Sie benutzerdefinierte Ereignisse, um die Lambda-Ereignisfunktion aufzurufen
Um ein Ereignis an die Lambda-Funktion zu übergeben, verwenden Sie --event Option. Im Folgenden wird ein Beispiel gezeigt:
$sam local invoke --eventevents/s3.json S3JsonLoggerFunction
Sie können Ereignisse mit dem erstellen sam local generate-event Unterbefehl. Weitere Informationen hierzu finden Sie unter Einführung in das Testen mit gleiches lokales Generate-Event.
Übergeben Sie Umgebungsvariablen, wenn Sie Ihre Lambda-Event-Funktion aufrufen
Wenn Ihre Lambda-Funktion Umgebungsvariablen verwendet, können Sie diese beim lokalen Testen mit dem übergeben --env-vars Option. Dies ist eine hervorragende Möglichkeit, eine Lambda-Funktion lokal mit Diensten in Ihrer Anwendung zu testen, die bereits in der Cloud bereitgestellt werden. Im Folgenden wird ein Beispiel gezeigt:
$sam local invoke --env-varslocals.json
Geben Sie eine Vorlage oder Funktion an
Um eine Vorlage für den anzugeben AWS SAM CLI um zu referenzieren, verwenden Sie den --template Option. Die AWS SAM CLI wird genau das laden AWS SAM Vorlage und die Ressourcen, auf die sie verweist.
Um eine Funktion einer verschachtelten Anwendung oder eines Stapels aufzurufen, geben Sie die logische ID der Anwendung oder des Stapels zusammen mit der logischen ID der Funktion an. Im Folgenden wird ein Beispiel gezeigt:
$sam local invokeStackLogicalId/FunctionLogicalId
Testen Sie eine Lambda-Event-Funktion von Ihrem Terraform project
Benutze das --hook-name Option zum lokalen Testen von Lambda-Funktionen von Ihrem Terraform Projekte. Weitere Informationen hierzu finden Sie unter Verwendung der AWS SAM CLI mit Terraform zum lokalen Debuggen und Testen.
Im Folgenden wird ein Beispiel gezeigt:
$sam local invoke --hook-name terraform --beta-features
Bewährte Methoden
Wenn Ihre Bewerbung eine hat .aws-sam Verzeichnis wird nicht ausgeführt sam build, achte darauf, dass du rennst sam build jedes Mal, wenn Sie Ihren Funktionscode aktualisieren. Dann lauf sam local invoke um Ihren aktualisierten Funktionscode lokal zu testen.
Lokales Testen ist eine hervorragende Lösung für schnelles Entwickeln und Testen vor der Bereitstellung in der Cloud. Lokale Tests validieren jedoch nicht alles, wie z. B. die Berechtigungen zwischen Ihren Ressourcen in der Cloud. Testen Sie Ihre Anwendungen so oft wie möglich in der Cloud. Wir empfehlen unter Verwendung von sam sync um Ihre Cloud-Test-Workflows zu beschleunigen.
Beispiele
Generieren Sie ein Amazon API Gateway-Beispielereignis und verwenden Sie es, um lokal eine Lambda-Ereignisfunktion aufzurufen
Zuerst generieren wir eine API-Gateway-HTTP-API-Event-Nutzlast und speichern sie in unserem events Ordner.
$sam local generate-eventapigateway http-api-proxy > events/apigateway_event.json
Als Nächstes ändern wir unsere Lambda-Funktion, um einen Parameterwert aus dem Ereignis zurückzugeben.
def lambda_handler(event, context): print("HelloWorldFunction invoked") return { "statusCode": 200, "body": json.dumps({ "message": event['queryStringParameters']['parameter2'], }), }
Als Nächstes rufen wir unsere Lambda-Funktion lokal auf und stellen unser benutzerdefiniertes Ereignis bereit.
$sam local invoke --eventInvoking app.lambda_handler (python3.9) Local image is up-to-date Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64. Mounting /Users/...sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container START RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 Version: $LATEST some log END RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 REPORT RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 Init Duration: 1.63 ms Duration: 564.07 ms Billed Duration: 565 ms Memory Size: 128 MB Max Memory Used: 128 MB {"statusCode": 200, "body": "{\"message\": \"value\"}"}%events/apigateway_event.json
Übergeben Sie Umgebungsvariablen, wenn Sie eine Lambda-Event-Funktion lokal aufrufen
Diese Anwendung verfügt über eine Lambda-Funktion, die eine Umgebungsvariable für einen Amazon DynamoDB-Tabellennamen verwendet. Das Folgende ist ein Beispiel für die Funktion, die in der definiert ist AWS SAM Vorlage:
AWSTemplateFormatVersion: 2010-09-09 Transform: AWS::Serverless-2016-10-31 ... Resources: getAllItemsFunction: Type: AWS::Serverless::Function Properties: Handler: src/get-all-items.getAllItemsHandler Description: get all items Policies: - DynamoDBReadPolicy: TableName: !Ref SampleTable Environment: Variables: SAMPLE_TABLE: !Ref SampleTable ...
Wir möchten unsere Lambda-Funktion lokal testen und sie gleichzeitig mit unserer DynamoDB-Tabelle in der Cloud interagieren lassen. Dazu erstellen wir unsere Umgebungsvariablendatei und speichern sie im Stammverzeichnis unseres Projekts unter locals.json. Der hier angegebene Wert für SAMPLE_TABLE verweist auf unsere DynamoDB-Tabelle in der Cloud.
{ "getAllItemsFunction": { "SAMPLE_TABLE": "dev-demo-SampleTable-1U991234LD5UM98" } }
Als nächstes laufen wir sam local invoke und übergeben unsere Umgebungsvariablen mit --env-vars Option.
$sam local invokeMounting /Users/...sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container START RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 Version: $LATEST some log END RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 REPORT RequestId: 59535d0d-3d9e-493d-8c98-6264e8e961b8 Init Duration: 1.63 ms Duration: 564.07 ms Billed Duration: 565 ms Memory Size: 128 MB Max Memory Used: 128 MB {"statusCode":200,"body":"{}"}getAllItemsFunction--env-varslocals.json
Weitere Informationen
Für eine Liste von allen sam local invoke Optionen finden Sie unter gleicher lokaler Aufruf.
Für eine Demo der Verwendung sam local, siehe AWS SAM für die lokale Entwicklung. Testen AWS Cloud Ressourcen aus lokalen Entwicklungsumgebungen