

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

# **eb create**
<a name="eb3-create"></a>

## Description
<a name="eb3-createdescription"></a>

Crea un nuovo ambiente e distribuisce una versione dell'applicazione nell'ambiente.

**Nota**  
Per utilizzare **eb create** in una applicazione .NET, è necessario creare un pacchetto di distribuzione come descritto in [Creazione di un bundle di origine per un'applicazione .NET](applications-sourcebundle.md#using-features.deployment.source.dotnet), quindi impostare la configurazione della CLI per distribuire il pacchetto come un artefatto, come descritto in [Distribuzione di artifact invece della cartella del progetto](eb-cli3-configuration.md#eb-cli3-artifact).
La creazione di ambienti con CLI EB richiede un [ruolo del servizio](concepts-roles-service.md). Puoi creare un ruolo di servizio tramite la creazione di un ambiente nella console Elastic Beanstalk. Se non disponi di un ruolo del servizio, CLI EB tenta di crearne uno durante l'esecuzione di `eb create`.

Puoi distribuire la versione dell'applicazione da alcune origini:
+ Per impostazione predefinita: dal codice sorgente dell'applicazione nella directory di progetto locale.
+ Utilizzando l'opzione `--version`: da una versione dell'applicazione già esistente nell'applicazione.
+ Quando la directory del progetto non include codice dell'applicazione oppure usando l'opzione `--sample`: implementazione da un'applicazione di esempio, specifica per la piattaforma dell'ambiente.

## Sintassi
<a name="eb3-createsyntax"></a>

**eb create**

**eb create {{environment-name}}**

La lunghezza del nome di un ambiente deve essere compresa tra 4 e 40 caratteri. Il nome può includere solo lettere, numeri e trattini (-). I nomi degli ambienti non possono iniziare né terminare con un trattino.

Se includi un nome di ambiente nel comando, la CLI EB non richiede di effettuare alcuna selezione né di creare un ruolo di servizio.

Se esegui il comando senza un argomento del nome ambiente, questo viene eseguito in un flusso interattivo e ti viene richiesto di immettere o selezionare i valori per alcune impostazioni. Se in questo flusso interattivo distribuisci un'applicazione di esempio, la CLI EB ti chiede anche se vuoi scaricare l'applicazione di esempio nella directory di progetto locale. Dopo il download, potrai utilizzare la CLI EB con il nuovo ambiente in un secondo momento per eseguire operazioni che richiedono il codice dell'applicazione, ad esempio [**eb deploy**](eb3-deploy.md).

Alcuni prompt di flusso interattivi vengono visualizzati solo in determinate condizioni. Ad esempio, se si sceglie di utilizzare un Application Load Balancer, e l'account dispone di almeno un Application Load Balancer condivisibile, Elastic Beanstalk visualizza un messaggio che chiede se si desidera utilizzare un sistema di bilanciamento del carico condiviso. Questo prompt non viene visualizzato se nell'account non è presente un Application Load Balancer condivisibile.

## Opzioni
<a name="eb3-createoptions"></a>

Nessuna di queste opzioni è obbligatoria. Se esegui **eb create** senza opzioni, la CLI EB richiede di immettere o selezionare un valore per ogni impostazione.


****  

|  Nome  |  Descrizione  | 
| --- | --- | 
| `-d`<br />oppure<br />`--branch_default` | Imposta l'ambiente come l'ambiente predefinito per il repository corrente. | 
| `--cfg` {{config-name}} | [Utilizza le impostazioni della piattaforma da una configurazione salvata](environment-configuration-methods-during.md#configuration-options-during-ebcli-savedconfig) in `.elasticbeanstalk/saved_configs/` o nel bucket Amazon S3. Specifica solo il nome del file, senza l'estensione `.cfg.yml`. | 
| `-c` {{subdomain-name}}<br />or<br />`--cname` {{subdomain-name}} | Nome del sottodominio da anteporre alla voce DNS CNAME che instrada al sito Web.<br />Tipo: string<br />Impostazione predefinita: nome dell'ambiente | 
| `-db`<br />oppure<br />`--database` | Collega un database all'ambiente. Se esegui **eb create** con l'opzione `--database`, ma senza le opzioni `--database.username` e `--database.password`, la CLI EB richiede il nome utente e la password del database master. | 
| `-db.engine` {{engine}}<br />or<br />`--database.engine` {{engine}} | Il tipo di motore di database. Se esegui **eb create** con questa opzione, la CLI EB avvia l'ambiente con un database collegato. Questo accade anche se non hai eseguito il comando con l'opzione `--database`.<br />Tipo: string<br />Valori validi: `mysql`, `oracle-se1`, `postgres`, `sqlserver-ex`, `sqlserver-web`, `sqlserver-se` | 
| `-db.i` {{instance\_type}}<br />or<br />`--database.instance` {{instance\_type}} | Il tipo di EC2 istanza Amazon da utilizzare per il database. Se esegui **eb create** con questa opzione, la CLI EB avvia l'ambiente con un database collegato. Questo accade anche se non hai eseguito il comando con l'opzione `--database`.<br />Tipo: String<br />Valori validi:<br />Amazon RDS supporta un set standard di istanze database. Per selezionare un'istanza database appropriata per il motore database, è necessario tenere conto di alcune considerazioni specifiche. Per ulteriori informazioni, consulta la pagina relativa alle [classi di istanze database](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html) nella *Guida per l'utente di Amazon RDS*. | 
| `-db.pass` {{password}}<br />or<br />`--database.password` {{password}} | Password per il database. Se esegui **eb create** con questa opzione, la CLI EB avvia l'ambiente con un database collegato. Questo accade anche se non hai eseguito il comando con l'opzione `--database`. | 
| `-db.size` {{number\_of\_gigabytes}}<br />or<br />`--database.size` {{number\_of\_gigabytes}} | Numero di gigabyte (GB) da allocare per lo storage del database. Se esegui **eb create** con questa opzione, la CLI EB avvia l'ambiente con un database collegato. Questo accade anche se non hai eseguito il comando con l'opzione `--database`.<br />Tipo: numero<br />Valori validi:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/elasticbeanstalk/latest/dg/eb3-create.html) | 
| `-db.user` {{username}}<br />or<br />`--database.username` {{username}} | Nome utente per il database. Se esegui **eb create** con questa opzione, la CLI EB avvia l'ambiente con un database collegato anche se non hai eseguito il comando con l'opzione `--database`. Se esegui **eb create** con l'opzione `--database`, ma senza le opzioni `--database.username` e `--database.password`, la CLI EB richiede il nome utente e la password del database master. | 
| `-db.version` {{version}}<br />or<br />`--database.version` {{version}} | Utilizzato per specificare la versione del motore di database. Se questo flag è presente, l'ambiente viene avviato con un database con il numero di versione specificato, anche se il flag `--database` non è presente. | 
| `--elb-type` {{type}} | [Tipo di sistema di bilanciamento del carico](using-features.managing.elb.md).<br />Tipo: string<br />Valori validi: `classic`, `application`, `network`<br />Default: `application` | 
| `-es`<br />oppure<br />`--enable-spot` | Abilitare le richieste di istanze Spot per l'ambiente in uso. Per ulteriori informazioni, consulta [Gruppo Auto Scaling](using-features.managing.as.md).<br />Opzioni correlate:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/elasticbeanstalk/latest/dg/eb3-create.html) | 
| --env-group-suffix {{groupname}} | Il nome del gruppo a cui aggiungere il nome dell'ambiente. Da utilizzare solo con [ambienti Compose](ebcli-compose.md). | 
| `--envvars` | [Proprietà dell'ambiente](environments-cfg-softwaresettings.md) in un elenco separato da virgole con il formato =. {{name}} {{value}} Per informazioni sui limiti, consulta [Configurazione delle proprietà dell'ambiente (variabili di ambiente)](environments-cfg-softwaresettings.md#environments-cfg-softwaresettings-console). | 
| `-ip` {{profile\_name}}<br />or<br />`--instance_profile` {{profile\_name}} | Il profilo dell'istanza con il ruolo IAM con le credenziali di sicurezza temporanee necessarie all'applicazione per accedere alle risorse. AWS  | 
| `-it`<br />or<br />`-﻿-﻿instance-types {{type1}}[,{{type2}} ...]` | Un elenco separato da virgole dei tipi di EC2 istanze Amazon che desideri utilizzare nel tuo ambiente. Se non si specifica questa opzione, Elastic Beanstalk fornisce i tipi di istanza predefiniti.<br />Per ulteriori informazioni, consulta [ EC2 Istanze Amazon](using-features.managing.ec2.md) e [Gruppo Auto Scaling](using-features.managing.as.md). La CLI EB applica questa opzione solo alle istanze Spot. A meno che questa opzione non venga utilizzata con l'opzione `--enable-spot`, la CLI EB la ignora. Per specificare un tipo di istanza per un'istanza on demand, utilizzare l'opzione `--intance-type` (senza "s").   | 
| `-i`<br />or<br />`--instance_type` | Il tipo di EC2 istanza Amazon che desideri venga utilizzato dal tuo ambiente. Se non si specifica questa opzione, Elastic Beanstalk fornisce un tipo di istanza predefinito.<br />Per ulteriori informazioni, consulta [ EC2 Istanze Amazon](using-features.managing.ec2.md). La CLI EB applica questa opzione solo alle istanze on demand. Non utilizzare questa opzione con `--enable-spot`, perché la CLI EB la ignora. Per specificare un tipo di istanza per un'istanza Spot, utilizzare l'opzione `--intance-types` (senza "s").  | 
| `-k` {{key\_name}}<br />or<br />`--keyname` {{key\_name}} | Il nome della coppia di EC2 chiavi Amazon da utilizzare con il client Secure Shell (SSH) per accedere in modo sicuro alle EC2 istanze Amazon che eseguono l'applicazione Elastic Beanstalk. Se includi questa opzione con il comando **eb create**, il valore fornito sovrascrive qualsiasi nome di chiave specificato con **eb init**.<br />Valori validi: un nome chiave esistente registrato con Amazon EC2 | 
| `-im` {{number-of-instances}}<br />or<br />`--min-instances` {{number-of-instances}} | Il numero minimo di EC2 istanze Amazon di cui hai bisogno per il tuo ambiente.<br />Tipo: Number (integer)<br />Default: `1`<br />Valori validi: da `1` a `10000` | 
| `-ix` {{number-of-instances}}<br />or<br />`--max-instances` {{number-of-instances}} | Il numero massimo di EC2 istanze Amazon che il tuo ambiente può avere.<br />Tipo: Number (integer)<br />Default: `4`<br />Valori validi: da `1` a `10000` | 
| `--modules` {{component-a component-b}} | Un elenco degli ambienti di componente da creare. Da utilizzare solo con [ambienti Compose](ebcli-compose.md). | 
| `-sb`<br />oppure<br />`--on-demand-base-capacity` | Il numero minimo di istanze on demand di cui il gruppo Auto Scaling effettua il provisioning prima di considerare le istanze Spot durante la scalabilità dell'ambiente.<br />Questa opzione può essere specificata solo con l'opzione `--enable-spot`. Per ulteriori informazioni, consulta [Gruppo Auto Scaling](using-features.managing.as.md).<br />Tipo: Number (integer)<br />Default: `0`<br />Valori validi: `0` su `--max-instances` (quando assente: opzione `MaxSize` nello spazio dei nomi [`aws:autoscaling:asg`](command-options-general.md#command-options-general-autoscalingasg)) | 
| `-sp`<br />oppure<br />`--on-demand-above-base-capacity` | La percentuale di istanze on demand come parte della capacità aggiuntiva che il gruppo Auto Scaling fornisce in aggiunta al numero di istanze specificato dall'opzione `--on-demand-base-capacity`.<br />Questa opzione può essere specificata solo con l'opzione `--enable-spot`. Per ulteriori dettagli, consulta [Gruppo Auto Scaling](using-features.managing.as.md).<br />Tipo: Number (integer)<br />Impostazione predefinita: `0` per un ambiente a istanza singola; `70` per un ambiente con bilanciamento del carico<br />Valori validi: da `0` a `100` | 
| `-p` {{platform-version}}<br />or<br />`--platform` {{platform-version}} | La [versione della piattaforma](concepts.platforms.md) da utilizzare. Puoi specificare una piattaforma, una piattaforma e una versione della piattaforma, un nome dello stack di soluzioni o un ARN dello stack di soluzioni. Ad esempio:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/elasticbeanstalk/latest/dg/eb3-create.html)<br />Utilizza [`eb platform list`](eb3-platform.md) per ottenere un elenco delle configurazioni disponibili.<br />Se si specifica l'opzione `--platform`, ignora il valore fornito durante `eb init`. | 
| `-pr`<br />oppure<br />`--process` | Pre-elabora e convalida l'ambiente il manifest e i file di configurazione dell'ambiente nel bundle di origine. La convalida dei file di configurazione è in grado di identificare i problemi prima di distribuire la versione dell'applicazione in un ambiente. | 
| `-r` {{region}}<br />or<br />`--region` {{region}} | La AWS regione in cui desideri distribuire l'applicazione.<br />Per l'elenco dei valori che è possibile specificare per questa opzione, consulta [Endpoint e quote AWS Elastic Beanstalk](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) nella sezione *Riferimenti generali di AWS*. | 
| `--sample` | Distribuisce l'applicazione di esempio nel nuovo ambiente anziché il codice nel repository. | 
| `--scale` {{number-of-instances}} | Esegue l'avvio con il numero di istanze specificato | 
| --service-role {{servicerole}} | Assegna un ruolo di servizio non predefinito all'ambiente.  Non inserire un ARN. Inserisci solo il nome del ruolo. Elastic Beanstalk aggiunge davanti al nome del ruolo i valori corretti per creare internamente gli ARN risultanti.  | 
| `-ls` {{load-balancer}}<br />or<br />`--shared-lb` {{load-balancer}} | Configurare l'ambiente per l'utilizzo di un sistema di bilanciamento del carico condiviso. Fornire il nome o l'ARN di un sistema di bilanciamento del carico condivisibile nell'account, un Application Load Balancer creato in modo esplicito, non uno creato da un altro ambiente Elastic Beanstalk. Per ulteriori informazioni, consulta [Application Load Balancer condiviso](environments-cfg-alb-shared.md).<br />Esempi di parametri:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/elasticbeanstalk/latest/dg/eb3-create.html)<br />È possibile specificare questa opzione solo con `--elb-type application`. Se si specifica tale opzione e non si specifica `--shared-lb`, Elastic Beanstalk crea un sistema di bilanciamento del carico dedicato per l'ambiente. | 
| `-lp` {{port}}<br />or<br />`--shared-lb-port` {{port}} | La porta del listener predefinita del sistema di bilanciamento del carico condiviso per questo ambiente. Elastic Beanstalk aggiunge una regola del listener che instrada tutto il traffico da questo listener al processo ambiente predefinito. Per ulteriori informazioni, consulta [Application Load Balancer condiviso](environments-cfg-alb-shared.md).<br />Tipo: Number (integer)<br />Default: `80`<br />Valori validi: qualsiasi numero intero che rappresenta una porta del listener del sistema di bilanciamento del carico condiviso. | 
| `--single` | Crea l'ambiente con una singola EC2 istanza Amazon e senza un sistema di bilanciamento del carico. Un ambiente con una singola istanza non è pronto per la produzione. Se l'istanza diviene instabile durante la distribuzione o Elastic Beanstalk termina e riavvia l'istanza durante un aggiornamento della configurazione, l'applicazione può risultare non disponibile per un certo periodo di tempo. Utilizza ambienti con una singola istanza per sviluppare, testare o gestire temporaneamente. Per la produzione, utilizza ambienti con bilanciamento del carico.  | 
| `-sm`<br />oppure<br />`--spot-max-price` | Il prezzo massimo orario per unità che si è disposti a pagare per un'istanza Spot in dollari americani.<br />Questa opzione può essere specificata solo con l'opzione `--enable-spot`. Per ulteriori dettagli, consulta [Gruppo Auto Scaling](using-features.managing.as.md).<br />Tipo: Numero (float)<br />Per impostazione predefinita: prezzo on demand per ogni tipo di istanza. Il valore dell'opzione in questo caso è `null`.<br />Valori validi: da `0.001` a `20.0`<br />Per consigli sulle opzioni di prezzo massimo per le istanze Spot, consulta la [cronologia dei prezzi delle istanze Spot](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances-history.html) nella *Amazon EC2 User Guide*. | 
| `-﻿-﻿tags {{key1}}={{value1}}[,{{key2}}={{value2}} ...]` | Applica tag alle risorse nell'ambiente. I tag sono specificati come elenco di coppie `key=value` separate da virgole.<br />Per ulteriori informazioni, consulta [Etichettatura degli ambienti](using-features.tagging.md). | 
| `-t worker`<br />oppure<br />`--tier worker` | Crea un ambiente di ruoli di lavoro. Ometti questa opzione per creare un ambiente di server Web. | 
| `--timeout` {{minutes}} | Imposta il numero di minuti prima del timeout del comando. | 
| `--version` {{version\_label}} | Specifica la versione dell'applicazione che deve essere distribuita nell'ambiente anziché il codice sorgente dell'applicazione nella directory di progetto locale.<br />Tipo: string<br />Valori validi: un'etichetta di versione dell'applicazione esistente | 
| `--vpc` | Configura un VPC per l'ambiente. Quando includi questa opzione, la CLI EB richiede di immettere tutte le impostazioni necessarie prima di avviare l'ambiente. | 
| `--vpc.dbsubnets {{subnet1,subnet2}}` | Specifica le sottoreti per le istanze di database in un VPC. Opzione obbligatoria quando specifichi `--vpc.id`. | 
| `--vpc.ec2subnets {{subnet1,subnet2}}` | Speciifica le sottoreti per le EC2 istanze Amazon in un VPC. Opzione obbligatoria quando specifichi `--vpc.id`. | 
| `--vpc.elbpublic` | Avvia il sistema di bilanciamento del carico Elastic Load Balancing in una sottorete pubblica nel VPC.<br />Non puoi specificare questa opzione con `--tier worker` o `--single`. | 
| `--vpc.elbsubnets {{subnet1,subnet2}}` | Specifica le sottoreti per il sistema di bilanciamento del carico Elastic Load Balancing in un VPC.<br />Non puoi specificare questa opzione con `--tier worker` o `--single`. | 
| `--vpc.id {{ID}}` | Avvia l'ambiente nel VPC specificato. | 
| `--vpc.publicip` | Avvia le tue EC2 istanze Amazon in una sottorete pubblica del tuo VPC.<br />Non puoi specificare questa opzione con `--tier worker`. | 
| `--vpc.securitygroups {{securitygroup1,securitygroup2}}` | Speciifica il gruppo di sicurezza. IDs Opzione obbligatoria quando specifichi `--vpc.id`. | 
| [Opzioni comuni](eb3-cmd-options.md) |  | 

## Output
<a name="eb3-createoutput"></a>

In caso di esito positivo, il comando pone alcune domande e restituisce lo stato dell'operazione di creazione. Se si sono verificati problemi durante l'avvio, puoi utilizzare l'operazione [**eb events**](eb3-events.md) per ottenere ulteriori dettagli.

Se hai abilitato il CodeBuild supporto nell'applicazione, **eb create** visualizza le informazioni relative alla creazione del codice. CodeBuild Per informazioni sul CodeBuild supporto in Elastic Beanstalk, consulta. [Utilizzo dell'EB CLI con AWS CodeBuild](eb-cli-codebuild.md)

## Esempi
<a name="eb3-createexample1"></a>

L'esempio seguente crea un ambiente in modalità interattiva.

```
$ eb create
Enter Environment Name
(default is tmp-dev): {{ENTER}}
Enter DNS CNAME prefix
(default is tmp-dev): {{ENTER}}
Select a load balancer type
1) classic
2) application
3) network
(default is 2): {{ENTER}}
Environment details for: tmp-dev
  Application name: tmp
  Region: us-east-2
  Deployed Version: app-141029_145448
  Environment ID: e-um3yfrzq22
  Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5
  Tier: WebServer-Standard-1.0
  CNAME: tmp-dev.elasticbeanstalk.com
  Updated: 2014-10-29 21:54:51.063000+00:00
Printing Status:
...
```

Anche l'esempio seguente crea un ambiente in modalità interattiva. In questo esempio la directory di progetto non include codice dell'applicazione. Il comando distribuisce un'applicazione di esempio e la scarica nella directory di progetto locale.

```
$ eb create
Enter Environment Name
(default is tmp-dev): {{ENTER}}
Enter DNS CNAME prefix
(default is tmp-dev): {{ENTER}}
Select a load balancer type
1) classic
2) application
3) network
(default is 2): {{ENTER}}
NOTE: The current directory does not contain any source code. Elastic Beanstalk is launching the sample application instead.
Do you want to download the sample application into the current directory?
(Y/n): {{ENTER}}
INFO: Downloading sample application to the current directory.
INFO: Download complete.
Environment details for: tmp-dev
  Application name: tmp
  Region: us-east-2
  Deployed Version: Sample Application
  Environment ID: e-um3yfrzq22
  Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5
  Tier: WebServer-Standard-1.0
  CNAME: tmp-dev.elasticbeanstalk.com
  Updated: 2017-11-08 21:54:51.063000+00:00
Printing Status:
...
```

Il comando seguente crea un ambiente senza visualizzare alcuna richiesta.

```
$ eb create dev-env
Creating application version archive "app-160312_014028".
Uploading test/app-160312_014028.zip to S3. This may take a while.
Upload Complete.
Application test has been created.
Environment details for: dev-env
  Application name: test
  Region: us-east-2
  Deployed Version: app-160312_014028
  Environment ID: e-6fgpkjxyyi
  Platform: 64bit Amazon Linux 2015.09 v2.0.8 running PHP 5.6
  Tier: WebServer-Standard
  CNAME: UNKNOWN
  Updated: 2016-03-12 01:40:33.614000+00:00
Printing Status:
...
```

Il comando seguente crea un ambiente in un VPC personalizzato.

```
$ eb create dev-vpc --vpc.id vpc-0ce8dd99 --vpc.elbsubnets subnet-b356d7c6,subnet-02f74b0c --vpc.ec2subnets subnet-0bb7f0cd,subnet-3b6697c1 --vpc.securitygroup sg-70cff265
Creating application version archive "app-160312_014309".
Uploading test/app-160312_014309.zip to S3. This may take a while.
Upload Complete.
Environment details for: dev-vpc
  Application name: test
  Region: us-east-2
  Deployed Version: app-160312_014309
  Environment ID: e-pqkcip3mns
  Platform: 64bit Amazon Linux 2015.09 v2.0.8 running Java 8
  Tier: WebServer-Standard
  CNAME: UNKNOWN
  Updated: 2016-03-12 01:43:14.057000+00:00
Printing Status:
...
```