sam deploy

Imposta la variabile di SAM_CLI_POLL_DELAY ambiente con un valore in secondi nella tua shell per configurare la frequenza con cui AWS SAM CLI controlli lo stato dello AWS CloudFormation stack, il che è utile quando vedi un throttling from. AWS CloudFormation Questa variabile env viene utilizzata per le describe_stack API chiamate di polling, che vengono effettuate durante l'esecuzione. sam deploy

Di seguito è riportato un esempio di questa variabile:

$ SAM_CLI_POLL_DELAY=5 sam deploy

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 AWS Identity and Access Management () IAM utenti. 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 IAM risorse, puoi specificare una delle due funzionalità. Se disponi di IAM risorse con nomi personalizzati, devi specificareCAPABILITY_NAMED_IAM. Se non si specifica questa opzione, l'operazione restituisce un InsufficientCapabilities errore.

Quando si distribuisce un'applicazione che contiene applicazioni annidate, è necessario utilizzare CAPABILITY_AUTO_EXPAND per confermare che l'applicazione contiene applicazioni successive. Per ulteriori informazioni, consulta Distribuzione di applicazioni annidate.

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 SAM CLI file di configurazione.

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 SAM CLI file di configurazione.

Richiede di confermare se AWS SAM CLI distribuisce il changeset calcolato.

Attiva la registrazione di debug per stampare il messaggio di debug che AWS SAM CLI genera e visualizza i timestamp.

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.

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.

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

Specificate questa opzione per avere AWS SAM CLI usa le istruzioni per guidarti nella distribuzione.

Mostra questo messaggio ed esci.

Una mappatura delle funzioni nel loro ECR repository URI Amazon. 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.

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

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.

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

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.

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

Un elenco di argomenti ARNs di Amazon Simple Notification Service (AmazonSNS) AWS CloudFormation associati allo stack.

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

Sono disponibili le seguenti opzioni:

Il comportamento predefinito è ROLLBACK.

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 La AWS SAM CLI il formato è costituito da parole chiave e valori esplicite, ogni override è separata da uno spazio. Di seguito, sono riportati due esempi:

$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2

$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2 ParameterKey=hello,ParameterValue=world ParameterKey=apple,ParameterValue=banana

Il profilo specifico del file delle credenziali che ottiene le credenziali. AWS

Il Regione AWS verso cui eseguire la distribuzione. Ad esempio, us-east-1.

Crea automaticamente ECR repository Amazon da utilizzare per la creazione di pacchetti 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, allora AWS SAM CLI ignora. --resolve-image-repos

Crea automaticamente un bucket Amazon S3 da utilizzare per la creazione di pacchetti e la distribuzione per distribuzioni non guidate. Se specifichi l'opzione, la --guided ignora. AWS SAM CLI --resolve-s3 Se si specificano entrambe le --resolve-s3 opzioni --s3-bucket e, si verifica un errore.

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

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.

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.

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

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.

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

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

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

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