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.
-
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 start-lambdasottocomando, vedere Introduzione ai test con sam local start-lambda.
Il sam local start-lambda il sottocomando avvia un endpoint locale da emulare AWS Lambda.
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-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 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-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 il messaggio di debug generato da AWS SAM CLI e visualizza i timestamp.
--debug-argsTEXT-
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, -dTEXT-
Quando specificato, avvia il contenitore di funzioni Lambda in modalità debug ed espone questa porta sull'host locale.
--debugger-pathTEXT-
Il percorso host di un debugger da montare 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 viene specificato, i contenitori Lambda si connettono solo alla rete Docker bridge predefinita.
--docker-volume-basedir, -vTEXT-
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, -nPATH-
Il JSON o
.envfile 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-nameTEXT-
Il nome dell'hook utilizzato per l'estensione AWS SAM CLI funzionalità.
Valori accettati:
terraform. --hostTEXT-
Il nome host o l'indirizzo IP locale a cui collegarsi (impostazione predefinita: '127.0.0.1').
--invoke-imageTEXT-
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 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 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-basedirDIRECTORY-
Specifica la posizione in base alla cartella in cui vengono scaricati i livelli utilizzati dal modello.
--log-file, -lTEXT-
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-containersnon è 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, -pINTEGER-
Il numero di porta locale su cui ascoltare (impostazione predefinita: '3001').
--profileTEXT-
Il profilo specifico contenuto nel file delle credenziali che ottiene AWS credenziali.
--regionTEXT-
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-nameopzione. --skip-pull-image-
Specifica se CLI dovrebbe evitare di estrarre l'ultima immagine Docker per il runtime Lambda.
--template, -tPATH-
Il AWS SAM file modello.
NotaSe 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-nameessere impostato suterraform. --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.