sam deploy

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model comando Command Line Interface (AWS SAMCLI)sam deploy.

• Per un'introduzione a AWS SAMCLI, vedereChe cos'è il? AWS SAMCLI.

• Per la documentazione sull'uso del AWS SAMCLI sam deploy comando, vedereIntroduzione alla distribuzione con il comando sam deploy.

Il sam deploy comando distribuisce un'applicazione all'utente Cloud AWS . AWS CloudFormation

Utilizzo

$ <environment variables> sam deploy <options>

Variabili di ambiente

SAM_CLI_POLL_DELAY

Imposta la variabile di SAM_CLI_POLL_DELAY ambiente con un valore di secondi per configurare la frequenza con cui la CLI AWS SAM controlla lo stato dello AWS CloudFormation stack, utile quando si verifica la limitazione da. AWS CloudFormation Questa variabile env viene utilizzata per il polling delle chiamate describe_stack API, che vengono effettuate durante l'esecuzione. sam deploy

Di seguito è riportato un esempio di questa variabile:

$ SAM_CLI_POLL_DELAY=5 sam deploy

Opzioni

--capabilities LIST

Un elenco di funzionalità che è necessario specificare per consentire la creazione AWS CloudFormation di determinati stack. Alcuni modelli di stack potrebbero includere risorse che influiscono sulle autorizzazioni dell'utente Account AWS, ad esempio creando nuovi utenti AWS Identity and Access Management (IAM). Per questi stack, è necessario riconoscerne esplicitamente le funzionalità specificando questa opzione. Gli unici valori validi sono CAPABILITY_IAM e CAPABILITY_NAMED_IAM. Se disponi di risorse IAM, puoi specificare entrambe le funzionalità. Se disponi di risorse IAM con nomi personalizzati, devi specificareCAPABILITY_NAMED_IAM. Se non specifichi questa opzione, l'operazione restituisce un InsufficientCapabilities errore.

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

--confirm-changeset | --no-confirm-changeset

Richiede di confermare se AWS SAMCLI distribuisce il changeset calcolato.

--debug

Attiva la registrazione di debug per stampare il messaggio di debug generato e per visualizzare i timestamp. AWS SAMCLI

--disable-rollback | --no-disable-rollback

Specificate se ripristinare lo AWS CloudFormation stack se si verifica un errore durante una distribuzione. Per impostazione predefinita, se si verifica un errore durante una distribuzione, lo AWS CloudFormation stack torna all'ultimo stato stabile. Se si specifica --disable-rollback e si verifica un errore durante una distribuzione, non viene eseguito il rollback delle risorse create o aggiornate prima che si verificasse l'errore.

--fail-on-empty-changeset | --no-fail-on-empty-changeset

Specificate se restituire un codice di uscita diverso da zero se non ci sono modifiche da apportare allo stack. Il comportamento predefinito consiste nel restituire un codice di uscita diverso da zero.

--force-upload

Specificate questa opzione per caricare gli artefatti anche se corrispondono agli artefatti esistenti nel bucket Amazon S3. Gli artefatti corrispondenti vengono sovrascritti.

--guided, -g

Specificate questa opzione per far sì che i prompt di AWS SAMCLI utilizzo vi guidino nella distribuzione.

--help

Mostra questo messaggio ed esci.

--image-repositories TEXT

Una mappatura delle funzioni sull'URI del loro repository Amazon ECR. Funzioni di riferimento in base al relativo ID logico. Di seguito è riportato un esempio:

$ sam deploy --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo

È possibile specificare questa opzione più volte in un unico comando.

--image-repository TEXT

Il nome dell'archivio Amazon ECR in cui questo comando carica l'immagine della tua funzione. Questa opzione è necessaria per le funzioni dichiarate con il Image tipo di pacchetto.

--kms-key-id TEXT

L'ID di una chiave AWS Key Management Service (AWS KMS) utilizzata per crittografare gli artefatti che sono a riposo nel bucket Amazon S3. Se non specifichi questa opzione, AWS SAM utilizza le chiavi di crittografia gestite da Amazon S3.

--metadata

Una mappa di metadati da allegare a tutti gli artefatti a cui si fa riferimento nel modello.

--no-execute-changeset

