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 build
Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)sam build
.
-
Per un'introduzione a AWS SAMCLI, vedereChe cos'è il? AWS SAMCLI.
-
Per la documentazione sull'uso del AWS SAMCLI
sam build
comando, vedereIntroduzione alla costruzione con AWS SAM.
Il sam build
comando prepara un'applicazione per i passaggi successivi del flusso di lavoro degli sviluppatori, ad esempio il test locale o la distribuzione su. Cloud AWS
Utilizzo
$
sam build
<arguments>
<options>
Argomenti
- ID risorsa
-
Facoltativo. Indica AWS SAM a creare una singola risorsa dichiarata in un AWS SAM modello. Gli artefatti di compilazione per la risorsa specificata saranno gli unici disponibili per i comandi successivi nel flusso di lavoro, ad esempio e.
sam package
sam deploy
Opzioni
--base-dir, -s
DIRECTORY
-
Risolve i percorsi relativi al codice sorgente della funzione o del livello rispetto a questa directory. Utilizzate questa opzione se desiderate modificare il modo in cui vengono risolti i percorsi relativi alle cartelle del codice sorgente. Per impostazione predefinita, i percorsi relativi vengono risolti rispetto alla posizione del AWS SAM modello.
Oltre alle risorse nell'applicazione root o nello stack che state creando, questa opzione si applica anche alle applicazioni o agli stack annidati.
Questa opzione si applica ai seguenti tipi e proprietà di risorse:
-
Tipo di risorsa:
AWS::Serverless::Function
Proprietà:CodeUri
-
Tipo di risorsa: Attributo della
AWS::Serverless::Function
risorsa:Metadata
Voce:DockerContext
-
Tipo di risorsa:
AWS::Serverless::LayerVersion
Proprietà:ContentUri
-
Tipo di risorsa:
AWS::Lambda::Function
Proprietà:Code
-
Tipo di risorsa:
AWS::Lambda::LayerVersion
Proprietà:Content
-
--beta-features | --no-beta-features
-
Consenti o nega le funzionalità beta.
--build-dir, -b
DIRECTORY
-
Il percorso di una directory in cui sono archiviati gli artefatti creati. Questa directory e tutto il suo contenuto vengono rimossi con questa opzione.
--build-image
TEXT
-
L'URI dell'immagine del contenitore che vuoi estrarre per la build. 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.
Puoi specificare 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 risorse dell'applicazione. Ad esempio,
sam build --use-container --build-image amazon/aws-sam-cli-build-image-python3.8
. 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 esempiosam build --use-container --build-image Function1=amazon/aws-sam-cli-build-image-python3.8
. Con le coppie chiave-valore, è possibile specificare immagini di contenitori diverse per risorse diverse.Questa opzione si applica solo se l'
--use-container
opzione è specificata, altrimenti si verificherà un errore. --build-in-source | --no-build-in-source
-
--build-in-source
Provvedi a creare il tuo progetto direttamente nella cartella dei sorgenti.L'
--build-in-source
opzione supporta i seguenti runtime e metodi di compilazione:-
Runtime: qualsiasi Node.js runtime supportato dall'
sam init --runtime
opzione. -
Metodi di compilazione:
Makefile
,esbuild
.
L'
--build-in-source
opzione non è compatibile con le seguenti opzioni:-
--hook-name
-
--use-container
Default:
--no-build-in-source
-
--cached | --no-cached
-
Abilita o disabilita le build memorizzate nella cache. Usa questa opzione per riutilizzare gli artefatti della build che non sono stati modificati rispetto alle build precedenti. AWS SAM valuta se sono stati modificati i file nella directory del progetto. Per impostazione predefinita, le build non vengono memorizzate nella cache. Se l'
--no-cached
opzione viene richiamata, sostituisce l'impostazione in samcofig.toml.cached = true
Nota
AWS SAM non valuta se hai modificato i moduli di terze parti da cui dipende il tuo progetto, laddove non hai fornito una versione specifica. Ad esempio, se la tua funzione Python include un
requirements.txt
file con la vocerequests=1.x
e l'ultima versione del modulo di richiesta cambia da1.1
a1.2
, non estrae la versione più recente finché AWS SAM non esegui una build non memorizzata nella cache. --cache-dir
-
La directory in cui vengono memorizzati gli elementi della cache quando viene specificata.
--cached
La directory cache predefinita è..aws-sam/cache
--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-var, -e
TEXT
-
Variabili di ambiente da passare al contenitore di compilazione. Puoi specificare questa opzione più volte. Ogni istanza di questa opzione accetta una coppia chiave-valore, dove la chiave è la variabile risorsa e ambiente e il valore è il valore della variabile di ambiente. Ad esempio:
--container-env-var Function1.GITHUB_TOKEN=TOKEN1 --container-env-var Function2.GITHUB_TOKEN=TOKEN2
.Questa opzione si applica solo se l'
--use-container
opzione è specificata, altrimenti si verificherà un errore. --container-env-var-file, -ef
PATH
-
Il percorso e il nome di un file JSON che contiene valori per le variabili di ambiente del contenitore. Per ulteriori informazioni sui file delle variabili di ambiente del contenitore, vedereFile variabile di ambiente del contenitore.
Questa opzione si applica solo se l'
--use-container
opzione è specificata, altrimenti si verificherà un errore. --debug
-
Attiva la registrazione di debug per stampare i messaggi di debug che AWS SAMCLI genera e per visualizzare i timestamp.
--docker-network
TEXT
-
Speciifica il nome o l'ID di una Docker rete esistente a cui i contenitori Docker Lambda devono connettersi, insieme alla rete bridge predefinita. Se non specificato, i contenitori Lambda si connettono solo alla rete bridge Docker predefinita.
--exclude, -x
-
Il nome delle risorse da escludere da.
sam build
Ad esempio, se il modello contieneFunction1
Function2
, eFunction3
e lo eseguisam build --exclude Function2
, soloFunction1
eFunction3
verrà creato. --help
-
Mostra questo messaggio ed esce.
--hook-name
TEXT
-
Il nome dell'hook utilizzato per estendere le AWS SAMCLI funzionalità.
Valori accettati:
terraform
. --manifest , -m
PATH
-
Il percorso di un file manifesto delle dipendenze personalizzato (ad esempio, package.json) da utilizzare al posto di quello predefinito.
--parallel
-
Compilazioni parallele abilitate. Usa questa opzione per creare le funzioni e i livelli del tuo AWS SAM modello in parallelo. Per impostazione predefinita, le funzioni e i livelli vengono creati in sequenza.
--parameter-overrides
-
(Facoltativo) Una stringa che contiene le sostituzioni AWS CloudFormation dei parametri codificate come coppie chiave-valore. Utilizza lo stesso formato di (). AWS Command Line Interface AWS CLI Ad esempio: '
ParameterKey
=KeyPairName
,ParameterValue
MyKey
ParameterKey
=InstanceType
,ParameterValue
=t1.micro
'. Questa opzione non è compatibile con--hook-name
. --profile
TEXT
-
Il profilo specifico del file delle credenziali che ottiene le AWS credenziali.
--region
TEXT
-
Il Regione AWS verso cui eseguire la distribuzione. Ad esempio, us-east-1.
--save-params
-
Salva i parametri forniti dalla riga di comando nel file di AWS SAM configurazione.
--skip-prepare-infra
-
Salta la fase di preparazione se non sono state apportate modifiche all'infrastruttura. Utilizzare con l'
--hook-name
opzione. --skip-pull-image
-
Specifica se il comando deve ignorare l'estrazione dell'ultima immagine Docker per il runtime Lambda.
--template-file, --template, -t
PATH
-
Il percorso e il nome del file modello. AWS SAM
[default: template.[yaml|yml]]
Questa opzione non è compatibile con--hook-name
. --terraform-project-root-path
-
Il percorso relativo o assoluto della directory di primo livello contenente i file di Terraform configurazione o il codice sorgente della funzione. Se questi file si trovano all'esterno della directory contenente il modulo Terraform root, utilizzate questa opzione per specificarne il percorso assoluto o relativo. Questa opzione richiede che
--hook-name
sia impostata suterraform
. --use-container
,-u
-
Se le tue funzioni dipendono da pacchetti che hanno dipendenze compilate in modo nativo, usa questa opzione per creare la tua funzione all'interno di un contenitore Docker simile a Lambda.