View a markdown version of this page

sam local start-lambda - 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à.

sam local start-lambda

Questa pagina fornisce informazioni di riferimento per AWS Serverless Application Model Interfaccia a riga di comando (AWS SAM CLI) sam local start-lambda sottocomando.

Il sam local start-lambda il sottocomando avvia un endpoint locale da emulare AWS Lambda.

Importante

Non usare sam local start-lambda con codice non attendibile, perché l'endpoint locale esegue il codice funzionale nell'ambiente locale. Per un isolamento completo, richiama invece il codice nel servizio Lambda.

Utilizzo

$ sam local start-lambda <options>

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 radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta AWS SAMCLIfile di configurazione.

--container-env-vars

Opzionale. Passa le variabili di ambiente al contenitore di immagini 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 il messaggio di debug generato da AWS SAM CLI e visualizza i timestamp.

--debug-args TEXT

Argomenti aggiuntivi da passare al debugger.

--debug-function

Opzionale. Specifica la Lambda Event Function a cui applicare le opzioni di debug a quando --warm-containers è specificato. Questo parametro si applica a --debug-port, --debugger-path, e --debug-args.

--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 host di un debugger da montare 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 viene 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 è 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.

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

--force-image-build

Specificare se il CLI dovrebbe ricostruire l'immagine usata per richiamare le funzioni 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.

--host TEXT

Il nome host o l'indirizzo IP locale a cui collegarsi (impostazione predefinita: '127.0.0.1').

--invoke-image TEXT

L'URI dell'immagine del contenitore da 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. Usa 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 start-lambda --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 start-lambda --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 in base alla cartella in cui vengono scaricati i livelli utilizzati dal modello.

--log-file, -l TEXT

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

--no-memory-limit

Rimuove la limitazione della memoria nel contenitore durante l'invocazione locale, anche quando la memoria è configurata in AWS SAM modello.

--no-watch

Disattiva la visualizzazione dei file se usato con --warm-containers. Quando specificato, AWS SAM CLI non monitora il codice sorgente o il modello per eventuali modifiche e i contenitori caldi non vengono riavviati automaticamente in caso di modifiche al codice. Per rilevare le modifiche locali, interrompi ed esegui nuovamente il comando.

Utilizzate questa opzione quando la visualizzazione dei file causa un aumento della CPU o I/O spese generali, ad esempio in monorepo di grandi dimensioni, ambienti con scansione di software antivirus o progetti in cui più funzioni Lambda condividono un CodeUri.

Questa opzione viene ignorata se --warm-containers non è specificata.

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

--port, -p INTEGER

Il numero di porta locale su cui ascoltare (impostazione predefinita: '3001').

--profile TEXT

Il profilo specifico contenuto nel file delle credenziali che ottiene AWS credenziali.

--region TEXT

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

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

Specifica se CLI dovrebbe evitare di estrarre l'ultima immagine Docker per il runtime Lambda.

--template, -t PATH

Il AWS SAM file 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.

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

--warm-containers [EAGER | LAZY]

Opzionale. Specifica come AWS SAM CLI gestisce i contenitori per ogni funzione.

Sono disponibili due opzioni:

  • EAGER: i contenitori per tutte le funzioni vengono caricati all'avvio e persistono tra una chiamata e l'altra.

  • LAZY: i contenitori vengono caricati solo quando ogni funzione viene richiamata per la prima volta. Questi contenitori persistono per ulteriori invocazioni.

Esempio

Per un esempio dettagliato e una guida dettagliata sull'uso di sam local start-lambda sottocomando, fare riferimento a Introduzione ai test con sam local start-lambda.