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 dell'interfaccia a riga di comando EB
<a name="eb-cli3-configuration"></a>

Dopo aver [installato l'EB CLI](eb-cli3.md#eb-cli3-install), siete pronti per configurare la directory del progetto e l'EB CLI eseguendola**eb init**. L'esempio seguente mostra i passaggi di configurazione quando si esegue **eb init** per la prima volta in una cartella di progetto denominata. `eb`

**Per inizializzare un progetto dell'interfaccia a riga di comando EB**

1. In primo luogo, l'interfaccia a riga di comando EB ti chiede di selezionare una regione. Scegli la tua regione preferita.

   ```
   ~/eb $ eb init
   Select a default region
   1) us-east-1 : US East (N. Virginia)
   2) us-west-1 : US West (N. California)
   3) us-west-2 : US West (Oregon)
   4) eu-west-1 : Europe (Ireland)
   5) eu-central-1 : Europe (Frankfurt)
   6) ap-south-1 : Asia Pacific (Mumbai)
   7) ap-southeast-1 : Asia Pacific (Singapore)
   ...
   (default is 3): 3
   ```

1. Se richiesto, fornisci la tua chiave di accesso e la chiave segreta in modo che l'EB CLI possa gestire le risorse per te. Le chiavi di accesso vengono create nella AWS Identity and Access Management console. Se non disponi delle chiavi, consulta l'argomento che descrive [come ottenere le credenziali di sicurezza](https://docs.aws.amazon.com/general/latest/gr/getting-aws-sec-creds.html) in *Riferimenti generali di Amazon Web Services*.

   ```
   You have not yet set up your credentials or your credentials are incorrect.
   You must provide your credentials.
   (aws-access-id): {{AKIAJOUAASEXAMPLE}}
   (aws-secret-key): {{5ZRIrtTM4ciIAvd4EXAMPLEDtm+PiPSzpoK}}
   ```

1. Un'applicazione Elastic Beanstalk è una risorsa che contiene un set di versioni dell'applicazione (origine), ambienti e configurazioni salvate associati a una singola applicazione Web. Ogni volta che distribuisci il codice sorgente per Elastic Beanstalk utilizzando la CLI EB, una nuova versione dell'applicazione viene creata e aggiunta all'elenco.

   ```
   Select an application to use
   1) [ Create new Application ]
   (default is 1): 1
   ```

1. Il nome predefinito dell'applicazione è il nome della cartella in cui esegui **eb init**. Inserisci un nome che descrive il tuo progetto.

   ```
   Enter Application Name
   (default is "eb"): eb
   Application eb has been created.
   ```

1. Seleziona una piattaforma che corrisponda al framework o al linguaggio con cui è stata sviluppata la tua applicazione Web. Se non hai iniziato a sviluppare un'applicazione, scegli una piattaforma che ti interessa. Visualizzerai come avviare un'applicazione di esempio a breve, e puoi sempre modificare questa impostazione in un secondo momento.

   ```
   Select a platform.
   1) .NET Core on Linux
   2) .NET on Windows Server
   3) Docker
   4) Go
   5) Java
   6) Node.js
   7) PHP         <== select platform by number
   8) Packer
   9) Python
   10) Ruby
   11) Tomcat
   (make a selection):7
   ```

1. Seleziona un ramo specifico della piattaforma.

   ```
   Select a platform branch.
   1) PHP 8.4 running on 64bit Amazon Linux 2023
   2) PHP 8.3 running on 64bit Amazon Linux 2023
   3) PHP 8.2 running on 64bit Amazon Linux 2023
   4) PHP 8.1 running on 64bit Amazon Linux 2023
   5) PHP 8.1 running on 64bit Amazon Linux 2
   (default is 1):1
   ```

1. Scegli **yes (sì)** per assegnare una coppia di chiavi SSH alle istanze nel tuo ambiente Elastic Beanstalk. In questo modo ci si connette direttamente per la risoluzione dei problemi.

   ```
   Do you want to set up SSH for your instances?
   (y/n): y
   ```

1. Seleziona una coppia di chiavi esistente o creane una nuova. Per utilizzare **eb init** per creare una nuova coppia di chiavi, **ssh-keygen** deve essere installato nel computer locale e disponibile dalla riga di comando. L'EB CLI registra EC2 per te la nuova coppia di chiavi con Amazon e archivia la chiave privata localmente in una cartella denominata `.ssh` nella tua directory utente.

   ```
   Select a keypair.
   1) [ Create new KeyPair ]
   (default is 1): 1
   ```

L'installazione dell'interfaccia a riga di comando EB è ora configurata e pronta all'uso.

**Topics**
+ [File ignorati con .ebignore](#eb-cli3-ebignore)
+ [Utilizzo di profili denominati](#eb-cli3-profile)
+ [Distribuzione di artifact invece della cartella del progetto](#eb-cli3-artifact)
+ [Impostazioni di configurazione e precedenza](#eb-cli3-credentials)
+ [Metadati delle istanze](#eb-cli3-metadata)

## File ignorati con .ebignore
<a name="eb-cli3-ebignore"></a>

Puoi stabilire che l'interfaccia a riga di comando EB ignori alcuni file nella directory di progetto aggiungendo il file `.ebignore` alla directory. Questo file funziona come un file `.gitignore`. Quando distribuisci la directory del progetto in Elastic Beanstalk e crei una nuova versione dell'applicazione, la CLI EB non include i file specificati da `.ebignore` nel bundle di origine creato.

Se `.ebignore` non è presente ma è disponibile `.gitignore`, l'interfaccia a riga di comando EB ignora i file specificati in `.gitignore`. Se `.ebignore` è presente, l'interfaccia a riga di comando EB non legge `.gitignore`.

Quando `.ebignore` è presente, l'interfaccia a riga di comando EB non utilizza i comandi git per creare il bundle di origine. Questo significa che la CLI EB ignora i file specificati in `.ebignore` e include tutti gli altri file. In particolare, include i file sorgente non eseguiti.

**Nota**  
In Windows, se aggiungi `.ebignore`, l'interfaccia a riga di comando EB segue i collegamenti simbolici e include il file collegato durante la creazione di un bundle di origine. Si tratta di un problema noto e verrà risolto in un aggiornamento futuro.

## Utilizzo di profili denominati
<a name="eb-cli3-profile"></a>

Se archivi le credenziali come un profilo denominato in un file `credentials` o `config`, puoi utilizzare l'opzione [`--profile`](eb3-cmd-options.md) per specificare un profilo in modo esplicito. Ad esempio, il comando seguente crea una nuova applicazione utilizzando il profilo `user2`.

```
$ eb init --profile {{user2}}
```

Puoi inoltre modificare il profilo predefinito impostando la variabile di ambiente `AWS_EB_PROFILE`. Quando questa variabile è impostata, l'interfaccia a riga di comando EB legge le credenziali del profilo specificato anziché `default` o **eb-cli**.

**Linux, macOS o Unix**

```
$ export AWS_EB_PROFILE={{user2}}
```

**Windows**

```
> set AWS_EB_PROFILE={{user2}}
```

## Distribuzione di artifact invece della cartella del progetto
<a name="eb-cli3-artifact"></a>

Puoi chiedere all'interfaccia a riga di comando EB di distribuire un file WAR o ZIP generato come parte di un processo di creazione separato aggiungendo le seguenti righe `.elasticbeanstalk/config.yml` alla cartella del tuo progetto.

```
deploy:
  artifact: {{path/to/buildartifact.zip}}
```

Se configuri l'interfaccia a riga di comando EB nel tuo [archivio Git](eb3-cli-git.md) e non esegui il commit dell'artefatto all'origine, utilizza l'opzione `--staged` per distribuire la compilazione più recente.

```
~/eb$ eb deploy --staged
```

## Impostazioni di configurazione e precedenza
<a name="eb-cli3-credentials"></a>

L'EB CLI utilizza una *catena di provider* per cercare AWS le credenziali in diversi punti, tra cui variabili di ambiente di sistema o utente e file di configurazione locali AWS .

L'interfaccia a riga di comando EB cerca le credenziali e le impostazioni di configurazione nell'ordine seguente:

1. **Opzioni della riga di comando**: specifica un profilo denominato utilizzando `--profile` per sovrascrivere le impostazioni predefinite.

1. **Variabili di ambiente**: `AWS_ACCESS_KEY_ID` e `AWS_SECRET_ACCESS_KEY`.

1. **Il file AWS delle credenziali**: si trova `~/.aws/credentials` nei sistemi Linux e OS X o nei sistemi Windows. `C:\Users\{{USERNAME}}\.aws\credentials` Questo file può contenere più profili denominati in aggiunta a un profilo predefinito.

1. **[File di configurazione della AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-config-files)**: disponibile nei `~/.aws/config` sistemi Linux e OS X o nei `C:\Users\{{USERNAME}}\.aws\config` sistemi Windows. Questo file può contenere un profilo predefinito, [profili denominati](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-multiple-profiles) e parametri di configurazione AWS CLI specifici per ciascuno di essi.

1. **File di configurazione legacy della CLI EB**: disponibile in `~/.elasticbeanstalk/config` nei sistemi Linux e OS X o in `C:\Users\{{USERNAME}}\.elasticbeanstalk\config` nei sistemi Windows.

1. **Credenziali del profilo di istanza**: queste credenziali possono essere utilizzate su EC2 istanze Amazon con un ruolo di istanza assegnato e vengono fornite tramite il servizio di metadati Amazon EC2 . Il [profilo dell'istanza](concepts-roles-instance.md) deve disporre delle autorizzazioni per utilizzare Elastic Beanstalk.

Se il file delle credenziali contiene un profilo denominato con il nome "eb-cli", l'interfaccia a riga di comando EB preferirà quel profilo al profilo predefinito. Se non vengono trovati profili o viene trovato un profilo che non dispone delle autorizzazioni per utilizzare Elastic Beanstalk, la CLI EB richiede di immettere le chiavi.

## Metadati delle istanze
<a name="eb-cli3-metadata"></a>

Per utilizzare l'EB CLI da un' EC2 istanza Amazon, crea un ruolo che abbia accesso alle risorse necessarie e assegna quel ruolo all'istanza quando viene lanciata. Avvia l'istanza e installa l'interfaccia a riga di comando di EB utilizzando `pip`.

```
~$ sudo pip install awsebcli
```

`pip` è preinstallato su Amazon Linux.

L'interfaccia a riga di comando di EB legge le credenziali dai metadata dell'istanza. Per ulteriori informazioni, consulta [Concedere alle applicazioni eseguite su Amazon EC2 Instances l'accesso alle AWS risorse](https://docs.aws.amazon.com/IAM/latest/UserGuide/role-usecase-ec2app.html) nella *IAM User Guide*.