View a markdown version of this page

invocazione locale sam - AWS Serverless Application Model

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.

Il sam local invoke il sottocomando avvia una chiamata una tantum di un AWS Lambda Funzione evento localmente.

Importante

Non usare sam local invoke con codice non attendibile. Per ottenere un completo isolamento dall'ambiente locale, esegui direttamente il codice nel servizio Lambda.

Nota

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>
Nota

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-host LIST

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-host example.com:127.0.0.1

--beta-features | --no-beta-features

Consenti o nega le funzionalità beta.

--config-env TEXT

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-file PATH

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-host TEXT

Host di container Lambda emulati localmente. Il valore predefinito è localhost. Se vuoi correre AWS SAM CLI in un contenitore Docker su macOS, puoi specificare host.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-interface TEXT

L'indirizzo IP dell'interfaccia di rete host a cui le porte del contenitore devono collegarsi. Il valore predefinito è 127.0.0.1. Usa 0.0.0.0 per collegarsi a tutte le interfacce.

--container-dns TEXT

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-dns 8.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-args TEXT

Argomenti aggiuntivi da passare al debugger.

--debug-port, -d TEXT

Quando specificato, avvia il contenitore di funzioni Lambda in modalità debug ed espone questa porta sull'host locale.

--debugger-path TEXT

Il percorso dell'host di un debugger montato nel contenitore Lambda.

--docker-network TEXT

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, -v TEXT

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-name TEXT

Nome dell'esecuzione durevole (solo per funzioni durevoli)

--env-vars, -n PATH

Il JSON o .env file 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, -e PATH

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-image TEXT

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 il ImageUri dal 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-basedir DIRECTORY

Specifica la posizione della directory di base in cui vengono scaricati i livelli utilizzati dal modello.

--log-file, -l TEXT

Il file di registro a cui inviare i log di runtime.

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-source per node_modules in 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

--profile TEXT

Il profilo specifico del tuo file di credenziali che ottiene AWS credenziali.

--region TEXT

Le AWS Regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

--runtime TEXT

Utilizza il runtime specificato per richiamare una funzione Lambda localmente. Questo sovrascrive il runtime definito in template.yml file. 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-name opzione.

--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, -t PATH

Il AWS SAM file modello.

Questa opzione non è compatibile con --hook-name.

Nota

Se si specifica questa opzione, AWS SAM carica solo il modello e le risorse locali a cui fa riferimento.

--tenant-id TEXT

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-name essere impostato su terraform.

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 --event events/s3.json S3JsonLoggerFunction

L'esempio seguente verifica la funzione HelloWorldFunction usando il runtime di Python 3.11

$ sam local invoke --runtime python3.11 HelloWorldFunction

L'esempio seguente verifica la funzione HelloWorldFunction con un nome di esecuzione duraturo

$ sam local invoke HelloWorldFunction --durable-execution-name my-execution