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 dieselbe lokale Start-API
Benutze die AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAM CLI) sam local start-api Unterbefehl zum Ausführen Ihres AWS Lambda Event funktioniert lokal und kann über einen lokalen HTTP-Serverhost getestet werden. Diese Art von Test ist hilfreich für Lambda-Funktionen, die von einem Amazon API Gateway-Endpunkt aufgerufen werden.
-
Für eine Einführung in die AWS SAM CLI, siehe Was ist der AWS SAM CLI?
-
Für eine Liste von
sam local start-apiBefehlsoptionen finden Sie unter gleiche lokale Start-API. -
Als Beispiel für die Verwendung
sam local start-apiwährend eines typischen Entwicklungsablaufs finden Sie unter Schritt 7: (Optional) Testen Sie Ihre Anwendung lokal.
Der lokale HTTP-Server führt Ihren Funktionscode auf Ihrem Computer aus und hat Zugriff auf Ihre lokale Umgebung. Testen Sie Code, den Sie nicht im Lambda-Service verfasst haben, wo er von Ihrem Computer isoliert ist.
sam local start-api unterstützt langlebige Funktionen mit automatischen Checkpointing- und Wiedergabefunktionen. Langlebige Funktionen funktionieren nahtlos mit dem lokalen API-Gateway-Endpunkt.
Zu verwenden sam local start-api, installieren Sie den AWS SAM CLI indem Sie Folgendes ausfüllen:
Vor der Verwendung sam local start-api, wir empfehlen ein grundlegendes Verständnis der folgenden Aspekte:
Verwenden Sie die lokale Start-API von SAM
Wenn du rennst sam local start-api, 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 einen lokalen HTTP-Server zu starten
-
Führen Sie im Stammverzeichnis Ihres Projekts Folgendes aus:
$sam local start-api<options> -
Das AWS SAM CLI erstellt Ihre Lambda-Funktionen lokal Docker Behälter. Es gibt dann die lokale Adresse Ihres HTTP-Serverendpunkts aus. Im Folgenden wird ein Beispiel gezeigt:
$sam local start-apiInitializing 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/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container Containers Initialization is done. Mounting HelloWorldFunction at http://127.0.0.1:3000/hello [GET] You can now browse to the above endpoints to invoke your functions. You do not need to restart/reload SAM CLI while working on your functions, changes will be reflected instantly/automatically. If you used sam build before running local commands, you will need to re-run sam build for the changes to be picked up. You only need to restart SAM CLI if you update your AWS SAM template 2023-04-12 14:41:05 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:3000 -
Sie können Ihre Lambda-Funktion über den Browser oder die Befehlszeile aufrufen. Im Folgenden wird ein Beispiel gezeigt:
sam-app$curl http://127.0.0.1:3000/hello{"message": "Hello world!"}% -
Wenn Sie Änderungen an Ihrem Lambda-Funktionscode vornehmen, beachten Sie Folgendes, um Ihren lokalen HTTP-Server zu aktualisieren:
-
Wenn Ihre Anwendung keinen hat
.aws-samVerzeichnis und Ihre Funktion verwendet eine interpretierte Sprache, die AWS SAM CLI aktualisiert Ihre Funktion automatisch, indem ein neuer Container erstellt und gehostet wird. -
Wenn Ihre Anwendung eine hat
.aws-samVerzeichnis, das Sie ausführen müssensam buildum deine Funktion zu aktualisieren. Dann rennesam local start-apierneut, um die Funktion zu hosten. -
Wenn Ihre Funktion eine kompilierte Sprache verwendet oder wenn Ihr Projekt komplexe Paketunterstützung benötigt, führen Sie Ihre eigene Build-Lösung aus, um Ihre Funktion zu aktualisieren. Dann starte
sam local start-apierneut, um die Funktion zu hosten.
-
Lambda-Ereignisfunktionen, die Lambda-Autorisierer verwenden
Diese Funktion ist neu in AWS SAM CLI Ausführung 1.80.0. Informationen zum Upgrade finden Sie unter Aktualisierung des AWS SAMCLI.
Für Lambda-Funktionen, die Lambda-Autorisierer verwenden, ist AWS SAM CLI ruft automatisch Ihren Lambda-Authorizer auf, bevor Sie Ihren Lambda-Funktionsendpunkt aufrufen.
Das Folgende ist ein Beispiel für das Starten eines lokalen HTTP-Servers für eine Funktion, die einen Lambda-Authorizer verwendet:
$sam local start-api2023-04-17 15:02:13 Attaching import module proxy for analyzing dynamic imports AWS SAM CLI does not guarantee 100% fidelity between authorizers locally and authorizers deployed on AWS. Any application critical behavior should be validated thoroughly before deploying to production. Testing application behaviour against authorizers deployed on AWS can be done using the sam sync command. Mounting HelloWorldFunction at http://127.0.0.1:3000/authorized-request [GET] You can now browse to the above endpoints to invoke your functions. You do not need to restart/reload SAM CLI while working on your functions, changes will be reflected instantly/automatically. If you used sam build before running local commands, you will need to re-run sam build for the changes to be picked up. You only need to restart SAM CLI if you update your AWS SAM template 2023-04-17 15:02:13 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:3000 2023-04-17 15:02:13 Press CTRL+C to quit
Wenn Sie Ihren Lambda-Funktionsendpunkt über den lokalen HTTP-Server aufrufen, wird AWS SAM CLI ruft zuerst Ihren Lambda-Authorizer auf. Wenn die Autorisierung erfolgreich ist, wird AWS SAM CLI ruft Ihren Lambda-Funktionsendpunkt auf. Im Folgenden wird ein Beispiel gezeigt:
$curl http://127.0.0.1:3000/authorized-request --header "header:my_token"{"message": "from authorizer"}% Invoking app.authorizer_handler (python3.8) Local image is up-to-date Using local image: public.ecr.aws/lambda/python:3.8-rapid-x86_64. Mounting /Users/.../sam-app/... as /var/task:ro,delegated, inside runtime container START RequestId: 38d3b472-a2c8-4ea6-9a77-9b386989bef0 Version: $LATEST END RequestId: 38d3b472-a2c8-4ea6-9a77-9b386989bef0 REPORT RequestId: 38d3b472-a2c8-4ea6-9a77-9b386989bef0 Init Duration: 1.08 ms Duration: 628.26 msBilled Duration: 629 ms Memory Size: 128 MB Max Memory Used: 128 MB Invoking app.request_handler (python3.8) Using local image: public.ecr.aws/lambda/python:3.8-rapid-x86_64. Mounting /Users/.../sam-app/... as /var/task:ro,delegated, inside runtime container START RequestId: fdc12255-79a3-4365-97e9-9459d06446ff Version: $LATEST END RequestId: fdc12255-79a3-4365-97e9-9459d06446ff REPORT RequestId: fdc12255-79a3-4365-97e9-9459d06446ff Init Duration: 0.95 ms Duration: 659.13 msBilled Duration: 660 ms Memory Size: 128 MB Max Memory Used: 128 MB No Content-Type given. Defaulting to 'application/json'. 2023-04-17 15:03:03 127.0.0.1 - - [17/Apr/2023 15:03:03] "GET /authorized-request HTTP/1.1" 200 -
Optionen
Kontinuierliche Wiederverwendung von Containern, um lokale Funktionsaufrufen zu beschleunigen
Standardmäßig ist der AWS SAM CLI erstellt jedes Mal einen neuen Container, wenn Ihre Funktion über den lokalen HTTP-Server aufgerufen wird. Benutze den --warm-containers Option, um Ihren Container automatisch für Funktionsaufrufe wiederzuverwenden. Dies beschleunigt die Zeit, die benötigt wird, um AWS SAM CLI um Ihre Lambda-Funktion für den lokalen Aufruf vorzubereiten. Sie können diese Option weiter anpassen, indem Sie eager oder lazy Argument.
-
eager— Container für alle Funktionen werden beim Start geladen und bleiben zwischen den Aufrufen bestehen. -
lazy— Container werden nur geladen, wenn jede Funktion zum ersten Mal aufgerufen wird. Sie bleiben dann für weitere Aufrufe bestehen.
Im Folgenden wird ein Beispiel gezeigt:
$sam local start-api --warm-containers eager
Bei der Verwendung --warm-containers und ändern Sie Ihren Lambda-Funktionscode:
-
Wenn Ihre Anwendung eine hat
.aws-samVerzeichnis, startesam buildum Ihren Funktionscode in den Build-Artefakten Ihrer Anwendung zu aktualisieren. -
Wenn eine Codeänderung erkannt wird, wird AWS SAM CLI fährt den Lambda-Funktionscontainer automatisch herunter.
-
Wenn Sie die Funktion erneut aufrufen, wird AWS SAM CLI erstellt automatisch einen neuen Container.
Wenn das Ansehen von Dateien zu einer hohen CPU-Auslastung führt oder I/O Overhead — zum Beispiel in großen Monorepos, Umgebungen mit Antivirensoftware oder Projekten, in denen mehrere Funktionen gemeinsam genutzt werden CodeUri— Sie können es mit dem deaktivieren --no-watch Option:
$sam local start-api --warm-containers eager --no-watch
Mit --no-watch, Code- und Vorlagenänderungen werden nicht automatisch erkannt. Beenden Sie den Befehl und führen Sie ihn erneut aus, um die Änderungen zu übernehmen.
Geben Sie ein Container-Image an, das für Ihre Lambda-Ereignisfunktionen verwendet werden soll
Standardmäßig ist der AWS SAM CLI verwendet Lambda-Basisimages aus Amazon Elastic Container Registry (Amazon ECR), um Ihre Funktionen lokal aufzurufen. Verwenden Sie das --invoke-image Option, um auf ein benutzerdefiniertes Container-Image zu verweisen. Im Folgenden wird ein Beispiel gezeigt:
$sam local start-api --invoke-imagepublic.ecr.aws/sam/emu-python3.8
Sie können die Funktion angeben, die mit dem benutzerdefinierten Container-Image verwendet werden soll. Im Folgenden wird ein Beispiel gezeigt:
$sam local start-api --invoke-imageFunction1=amazon/aws/sam-cli-emulation-image-python3.8
Geben Sie eine Vorlage an, die lokal getestet werden soll
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. Im Folgenden wird ein Beispiel gezeigt:
$sam local start-api --templatemyTemplate.yaml
Geben Sie die Host-Entwicklungsumgebung Ihrer Lambda-Event-Funktion an
In der Standardeinstellung ist sam local start-api Unterbefehl erstellt einen HTTP-Server mit localhost mit IP-Adresse 127.0.0.1. Sie können diese Werte anpassen, wenn Ihre lokale Entwicklungsumgebung von Ihrem lokalen Computer isoliert ist.
Verwenden Sie das --container-host Option, um einen Host anzugeben. Im Folgenden wird ein Beispiel gezeigt:
$sam local start-api --container-hosthost.docker.internal
Benutze das --container-host-interface Option, um die IP-Adresse des Host-Netzwerks anzugeben, an das sich Container-Ports binden sollen. Im Folgenden wird ein Beispiel gezeigt:
$sam local start-api --container-host-interface0.0.0.0
Bewährte Methoden
Wenn Ihre Anwendung 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 start-api 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.
Weitere Informationen
Für eine Liste von allen sam local start-api Optionen finden Sie unter gleiche lokale Start-API.