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.
gleicher lokaler Aufruf
Diese Seite enthält Referenzinformationen für AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAM CLI) sam local invoke Unterbefehl.
-
Für eine Einführung in die AWS SAM CLI, siehe Was ist der AWS SAM CLI?
-
Eine Dokumentation zur Verwendung des AWS SAM CLI
sam local invokeUnterbefehl, siehe Einführung in das Testen mit gleicher lokaler Aufruf.
Das sam local invoke Unterbefehl initiiert einen einmaligen Aufruf von AWS Lambda Event-Funktion lokal.
Nicht verwenden sam local invoke mit nicht vertrauenswürdigem Code. Um eine vollständige Isolierung von Ihrer lokalen Umgebung zu erreichen, führen Sie den Code direkt im Lambda-Service aus.
Für langlebige Funktionen sam local invoke unterstützt die statusbehaftete Ausführung mit automatischem Checkpointing und Replay. Der Container läuft während der Ausführung einer dauerhaften Funktion weiter, um die Persistenz und Wiederaufnahme des Zustands zu gewährleisten.
Usage
$sam local invoke<arguments><options>
Wenn Sie mehr als eine Funktion in Ihrem definiert haben AWS SAM Vorlage, geben Sie die logische ID der Funktion an, die Sie aufrufen möchten.
Argumente
- Resource ID (Ressourcen-ID)
-
Die ID der aufzurufenden Lambda-Funktion.
Dieses Argument ist optional. Wenn Ihre Anwendung eine einzelne Lambda-Funktion enthält, ist die AWS SAM CLI wird sie aufrufen. Wenn Ihre Anwendung mehrere Funktionen enthält, geben Sie die ID der aufzurufenden Funktion an.
Gültige Werte: Die logische ID oder der Ressourcen-ARN der Ressource.
Optionen
--add-hostLIST-
Übergibt die Zuordnung eines Hostnamens zur IP-Adresse an die Hostdatei des Docker-Containers. Dieser Parameter kann mehrfach übergeben werden.
Beispiel
Beispiel:
--add-hostexample.com:127.0.0.1 --beta-features | --no-beta-features-
Betafunktionen zulassen oder ablehnen.
--config-envTEXT-
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter AWS SAMCLIKonfigurationsdatei.
--config-filePATH-
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist“
samconfig.toml"im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter AWS SAMCLIKonfigurationsdatei. --container-env-vars-
(Optional) Übergeben Sie beim lokalen Debuggen Umgebungsvariablen an den Imagecontainer der Lambda-Funktion.
--container-hostTEXT-
Host des lokal emulierten Lambda-Containers. Der Standardwert ist
localhost. Wenn du rennen willst AWS SAM CLI in einem Docker-Container unter macOS können Sie angebenhost.docker.internal. Wenn Sie den Container auf einem anderen Host ausführen möchten als AWS SAM CLI, Sie können die IP-Adresse des Remote-Hosts angeben. --container-host-interfaceTEXT-
Die IP-Adresse der Host-Netzwerkschnittstelle, an die Container-Ports gebunden werden sollen. Der Standardwert ist
127.0.0.1. Verwenden0.0.0.0um an alle Schnittstellen zu binden. --container-dnsTEXT-
Gibt einen benutzerdefinierten DNS-Server für den Docker-Container an. Dieser Parameter kann mehrfach übergeben werden, um mehrere DNS-Server anzugeben.
Beispiel
Beispiel:
--container-dns8.8.8.8 --debug-
Aktiviert die Debug-Protokollierung, um Debug-Meldungen auszudrucken, die AWS SAM CLI generiert und um Zeitstempel anzuzeigen.
--debug-argsTEXT-
Zusätzliche Argumente, die an den Debugger übergeben werden.
--debug-port, -dTEXT-
Wenn angegeben, startet der Lambda-Funktionscontainer im Debug-Modus und macht diesen Port auf dem lokalen Host verfügbar.
--debugger-pathTEXT-
Der Hostpfad zu einem Debugger, der in den Lambda-Container eingebunden ist.
--docker-networkTEXT-
Der Name oder die ID eines vorhandenen Docker-Netzwerks, mit dem Lambda-Docker-Container eine Verbindung herstellen sollten, zusammen mit dem Standard-Bridge-Netzwerk. Wenn dies nicht angegeben ist, stellen die Lambda-Container nur eine Verbindung zum Standard-Bridge-Docker-Netzwerk her.
--docker-volume-basedir, -vTEXT-
Der Speicherort des Basisverzeichnisses, in dem AWS SAM Datei existiert. Wenn Docker auf einem Remote-Computer läuft, müssen Sie den Pfad mounten, in dem AWS SAM Eine Datei ist auf dem Docker-Computer vorhanden. Ändern Sie diesen Wert so, dass er dem Remote-Computer entspricht.
--durable-execution-nameTEXT-
Name für die dauerhafte Ausführung (nur für dauerhafte Funktionen)
--env-vars, -nPATH-
Das JSON oder
.envDatei, die Werte für die Umgebungsvariablen der Lambda-Funktion enthält. Das Dateiformat wird automatisch erkannt. Weitere Hinweise zu Dateien mit Umgebungsvariablen finden Sie unter Umgebungsvariablendatei. --event, -ePATH-
Die JSON-Datei, die Ereignisdaten enthält, die an die Lambda-Funktion übergeben werden, wenn sie aufgerufen wird. Wenn Sie diese Option nicht angeben, wird von keinem Ereignis ausgegangen. Um JSON einzugeben von
stdin, Sie müssen den Wert '-' eingeben. Weitere Informationen zu den Formaten von Event-Nachrichten finden Sie von verschiedenen AWS Dienste, siehe Mit anderen Diensten arbeiten in der AWS Lambda Leitfaden für Entwickler. --force-image-build-
Gibt an, ob AWS SAM CLI sollte das Image, das zum Aufrufen von Lambda-Funktionen mit Ebenen verwendet wird, neu erstellen.
--help-
Zeigt diese Meldung an und beendet das Programm.
--hook-name TEXT-
Der Name des Hooks, der zur Erweiterung verwendet wird AWS SAM CLI Funktionalität.
Zulässige Werte:
terraform. --invoke-imageTEXT-
Die URI des Container-Images, das Sie für den lokalen Funktionsaufruf verwenden möchten.
Für Lambda-Funktionen mit
PackageType: Zip, dies überschreibt das Runtime-Basis-Image. In der Standardeinstellung AWS SAM ruft das Container-Image von Amazon ECR Public ab (die in aufgeführt sind Bild-Repositorys für AWS SAM). Verwenden Sie diese Option, um das Bild von einem anderen Ort abzurufen.Für Lambda-Funktionen mit
PackageType: Image, das überschreibtImageUriaus der erstellten Vorlage. Verwenden Sie dies, um lokal ein anderes Anwendungs-Image aufzurufen, ohne Ihre Vorlage zu ändern.Sie können diese Option mehrfach angeben. Jede Instanz dieser Option kann entweder eine Zeichenfolge oder ein Schlüssel-Wert-Paar annehmen. Wenn Sie eine Zeichenfolge angeben, ist dies die URI des Container-Images, das für alle Funktionen in Ihrer Anwendung verwendet werden soll. Beispiel,
sam local invoke --invoke-image public.ecr.aws/sam/emu-python3.13. Wenn Sie ein Schlüssel-Wert-Paar angeben, ist der Schlüssel der Ressourcenname, und der Wert ist der URI des Container-Images, das für diese Ressource verwendet werden soll. Beispiel,sam local invoke --invoke-image public.ecr.aws/sam/emu-python3.13 --invoke-image Function1=amazon/aws-sam-cli-emulation-image-python3.13. Mit Schlüssel-Wert-Paaren können Sie verschiedene Container-Images für verschiedene Ressourcen angeben. --layer-cache-basedirDIRECTORY-
Gibt den Speicherort des Basisverzeichnisses an, in das die von Ihrer Vorlage verwendeten Ebenen heruntergeladen werden.
--log-file, -lTEXT-
Die Protokolldatei, an die Laufzeitprotokolle gesendet werden sollen.
--mount-symlinks-
Stellt sicher, dass AWS SAM CLI mountet immer Symlinks, die in den zu erstellenden oder aufzurufenden Dateien vorhanden sind. Dies gilt nur für Symlinks im Verzeichnis der obersten Ebene (d. h. für Symlinks, die sich direkt im Stammverzeichnis der Funktion befinden). Standardmäßig werden Symlinks nicht gemountet, außer denen, die zur Verwendung benötigt werden
build-in-sourcezumnode_modulesin NodeJS. --no-event-
Ruft die Funktion mit einem leeren Ereignis auf.
--no-memory-limit-
Entfernt die Speicherbeschränkung im Container während des lokalen Aufrufs, auch wenn der Speicher im konfiguriert ist AWS SAM Vorlage.
--parameter-overrides-
Eine Zeichenfolge, die enthält CloudFormation Parameterüberschreibungen, die als Schlüssel-Wert-Paare kodiert sind. Verwenden Sie dasselbe Format wie AWS Command Line Interface (AWS CLI). Das AWS SAM CLI format besteht aus expliziten Schlüssel- und Wert-Schlüsselwörtern. Jede Überschreibung ist durch ein Leerzeichen getrennt. Nachfolgend finden Sie zwei Beispiele:
--parameter-overrides ParameterKey=hello,ParameterValue=world--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana
--profileTEXT-
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das abgerufen wird AWS Anmeldeinformationen.
--regionTEXT-
Die AWS Region, in der bereitgestellt werden soll. Beispiel: us-east-1.
--runtimeTEXT-
Verwendet die angegebene Laufzeit, um eine Lambda-Funktion lokal aufzurufen. Dies überschreibt die in der
template.ymldatei. Dies ermöglicht auch das Testen von Lambda-Funktionen mit unterschiedlichen Laufzeiten, ohne die ursprüngliche Funktionskonfiguration zu ändern. --save-params-
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, im AWS SAM Konfigurationsdatei.
--shutdown-
Emuliert nach Abschluss des Aufrufs ein Shutdown-Ereignis, um zu testen, wie die Erweiterung das Verhalten beim Herunterfahren handhabt.
--skip-prepare-infra-
Überspringt die Vorbereitungsphase, wenn keine Änderungen an der Infrastruktur vorgenommen wurden. Verwenden Sie mit dem
--hook-nameOption. --skip-pull-image-
In der Standardeinstellung ist der AWS SAM CLI überprüft die neueste Remote-Laufzeitumgebung von Lambda und aktualisiert Ihr lokales Image automatisch, um es synchron zu halten.
Geben Sie diese Option an, um das Herunterladen der neuesten Version zu überspringen Docker Image für Ihre Lambda-Laufzeitumgebung.
--template, -tPATH-
Das AWS SAM Vorlagendatei.
Diese Option ist nicht kompatibel mit
--hook-name.AnmerkungWenn Sie diese Option angeben, AWS SAM lädt nur die Vorlage und die lokalen Ressourcen, auf die sie verweist.
--tenant-idTEXT-
Die Mandanten-ID für Lambda-Funktionen mit mehreren Mandanten. Wird verwendet, um die Rechenisolierung zwischen verschiedenen Mandanten sicherzustellen. Erforderlich, wenn Funktionen aufgerufen werden, die mit dem Tenant-Isolationsmodus konfiguriert sind.
--terraform-plan-file-
Der relative oder absolute Pfad zu Ihrem lokalen Terraform Plandatei bei Verwendung der AWS SAM CLI mit Terraform Cloud. Für diese Option ist Folgendes erforderlich
--hook-namemuss gesetzt sein aufterraform.
Beispiele
Das folgende Beispiel verwendet ein generiertes Ereignis für lokale Tests mithilfe eines s3.json Ereignis, um eine Lambda-Funktion lokal aufzurufen
$sam local invoke --eventevents/s3.json S3JsonLoggerFunction
Das folgende Beispiel testet die Funktion HelloWorldFunction unter Verwendung der Python 3.11-Laufzeit
$sam local invoke --runtimepython3.11 HelloWorldFunction
Das folgende Beispiel testet die Funktion HelloWorldFunction mit einem dauerhaften Ausführungsnamen
$sam local invokeHelloWorldFunction --durable-execution-name my-execution