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

# Configurazione del AWS SAMCLI
<a name="using-sam-cli-configure"></a>

Uno dei vantaggi AWS SAM è che ottimizza il tempo dello sviluppatore eliminando le attività ripetitive. AWS SAMCLIinclude un file di configurazione denominato a questo `samconfig` scopo. Per impostazione predefinita, non AWS SAMCLI è necessaria alcuna configurazione, ma è possibile aggiornare il file di configurazione per consentire di eseguire comandi con un minor numero di parametri, consentendo invece di fare riferimento AWS SAM ai parametri personalizzati nel file di configurazione. Gli esempi nella tabella seguente mostrano come ottimizzare i comandi:


| Originale | Ottimizzato con `samconfig` | 
| --- | --- | 
| **sam build --cached --parallel --use-containers** | **sam build** | 
| **sam local invoke --env-vars locals.json** | **sam local invoke** | 
| **sam local start-api --env-vars locals.json --warm-containers EAGER** | **sam local start-api** | 

 AWS SAMCLIFornisce una serie di comandi per aiutare gli sviluppatori a creare, sviluppare e distribuire applicazioni serverless. Ciascuno di questi comandi è configurabile con flag opzionali in base alle preferenze dell'applicazione e dello sviluppatore. [Per ulteriori informazioni, consulta il contenuto in AWS SAMCLI GitHub](https://github.com/aws/aws-sam-cli)

Gli argomenti di questa sezione mostrano come creare [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md) e personalizzare le impostazioni predefinite per ottimizzare i tempi di sviluppo dell'applicazione serverless.

