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 esempio sam 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-containeropzione è specificata, altrimenti si verificherà un errore.

--build-in-source | --no-build-in-source

--build-in-sourceProvvedi a creare il tuo progetto direttamente nella cartella dei sorgenti.

L'--build-in-sourceopzione supporta i seguenti runtime e metodi di compilazione:

• Runtime: qualsiasi Node.js runtime supportato dall'sam init --runtimeopzione.

• Metodi di compilazione:Makefile,esbuild.

L'--build-in-sourceopzione 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-cachedopzione 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 voce requests=1.x e l'ultima versione del modulo di richiesta cambia da 1.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-containeropzione è 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-containeropzione è 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 contiene Function1Function2, e Function3 e lo eseguisam build --exclude Function2, solo Function1 e Function3 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-nameopzione.

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