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 deploy
<a name="sam-cli-command-reference-sam-deploy"></a>

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, vedere [Che cos'è il? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Per la documentazione sull'uso del AWS SAMCLI `sam deploy` comando, vedere[Introduzione alla distribuzione con AWS SAM](using-sam-cli-deploy.md).

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

## Utilizzo
<a name="ref-sam-cli-deploy-usage"></a>

```
$ <environment variables> sam deploy <options>
```

## Variabili di ambiente
<a name="ref-sam-cli-deploy-env"></a>

`SAM_CLI_POLL_DELAY`  <a name="ref-sam-cli-deploy-env-sam-cli-poll-delay"></a>
Imposta la variabile di `SAM_CLI_POLL_DELAY` ambiente con un valore di secondi nella shell per configurare la frequenza con cui la CLI AWS SAM controlla lo stato dello CloudFormation stack, il che è utile quando si verifica la limitazione da. 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
<a name="ref-sam-cli-deploy-options"></a>

`--capabilities LIST`  <a name="ref-sam-cli-deploy-options-capabilities"></a>
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 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 specificare`CAPABILITY_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](serverless-sam-template-nested-applications.md#serverless-sam-templates-nested-applications-deploying).

`--config-env TEXT`  <a name="ref-sam-cli-deploy-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-deploy-options-config-file"></a>
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](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="ref-sam-cli-deploy-options-confirm-changeset"></a>
Richiede di confermare se AWS SAMCLI distribuisce il changeset calcolato.

`--debug`  <a name="ref-sam-cli-deploy-options-debug"></a>
Attiva la registrazione di debug per stampare il messaggio di debug generato e per visualizzare i timestamp. AWS SAMCLI

`--disable-rollback | --no-disable-rollback`  <a name="ref-sam-cli-deploy-options-disable-rollback"></a>
Specificate 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 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`  <a name="ref-sam-cli-deploy-options-fail-on-empty-changeset"></a>
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`  <a name="ref-sam-cli-deploy-options-force-upload"></a>
Specificate questa opzione per caricare gli artefatti anche se corrispondono agli artefatti esistenti nel bucket Amazon S3. Gli artefatti corrispondenti vengono sovrascritti.

`--guided, -g`  <a name="ref-sam-cli-deploy-options-guided"></a>
Specificate questa opzione per far sì che i prompt di AWS SAMCLI utilizzo vi guidino nella distribuzione.

`--help`  <a name="ref-sam-cli-deploy-options-help"></a>
Mostra questo messaggio ed esci.

`--image-repositories TEXT`  <a name="ref-sam-cli-deploy-options-image-repositories"></a>
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`  <a name="ref-sam-cli-deploy-options-image-repository"></a>
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`  <a name="ref-sam-cli-deploy-options-kms-key-id"></a>
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`  <a name="ref-sam-cli-deploy-options-metadata"></a>
Una mappa di metadati da allegare a tutti gli artefatti a cui si fa riferimento nel modello.

`--no-execute-changeset`  <a name="ref-sam-cli-deploy-options-no-execute-changeset"></a>
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 CloudFormation changeset e quindi esce senza applicare il changeset. Per applicare il changeset, esegui lo stesso comando senza questa opzione.

`--no-progressbar`  <a name="ref-sam-cli-deploy-options-no-progressbar"></a>
Non visualizzare una barra di avanzamento durante il caricamento di artefatti su Amazon S3.

`--notification-arns LIST`  <a name="ref-sam-cli-deploy-options-notification-arns"></a>
Un elenco di ARNs argomenti di Amazon Simple Notification Service (Amazon SNS) associati allo CloudFormation stack.

`--on-failure [ROLLBACK | DELETE | DO_NOTHING]`  <a name="ref-sam-cli-deploy-options-on-failure"></a>
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`.  
È possibile specificare l'`--disable-rollback`opzione o l'`--on-failure`opzione, ma non entrambe.

`--parameter-overrides LIST`  <a name="ref-sam-cli-deploy-options-parameter-overrides"></a>
Una stringa che contiene le sostituzioni CloudFormation dei parametri codificate come coppie chiave-valore. Ogni override 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
```

`--profile TEXT`  <a name="ref-sam-cli-deploy-options-profile"></a>
Il profilo specifico del file delle credenziali che ottiene le credenziali. AWS 

`--region TEXT`  <a name="ref-sam-cli-deploy-options-region"></a>
Il Regione AWS verso cui eseguire la distribuzione. Ad esempio, us-east-1.

`--resolve-image-repos`  <a name="ref-sam-cli-deploy-options-resolve-image-repos"></a>
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'`--guided`opzione, la AWS SAMCLI ignora. `--resolve-image-repos`  
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`  <a name="ref-sam-cli-deploy-options-resolve-s3"></a>
Crea automaticamente un bucket Amazon S3 da utilizzare per il packaging e la distribuzione per distribuzioni non guidate. Se si specifica l'`--guided`opzione, 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`  <a name="ref-sam-cli-deploy-options-role-arn"></a>
L'Amazon Resource Name (ARN) di un ruolo IAM che CloudFormation assume quando si applica il changeset.

`--s3-bucket TEXT`  <a name="ref-sam-cli-deploy-options-s3-bucket"></a>
Il nome del bucket Amazon S3 in cui questo comando carica il modello. CloudFormation Se il modello è più grande di 51.200 byte, è necessaria l'opzione o l'`--s3-bucket`opzione. `--resolve-s3` Se si specificano entrambe le `--resolve-s3` opzioni `--s3-bucket` e, si verifica un errore.

`--s3-prefix TEXT`  <a name="ref-sam-cli-deploy-options-s3-prefix"></a>
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`  <a name="ref-sam-cli-deploy-options-save-params"></a>
Salva i parametri che fornisci nella riga di comando nel file di configurazione. AWS SAM 

`--signing-profiles LIST`  <a name="ref-sam-cli-deploy-options-signing-profiles"></a>
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`  <a name="ref-sam-cli-deploy-options-stack-name"></a>
(Obbligatorio) Il nome dello 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`  <a name="ref-sam-cli-deploy-options-tags"></a>
Un elenco di tag da associare allo stack creato o aggiornato. CloudFormation propaga inoltre questi tag alle risorse dello stack che li supportano.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-deploy-options-template-file"></a>
Il percorso e il nome del file in cui si trova il AWS SAM modello.  
Se si specifica questa opzione, AWS SAM distribuisce solo il modello e le risorse locali a cui punta.

`--use-json`  <a name="ref-sam-cli-deploy-options-use-json"></a>
Esporta JSON per il modello. CloudFormation L'output predefinito è YAML.

## Esempio
<a name="sam-cli-command-reference-sam-deploy-examples"></a>

Per un esempio dettagliato e una procedura dettagliata sull'utilizzo del `sam deploy` sottocomando, fare riferimento a. [Introduzione alla distribuzione con AWS SAM](using-sam-cli-deploy.md)