sam deploy

Imposta la variabile di SAM_CLI_POLL_DELAY ambiente con un valore di secondi nella shell per configurare la frequenza con cui AWS SAM CLI controlla lo stato dello CloudFormation stack, il che è utile in caso di limitazione da. CloudFormation Questa variabile env viene utilizzata per il polling delle chiamate describe_stack API, 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 CloudFormation di determinati stack. Alcuni modelli di stack potrebbero includere risorse che influiscono sulle autorizzazioni Account AWS, ad esempio creando nuovi utenti AWS Identity and Access Management (IAM). Per questi stack, devi 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.

Quando si distribuisce un'applicazione che contiene applicazioni nidificate, è necessario utilizzare CAPABILITY_AUTO_EXPAND per confermare che l'applicazione contiene applicazioni nidificate. 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 SAMCLIfile 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 cartella principale della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta AWS SAMCLIfile di configurazione.

Richiede di confermare se AWS SAMCLI distribuisce il changeset calcolato.

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

Specifica se ripristinare lo CloudFormation stack se si verifica un errore durante una distribuzione. Per impostazione predefinita, se si verifica un errore durante una distribuzione, lo CloudFormation stack torna all'ultimo stato stabile. Se specifichi --disable-rollback e si verifica un errore durante una distribuzione, le risorse create o aggiornate prima che si verificasse l'errore non vengono ripristinate.

Specifica se utilizzare la modalità CloudFormation Express. Quando è attiva, le operazioni sullo stack vengono completate una volta applicata la configurazione delle risorse. Le risorse continuano a essere pronte in background. I tempi di implementazione possono essere ridotti fino a 4 volte.

AWS SAMCLIPassa il comportamento di rollback al CloudFormation DeploymentConfig parametro quando lo specifichi anche tu. --disable-rollback

Il valore predefinito è --no-express.

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

Specifica 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 visualizzare le istruzioni AWS SAMCLI d'uso per guidarvi nella distribuzione.

Mostra questo messaggio ed esci.

Una mappatura delle funzioni all'URI del loro repository Amazon ECR. Fai riferimento alle funzioni in base al loro 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 repository Amazon ECR in cui questo comando carica l'immagine della funzione. Questa opzione è obbligatoria per le funzioni dichiarate con il Image tipo di pacchetto.

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

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 allo stack prima di applicare il changeset. Questo comando crea un 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 ARN tematici di Amazon Simple Notification Service (Amazon SNS) associati allo stack. CloudFormation

Specifica l'azione da intraprendere quando uno stack non riesce a creare.

Sono disponibili le seguenti opzioni:

Il comportamento predefinito è ROLLBACK.

Il formato dell'output del comando:

Una distribuzione viene eseguita per un periodo di tempo. Quando si specifica--output json, AWS SAMCLI stampa un flusso di oggetti JSON, uno per riga, man mano che la distribuzione procede. Ogni oggetto include un type campo che identifica il tipo di informazioni che contiene, ad esempio il changeset, gli eventi di distribuzione, gli output dello stack e il risultato finale. In caso di errore, l'oggetto finale include un error oggetto che descrive cosa è andato storto.

Una stringa che contiene le sostituzioni CloudFormation dei parametri codificate come coppie chiave-valore. Ogni sostituzione utilizza il formato. ParameterKey=name,ParameterValue=value Le sostituzioni multiple sono separate da spazi. 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

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

Crea automaticamente repository Amazon ECR 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, viene AWS SAMCLI --resolve-image-repos ignorata.

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

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

Il nome del bucket Amazon S3 in cui questo comando carica il modello. CloudFormation Se il modello è più grande di 51.200 byte, è richiesta 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 è il nome del percorso (nome della cartella) per il bucket Amazon S3.

Salva i parametri forniti 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 CloudFormation stack in cui stai distribuendo. Se si specifica uno stack esistente, il comando aggiorna lo stack. Se si specifica un nuovo stack, il comando lo crea.

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

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

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