stessa chiamata locale - 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à.

stessa chiamata locale

Richiama unaAWS Lambda funzione locale una volta e si chiude dopo il completamento dell'invocazione.

Per impostazione predefinita, quando si utilizza questo comando, laAWS SAM CLI presuppone che la directory di lavoro corrente sia la directory principale del progetto. LaAWS SAM CLI tenta innanzitutto di individuare un file modello creato utilizzando ilstessa costruzione comando, situato nella.aws-sam sottocartella e denominatotemplate.yaml otemplate.yml. Successivamente, laAWS SAM CLI tenta di individuare un file modello denominatotemplate.yaml otemplate.yml nella directory di lavoro corrente. Se si specifica l'--templateopzione, il comportamento predefinito dellaAWS SAM CLI viene sovrascritto e caricherà solo quelAWS SAM modello e le risorse locali a cui fa riferimento.

Per richiamare una funzione di un'applicazione o di uno stack annidato, è possibile fornire l'ID logico dell'applicazione o dello stack insieme all'ID logico della funzione utilizzando il formatoStackLogicalId/FunctionLogicalId.

Ilsam local invoke comando è utile per lo sviluppo di funzioni senza server che gestiscono eventi asincroni, come Amazon S3 o gli eventi Amazon S3 o Amazon Amazon Kinesis. Può anche essere utile se si desidera comporre uno script di casi di test. È possibile passare al corpo dell'evento utilizzando il--event parametro. Per ulteriori informazioni sugli eventi, consulta Evento nella Guida per gliAWS Lambda sviluppatori. Per informazioni dettagliate sui formati dei messaggi di eventi di diversiAWS servizi, consulta Lavorare con altri servizi nella Guida per gliAWS Lambda sviluppatori.

L'output di runtime (ad esempio, registri) viene emesso instderr e il risultato della funzione Lambda viene emesso instdout.

Nota

Se nelAWS SAM modello è definita più di una funzione, è necessario fornireFUNCTION_LOGICAL_ID la funzione che si desidera richiamare.

Utilizzo:

sam local invoke [OPTIONS] [FUNCTION_LOGICAL_ID]

Opzioni:

Opzione Descrizione
--hook-name TEXT

Il nome dell'hook utilizzato per estendere la funzionalitàAWS SAM CLI.

Valori accettati:terraform.

--skip-prepare-infra Salta la fase di preparazione se non sono state apportate modifiche all'infrastruttura. Usa con l'--hook-nameopzione.
-e, --event PATH Il file JSON che contiene i dati degli eventi che vengono passati alla funzione Lambda quando viene richiamata. Se non si specifica questa opzione, non si presume alcun evento. Per inserire JSON dastdin, devi inserire il valore '-'. Per informazioni dettagliate sui formati dei messaggi di eventi di diversiAWS servizi, consulta Lavorare con altri servizi nella Guida per gliAWS Lambda sviluppatori.
--no-event Richiama la funzione con un evento vuoto.
-t, --template PATH Il fileAWS SAM modello.

Nota: se si specifica questa opzione,AWS SAM carica solo il modello e le risorse locali a cui fa riferimento. Questa opzione non è compatibile con--hook-name.

-n, --env-vars PATH Il file JSON che contiene i valori per le variabili di ambiente della funzione Lambda. Per ulteriori informazioni sui file delle variabili di ambiente, consultaFile di variabili di ambiente.
--parameter-overrides (Facoltativo) Una stringa che contiene le sostituzioni diAWS CloudFormation parametri codificati come coppie chiave-valore. Utilizza lo stesso formato diAWS Command Line Interface (AWS CLI). Ad esempio: 'ParameterKey=KeyPairName,ParameterValue =MyKeyParameterKey =InstanceType,ParameterValue =t1.micro'. Questa opzione non è compatibile con--hook-name.
-d, --debug-port TEXT Quando specificato, avvia il contenitore della funzione Lambda in modalità di debug ed espone questa porta sull'host locale.
--debugger-path TEXT Il percorso host di un debugger montato nel contenitore Lambda.
--debug-args TEXT Argomenti aggiuntivi da passare al debugger.
-v, --docker-volume-basedir TEXT La posizione della directory di base in cui si trova ilAWS SAM file. Se Docker è in esecuzione su una macchina remota, è necessario montare il percorso in cui ilAWS SAM file esiste sulla macchina Docker e modificare questo valore in modo che corrisponda alla macchina remota.
--docker-network TEXT Il nome o l'ID di una rete Docker esistente a cui devono connettersi i container Lambda Docker, insieme alla rete bridge predefinita. Se non specificato, i container Lambda si connettono solo alla rete Docker bridge di default.
--container-env-vars (Facoltativo) Passa le variabili di ambiente al contenitore di immagini della funzione Lambda durante il debug in locale.
-l, --log-file TEXT Il file di registro a cui inviare i log di runtime.
--layer-cache-basedir DIRECTORY Specifica la posizione della directory di base in cui vengono scaricati i layer utilizzati dal modello.
--skip-pull-image Specifica se laAWS SAM CLI deve saltare l'estrazione dell'ultima immagine Docker per il tempo di esecuzione Lambda.
--beta-features | --no-beta-features Consenti o nega le funzionalità beta.
--force-image-build Specifica se laAWS SAM CLI deve ricostruire l'immagine utilizzata per richiamare le funzioni Lambda con livelli.
--invoke-image TEXT

L'URI dell'immagine del contenitore che si desidera utilizzare per l'invocazione della funzione locale. Per impostazione predefinita,AWS SAM estrae l'immagine del container da Amazon ECR Public. Usa questa opzione per estrarre l'immagine da un'altra posizione.

Ad esempio, sam local invoke MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8.

--profile TEXT Il profilo specifico del file delle credenziali che ottieneAWS le credenziali.
--region TEXT LaAWS regione per l'implementazione. Ad esempio, us-east-1.
--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 radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta AWS SAMFile di configurazione CLI.
--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 SAMFile di configurazione CLI.
--shutdown Emula un evento di spegnimento dopo il completamento della chiamata, per testare la gestione delle estensioni del comportamento di spegnimento.
--container-host TEXT Host di container Lambda emulato localmente. Il valore di default è localhost. Se desideri eseguire laAWS SAM CLI in un contenitore Docker su macOS, puoi specificarehost.docker.internal. Se si desidera eseguire il contenitore su un host diverso da quello dellaAWS SAM CLI, è possibile specificare l'indirizzo IP dell'host remoto.
--container-host-interface TEXT L'indirizzo IP dell'interfaccia di rete host a cui devono collegarsi le porte del contenitore. Il valore di default è 127.0.0.1. Si usa0.0.0.0 per collegarsi a tutte le interfacce.
--debug Attiva la registrazione di debug per stampare i messaggi di debug generati dallaAWS SAM CLI e per visualizzare i timestamp.
--help Mostra questo messaggio ed esce.