Indica se applicare il changeset. Specificate questa opzione se desiderate visualizzare le modifiche apportate allo stack prima di applicare il changeset. Questo comando crea un AWS CloudFormation changeset e quindi esce senza applicare il changeset. Per applicare il changeset, esegui lo stesso comando senza questa opzione.

--no-progressbar

Non visualizzare una barra di avanzamento durante il caricamento di artefatti su Amazon S3.

--notification-arns LIST

Un elenco di ARN tematici di Amazon Simple Notification Service (Amazon SNS) associati allo stack AWS CloudFormation .

--on-failure [ROLLBACK | DELETE | DO_NOTHING]

Specificate l'azione da intraprendere quando la creazione di uno stack non riesce.

Sono disponibili le seguenti opzioni:

• ROLLBACK— Riporta lo stack a uno stato precedente noto come buono.

• DELETE— Riporta la pila a uno stato precedente noto come buono, se ne esiste uno. Altrimenti, elimina lo stack.

• DO_NOTHING— Non ripristina né elimina lo stack. L'effetto è lo stesso di. --disable-rollback

Il comportamento predefinito è ROLLBACK.

Nota

È possibile specificare l'--disable-rollbackopzione o l'--on-failureopzione, ma non entrambe.

--parameter-overrides

Una stringa che contiene le sostituzioni AWS CloudFormation dei parametri codificate come coppie chiave-valore. Utilizzate lo stesso formato di (). AWS Command Line Interface AWS CLI Ad esempio, ParameterKey=ParameterValue InstanceType=t1.micro.

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

--resolve-image-repos

Crea automaticamente repository Amazon ECR da utilizzare per il packaging e la distribuzione per distribuzioni non guidate. Questa opzione si applica solo alle funzioni e ai livelli specificati. PackageType: Image Se si specifica l'--guidedopzione, la AWS SAMCLI ignora. --resolve-image-repos

Nota

Se crea AWS SAM automaticamente un archivio Amazon ECR per funzioni o livelli con questa opzione e successivamente elimini tali funzioni o livelli dal AWS SAM modello, i repository Amazon ECR corrispondenti vengono eliminati automaticamente.

--resolve-s3

Crea automaticamente un bucket Amazon S3 da utilizzare per il packaging e la distribuzione per distribuzioni non guidate. Se si specifica l'--guidedopzione, la AWS SAM CLI la ignora. --resolve-s3 Se si specificano entrambe le --resolve-s3 opzioni --s3-bucket e, si verifica un errore.

--role-arn TEXT

L'Amazon Resource Name (ARN) di un ruolo IAM che AWS CloudFormation assume quando si applica il changeset.

--s3-bucket TEXT

Il nome del bucket Amazon S3 in cui questo comando carica il modello. AWS CloudFormation Se il modello è più grande di 51.200 byte, è necessaria l'opzione o l'--s3-bucketopzione. --resolve-s3 Se si specificano entrambe le --resolve-s3 opzioni --s3-bucket e, si verifica un errore.

--s3-prefix TEXT

Il prefisso aggiunto ai nomi degli artefatti caricati nel bucket Amazon S3. Il nome del prefisso è un nome di percorso (nome della cartella) per il bucket Amazon S3.

--save-params

Salva i parametri che fornisci nella riga di comando nel file di configurazione. AWS SAM

--signing-profiles LIST

L'elenco dei profili di firma con cui firmare i pacchetti di distribuzione. Questa opzione richiede un elenco di coppie chiave-valore, in cui la chiave è il nome della funzione o del livello da firmare e il valore è il profilo di firma, con un proprietario del profilo opzionale delimitato da. : Ad esempio, FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner.

--stack-name TEXT

(Obbligatorio) Il nome dello AWS CloudFormation stack in cui stai eseguendo la distribuzione. Se specificate uno stack esistente, il comando aggiorna lo stack. Se specificate un nuovo stack, il comando lo crea.

--tags LIST

Un elenco di tag da associare allo stack creato o aggiornato. AWS CloudFormation propaga inoltre questi tag alle risorse dello stack che li supportano.

--template-file, --template, -t PATH

Il percorso e il nome del file in cui si trova il AWS SAM modello.

Nota

Se si specifica questa opzione, AWS SAM distribuisce solo il modello e le risorse locali a cui punta.

--use-json

Esporta JSON per il modello. AWS CloudFormation L'output predefinito è YAML.