Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
invocazione locale sam
Questa pagina fornisce informazioni di riferimento per AWS Serverless Application Model Interfaccia a riga di comando (AWS SAM CLI) sam local invoke sottocomando.
-
Per un'introduzione al AWS SAM CLI, vedi Che cos'è il AWS SAM CLI?
-
Per la documentazione sull'uso di AWS SAM CLI
sam local invokesottocomando, vedere Introduzione ai test con Sam local invoke.
Il sam local invoke il sottocomando avvia una chiamata una tantum di un AWS Lambda Funzione evento localmente.
Non usare sam local invoke con codice non attendibile. Per ottenere un completo isolamento dall'ambiente locale, esegui direttamente il codice nel servizio Lambda.
Per funzioni durature, sam local invoke supporta l'esecuzione stateful con checkpoint e replay automatici. Il contenitore rimane in esecuzione durante l'esecuzione duratura della funzione per gestire la persistenza e la ripresa dello stato.
Utilizzo
$sam local invoke<arguments><options>
Se hai più di una funzione definita nel tuo AWS SAM modello, fornisci l'ID logico della funzione che desideri richiamare.
Arguments (Argomenti)
- Resource ID (ID risorsa)
-
L'ID della funzione Lambda da invocare.
Questo argomento è facoltativo. Se l'applicazione contiene una sola funzione Lambda, AWS SAM La CLI la invocherà. Se l'applicazione contiene più funzioni, fornisci l'ID della funzione da richiamare.
Valori validi: ID logico o ARN della risorsa.
Opzioni
--add-hostLIST-
Passa un nome host alla mappatura dell'indirizzo IP al file host del contenitore Docker. Questo parametro può essere passato più volte.
Esempio
Ad esempio:
--add-hostexample.com:127.0.0.1 --beta-features | --no-beta-features-
Consenti o nega le funzionalità beta.
--config-envTEXT-
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta AWS SAMCLIfile di configurazione.
--config-filePATH-
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è»
samconfig.toml"nella cartella principale della cartella del progetto. Per ulteriori informazioni sui file di configurazione, consulta AWS SAMCLIfile di configurazione. --container-env-vars-
(Facoltativo) Passa le variabili di ambiente al contenitore di immagini della funzione Lambda durante il debug locale.
--container-hostTEXT-
Host di container Lambda emulati localmente. Il valore predefinito è
localhost. Se vuoi correre AWS SAM CLI in un contenitore Docker su macOS, puoi specificarehost.docker.internal. Se si desidera eseguire il contenitore su un host diverso da AWS SAM CLI, è possibile specificare l'indirizzo IP dell'host remoto. --container-host-interfaceTEXT-
L'indirizzo IP dell'interfaccia di rete host a cui le porte del contenitore devono collegarsi. Il valore predefinito è
127.0.0.1. Usa0.0.0.0per collegarsi a tutte le interfacce. --container-dnsTEXT-
Specifica un server DNS personalizzato per il contenitore Docker. Questo parametro può essere passato più volte per specificare più server DNS.
Esempio
Ad esempio:
--container-dns8.8.8.8 --debug-
Attiva la registrazione di debug per stampare i messaggi di debug che AWS SAM CLI genera e visualizza i timestamp.
--debug-argsTEXT-
Argomenti aggiuntivi da passare al debugger.
--debug-port, -dTEXT-
Quando specificato, avvia il contenitore di funzioni Lambda in modalità debug ed espone questa porta sull'host locale.
--debugger-pathTEXT-
Il percorso dell'host di un debugger montato nel contenitore Lambda.
--docker-networkTEXT-
Il nome o l'ID di una rete Docker esistente a cui i contenitori Lambda Docker devono connettersi, insieme alla rete bridge predefinita. Se questo non è specificato, i contenitori Lambda si connettono solo alla rete Docker bridge predefinita.
--docker-volume-basedir, -vTEXT-
La posizione della directory di base in cui si trova AWS SAM il file esiste. Se Docker è in esecuzione su una macchina remota, è necessario montare il percorso in cui AWS SAM il file esiste sulla macchina Docker e modifica questo valore in modo che corrisponda alla macchina remota.
--durable-execution-nameTEXT-
Nome dell'esecuzione durevole (solo per funzioni durevoli)
--env-vars, -nPATH-
Il JSON o
.envfile che contiene i valori per le variabili di ambiente della funzione Lambda. Il formato del file viene rilevato automaticamente. Per ulteriori informazioni sui file con variabili di ambiente, vedere File di variabili di ambiente. --event, -ePATH-
Il file JSON che contiene i dati degli eventi passati alla funzione Lambda quando viene richiamata. Se non si specifica questa opzione, non si presume alcun evento. Per inserire JSON da
stdin, devi inserire il valore '-'. Per informazioni dettagliate sui diversi formati dei messaggi relativi agli eventi AWS servizi, vedere Lavorare con altri servizi nel AWS Lambda Guida per gli sviluppatori. --force-image-build-
Specifica se AWS SAM CLI dovrebbe ricostruire l'immagine usata per richiamare le funzioni Lambda con livelli.
--help-
Mostra questo messaggio ed esce.
--hook-name TEXT-
Il nome dell'hook utilizzato per l'estensione AWS SAM CLI funzionalità.
Valori accettati:
terraform. --invoke-imageTEXT-
L'URI dell'immagine del contenitore che si desidera utilizzare per l'invocazione della funzione locale.
Per le funzioni Lambda con
PackageType: Zip, questo sovrascrive l'immagine di base del runtime. Per impostazione predefinita, AWS SAM estrae l'immagine del contenitore da Amazon ECR Public (che è elencata in Archivi di immagini per AWS SAM). Utilizzate questa opzione per estrarre l'immagine da un'altra posizione.Per le funzioni Lambda con
PackageType: Image, questo sovrascrive ilImageUridal modello creato. Usalo per richiamare localmente un'immagine dell'applicazione diversa senza modificare il modello.È possibile indicare questa opzione più volte. Ogni istanza di questa opzione può accettare una stringa o una coppia chiave-valore. Se si specifica una stringa, si tratta dell'URI dell'immagine del contenitore da utilizzare per tutte le funzioni dell'applicazione. Ad esempio,
sam local invoke --invoke-image public.ecr.aws/sam/emu-python3.13. Se si specifica una coppia chiave-valore, la chiave è il nome della risorsa e il valore è l'URI dell'immagine del contenitore da utilizzare per quella risorsa. Ad esempio,sam local invoke --invoke-image public.ecr.aws/sam/emu-python3.13 --invoke-image Function1=amazon/aws-sam-cli-emulation-image-python3.13. Con le coppie chiave-valore, puoi specificare immagini del contenitore diverse per risorse diverse. --layer-cache-basedirDIRECTORY-
Specifica la posizione della directory di base in cui vengono scaricati i livelli utilizzati dal modello.
--log-file, -lTEXT-
Il file di registro a cui inviare i log di runtime.
--mount-symlinks-
Assicura il AWS SAM CLI monta sempre i collegamenti simbolici presenti nei file da creare o richiamare. Questo vale solo per i collegamenti simbolici nella directory di primo livello (cioè, i collegamenti simbolici che si trovano direttamente nella radice della funzione). Per impostazione predefinita, i collegamenti simbolici non vengono montati ad eccezione di quelli necessari per l'uso
build-in-sourcepernode_modulesin NodeJS. --no-event-
Richiama la funzione con un evento vuoto.
--no-memory-limit-
Rimuove la limitazione di memoria nel contenitore durante l'invocazione locale, anche quando la memoria è configurata in AWS SAM modello.
--parameter-overrides-
Una stringa che contiene CloudFormation i parametri sostituiscono le coppie codificate come coppie chiave-valore. Usa lo stesso formato di AWS Command Line Interface (AWS CLI). Il AWS SAM CLI il formato è composto da parole chiave e valore esplicite, ogni override è separato da uno spazio. Di seguito, sono riportati due esempi:
--parameter-overrides ParameterKey=hello,ParameterValue=world--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana
--profileTEXT-
Il profilo specifico del tuo file di credenziali che ottiene AWS credenziali.
--regionTEXT-
Le AWS Regione in cui effettuare la distribuzione. Ad esempio, us-east-1.
--runtimeTEXT-
Utilizza il runtime specificato per richiamare una funzione Lambda localmente. Questo sovrascrive il runtime definito in
template.ymlfile. Ciò consente anche di testare le funzioni Lambda con tempi di esecuzione diversi senza modificare la configurazione della funzione originale. --save-params-
Salva i parametri forniti nella riga di comando nel file AWS SAM file di configurazione.
--shutdown-
Emula un evento di spegnimento dopo il completamento dell'invocazione, per testare la gestione da parte dell'estensione del comportamento di spegnimento.
--skip-prepare-infra-
Salta la fase di preparazione se non sono state apportate modifiche all'infrastruttura. Da utilizzare con
--hook-nameopzione. --skip-pull-image-
Per impostazione predefinita, AWS SAM CLI verifica l'ultimo ambiente di runtime remoto di Lambda e aggiorna automaticamente l'immagine locale per mantenerla sincronizzata.
Specifica questa opzione per non dover tirare giù la versione più recente Docker immagine per il tuo ambiente di runtime Lambda.
--template, -tPATH-
Il AWS SAM file modello.
Questa opzione non è compatibile con
--hook-name.NotaSe si specifica questa opzione, AWS SAM carica solo il modello e le risorse locali a cui fa riferimento.
--tenant-idTEXT-
L'ID tenant per le funzioni Lambda multi-tenant. Utilizzato per garantire l'isolamento del calcolo tra diversi tenant. Richiesto quando si richiamano funzioni configurate con la modalità di isolamento del tenant.
--terraform-plan-file-
Il percorso relativo o assoluto verso il tuo locale Terraform file di piano quando si utilizza il AWS SAM CLI con Terraform Cloud. Questa opzione richiede che
--hook-nameessere impostato suterraform.
Esempi
L'esempio seguente utilizza un evento generato per i test locali utilizzando un s3.json evento per richiamare una funzione Lambda localmente
$sam local invoke --eventevents/s3.json S3JsonLoggerFunction
L'esempio seguente verifica la funzione HelloWorldFunction usando il runtime di Python 3.11
$sam local invoke --runtimepython3.11 HelloWorldFunction
L'esempio seguente verifica la funzione HelloWorldFunction con un nome di esecuzione duraturo
$sam local invokeHelloWorldFunction --durable-execution-name my-execution