**Topics**
+ [Come creare il file di configurazione (il `samconfig` file)](#using-sam-cli-configure-create)
+ [Configura le impostazioni del progetto](#using-sam-cli-configure-project)
+ [Configurare le credenziali e le impostazioni di base](#using-sam-cli-configure-basic)

## Come creare il file di configurazione (il `samconfig` file)
<a name="using-sam-cli-configure-create"></a>

Il file di AWS SAMCLI configurazione (filename`samconfig`) è un file di testo che in genere utilizza la struttura TOML, ma può anche essere in YAML. Quando si utilizza un modello AWS Quick Start, questo file viene creato quando si esegue il comando. **sam init** È possibile aggiornare questo file quando si distribuisce un'applicazione utilizzando il **sam deploy -\$1-guided** comando.

Una volta completata la distribuzione, il `samconfig` file contiene un profilo denominato `default` se sono stati utilizzati i valori predefiniti. Quando si esegue nuovamente il **deploy** comando, AWS SAM applica le impostazioni di configurazione memorizzate da questo profilo.

Il vantaggio del `samconfig` file è che AWS SAM memorizza le impostazioni di configurazione per tutti gli altri comandi disponibili oltre al comando deploy. Oltre a questi valori creati durante una nuova distribuzione, nel `samconfig` file è possibile impostare una serie di attributi che possono semplificare altri aspetti del flusso di lavoro degli sviluppatori. AWS SAMCLI

## Configura le impostazioni del progetto
<a name="using-sam-cli-configure-project"></a>

È possibile specificare impostazioni specifiche del progetto, ad esempio i valori dei parametri dei AWS SAMCLI comandi, in un file di configurazione da utilizzare con. AWS SAMCLI Per ulteriori informazioni su questo file di configurazione, vedere. [AWS SAMCLIfile di configurazione](serverless-sam-cli-config.md)

### Utilizzo dei file di configurazione
<a name="using-sam-cli-configure-project-using"></a>

I file di configurazione sono strutturati per ambiente, comando e valore dei parametri. Per ulteriori informazioni, consulta [Nozioni di base sui file di configurazione](serverless-sam-cli-config.md#serverless-sam-cli-config-basics).

**Per configurare un nuovo ambiente**

1. Specificate il nuovo ambiente nel file di configurazione.

   Di seguito è riportato un esempio di specificazione di un nuovo `prod` ambiente:

------
#### [ TOML ]

   ```
   [prod.global.parameters]
   ```

------
#### [ YAML ]

   ```
   prod:
     global:
       parameters:
   ```

------

1. Specificate i valori dei parametri come coppie chiave-valore nella sezione parametri del file di configurazione.

   Di seguito è riportato un esempio di specificazione del nome dello stack dell'applicazione per l'ambiente. `prod`

------
#### [ TOML ]

   ```
   [prod.global.parameters]
   stack_name = "prod-app"
   ```

------
#### [ YAML ]

   ```
   prod:
     global:
       parameters:
         stack_name: prod-app
   ```

------

1. Usa l'`--config-env`opzione per specificare l'ambiente da usare.

   Di seguito è riportato un esempio:

   ```
   $ sam deploy --config-env "prod"
   ```

**Per configurare i valori dei parametri**

1. Specificate il AWS SAMCLI comando per cui desiderate configurare i valori dei parametri. Per configurare i valori dei parametri per tutti AWS SAMCLI i comandi, usa l'`global`identificatore.

   Di seguito è riportato un esempio di specificazione dei valori dei parametri per il comando `default` dell'ambiente: `sam deploy`

------
#### [ TOML ]

   ```
   [default.deploy.parameters]
   confirm_changeset = true
   ```

------
#### [ YAML ]

   ```
   default:
     deploy:
       parameters:
         confirm_changeset: true
   ```

------

   Di seguito è riportato un esempio di specificazione dei valori dei parametri per tutti i AWS SAMCLI comandi nell'`default`ambiente:

------
#### [ TOML ]

   ```
   [default.global.parameters]
   stack_name = "sam-app"
   ```

------
#### [ YAML ]

   ```
   default:
     global:
       parameters:
         stack_name: sam-app
   ```

------

1. È inoltre possibile specificare i valori dei parametri e modificare il file di configurazione tramite il flusso AWS SAMCLI interattivo.

   Di seguito è riportato un esempio del flusso `sam deploy --guided` interattivo:

   ```
   $ sam deploy --guided
   
   Configuring SAM deploy
   ======================
   
       Looking for config file [samconfig.toml] :  Found
       Reading default arguments  :  Success
   
       Setting default arguments for 'sam deploy'
       =========================================
       Stack Name [sam-app]: ENTER
       AWS Region [us-west-2]: ENTER
       #Shows you resources changes to be deployed and require a 'Y' to initiate deploy
       Confirm changes before deploy [Y/n]: n
       #SAM needs permission to be able to create roles to connect to the resources in your template
       Allow SAM CLI IAM role creation [Y/n]: ENTER
       #Preserves the state of previously provisioned resources when an operation fails
       Disable rollback [y/N]: ENTER
       HelloWorldFunction may not have authorization defined, Is this okay? [y/N]: y
       Save arguments to configuration file [Y/n]: ENTER
       SAM configuration file [samconfig.toml]: ENTER
       SAM configuration environment [default]: ENTER
   ```

Per ulteriori informazioni, consulta [Creazione e modifica dei file di configurazione](serverless-sam-cli-config.md#serverless-sam-cli-config-using).

### Esempi
<a name="using-sam-cli-configure-project-examples"></a>

#### TOMLEsempio di base
<a name="using-sam-cli-configure-project-examples-toml"></a>

Di seguito è riportato un esempio di file di `samconfig.toml` configurazione:

```
...
version = 0.1

[default]
[default.global]
[default.global.parameters]
stack_name = "sam-app"

[default.build.parameters]
cached = true
parallel = true

[default.deploy.parameters]
capabilities = "CAPABILITY_IAM"
confirm_changeset = true
resolve_s3 = true

[default.sync.parameters]
watch = true

[default.local_start_api.parameters]
warm_containers = "EAGER"

[prod]
[prod.sync]
[prod.sync.parameters]
watch = false
```

#### YAMLEsempio di base
<a name="using-sam-cli-configure-project-examples-yaml"></a>

Di seguito è riportato un esempio di file di `samconfig.yaml` configurazione:

```
version 0.1
default:
  global:
    parameters:
      stack_name: sam-app
  build:
    parameters:
      cached: true
      parallel: true
  deploy:
    parameters:
      capabilities: CAPABILITY_IAM
      confirm_changeset: true
      resolve_s3: true
  sync:
    parameters:
      watch: true
  local_start_api:
    parameters:
      warm_containers: EAGER
prod:
  sync:
    parameters:
      watch: false
```

## Configurare le credenziali e le impostazioni di base
<a name="using-sam-cli-configure-basic"></a>

Usa AWS Command Line Interface (AWS CLI) per configurare le impostazioni di base come AWS credenziali, nome dell'area predefinita e formato di output predefinito. Una volta configurate, è possibile utilizzare queste impostazioni con. AWS SAMCLI Per ulteriori informazioni, consulta quanto segue nella *Guida AWS Command Line Interface per l'utente*:
+ [Nozioni di base sulla configurazione](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html)
+ [Impostazioni dei file di configurazione e credenziali](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
+ [Profili denominati per AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)
+ [Utilizzo di un profilo denominato abilitato per IAM Identity Center](https://docs.aws.amazon.com/cli/latest/userguide/sso-using-profile.html)

Per istruzioni di configurazione rapide, consulta[Passaggio 5: Utilizzare AWS CLI per configurare le AWS credenziali](prerequisites.md#prerequisites-configure-credentials).