As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# **eb create**
## Description
Cria um novo ambiente e implanta uma versão do aplicativo nele.
**nota**
Para usar o **eb create** em uma aplicação .NET, é necessário criar um pacote de implantação conforme descrito em [Criar pacote de origem para um aplicativo .NET](applications-sourcebundle.md#using-features.deployment.source.dotnet) e definir a configuração da CLI para implantar o pacote como um artefato conforme descrito em [Implantar um artefato, em vez da pasta do projeto](eb-cli3-configuration.md#eb-cli3-artifact).
A criação de ambientes com a CLI do EB exige uma [função de serviço](concepts-roles-service.md). É possível criar uma função de serviço criando um ambiente no console do Elastic Beanstalk. Se você não tiver uma função de serviço, a CLI do EB tentará criar uma ao executar `eb create`.
Você pode implantar a versão do aplicativo de algumas origens:
+ Por padrão: a partir do código-fonte da aplicação no diretório local do projeto.
+ Usando a opção `--version`: a partir de uma versão da aplicação que já existe em sua aplicação.
+ Quando o diretório do projeto não tem código de aplicação, ou ao usar a opção `--sample`: a partir de uma aplicação de amostra específica para a plataforma do seu ambiente.
## Sintaxe
**eb create**
**eb create {{environment-name}}**
O nome de um ambiente deve ter entre 4 e 40 caracteres de comprimento. Ele pode conter somente letras, números e hifens (-). Um nome de ambiente não pode começar nem terminar com um hífen.
Se você incluir um nome de ambiente no comando, a EB CLI não pedirá que você faça seleções ou crie uma função de serviço.
Se você executar o comando sem um argumento de nome de ambiente, ele será executado em um fluxo interativo e solicitará que você insira ou selecione valores para algumas configurações. Neste fluxo interativo, caso você esteja implementando um aplicativo de amostra, a EB CLI também pergunta se você deseja fazer download desse aplicativo de amostra no seu diretório local do projeto. Ao fazer download, você pode usar a EB CLI mais tarde com o novo ambiente para executar as operações que exigem o código da aplicação, como [**eb deploy**](eb3-deploy.md).
Alguns prompts de fluxo interativo são exibidos somente sob determinadas condições. Por exemplo, se você optar por usar um Application Load Balancer e sua conta tiver pelo menos um Application Load Balancer compartilhável, o Elastic Beanstalk exibirá um prompt perguntando se você deseja usar um balanceador de carga compartilhado. Esse prompt não será exibido se não houver nenhum balanceador de carga da aplicação compartilhável em sua conta.
## Opções
Nenhuma dessas opções é obrigatória. Se você executar **eb create** sem nenhuma opção, a EB CLI solicita que você insira ou selecione um valor para cada configuração.
****
| Nome | Descrição |
| --- | --- |
| `-d` ou `--branch_default` | Definir o ambiente como o ambiente padrão para o repositório atual. |
| `--cfg` {{config-name}} | [Use as configurações de plataforma de uma configuração salva](environment-configuration-methods-during.md#configuration-options-during-ebcli-savedconfig) em `.elasticbeanstalk/saved_configs/` ou no bucket do Amazon S3. Especifique o nome do arquivo apenas, sem a extensão `.cfg.yml`. |
| `-c` {{subdomain-name}} or `--cname` {{subdomain-name}} | O nome do subdomínio para prefixar a entrada de CNAME DNS que é roteada para seu website. Tipo: sequência Padrão: o nome do ambiente |
| `-db` ou `--database` | Anexa um banco de dados ao ambiente. Se você executar **eb create** com a opção `--database`, mas sem as opções `--database.username` e `--database.password`, a EB CLI solicitará o nome de usuário principal e a senha do banco de dados. |
| `-db.engine` {{engine}} or `--database.engine` {{engine}} | O tipo de mecanismo de banco de dados. Se você executar **eb create** com essa opção, a EB CLI iniciará o ambiente com um banco de dados anexado. Esse será o caso mesmo que você não tenha executado o comando com a opção `--database`. Tipo: sequência Valores válidos: `mysql`, `oracle-se1`, `postgres`, `sqlserver-ex`, `sqlserver-web`, `sqlserver-se` |
| `-db.i` {{instance\_type}} or `--database.instance` {{instance\_type}} | O tipo de EC2 instância da Amazon a ser usada para o banco de dados. Se você executar **eb create** com essa opção, a EB CLI iniciará o ambiente com um banco de dados anexado. Esse será o caso mesmo que você não tenha executado o comando com a opção `--database`. Tipo: string Valores válidos: O Amazon RDS é compatível com um conjunto padrão de instâncias de banco de dados. Para selecionar uma instância de banco de dados apropriada para seu mecanismo de banco de dados, você deve levar em consideração algumas considerações específicas. Para obter mais informações, consulte [Classes de instâncias de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html) no *Guia do usuário do Amazon RDS*. |
| `-db.pass` {{password}} or `--database.password` {{password}} | A senha do banco de dados. Se você executar **eb create** com essa opção, a EB CLI iniciará o ambiente com um banco de dados anexado. Esse será o caso mesmo que você não tenha executado o comando com a opção `--database`. |
| `-db.size` {{number\_of\_gigabytes}} or `--database.size` {{number\_of\_gigabytes}} | O número de gigabytes (GB) para alocar ao armazenamento de banco de dados. Se você executar **eb create** com essa opção, a EB CLI iniciará o ambiente com um banco de dados anexado. Esse será o caso mesmo que você não tenha executado o comando com a opção `--database`. Tipo: número Valores válidos: [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/eb3-create.html) |
| `-db.user` {{username}} or `--database.username` {{username}} | O nome de usuário para o banco de dados. Se você executar **eb create** com essa opção, a EB CLI iniciará o ambiente com um banco de dados anexado, mesmo que você não tenha executado o comando com a opção `--database`. Se você executar **eb create** com a opção `--database`, mas sem as opções `--database.username` e `--database.password`, a EB CLI solicitará o nome de usuário e a senha principais do banco de dados. |
| `-db.version` {{version}} or `--database.version` {{version}} | Usado para especificar a versão do mecanismo de banco de dados. Se esse sinalizador estiver presente, o ambiente será iniciado com um banco de dados com o número de versão especificado, mesmo que o sinalizador `--database` não esteja presente. |
| `--elb-type` {{type}} | Novo [tipo de load balancer](using-features.managing.elb.md). Tipo: sequência Valores válidos: `classic`, `application`, `network` Padrão: `application` |
| `-es` ou `--enable-spot` | Habilite solicitações de instância spot para seu ambiente. Para obter mais informações, consulte [Auto Scaling group (Grupo do Auto Scaling)](using-features.managing.as.md). Opções relacionadas: [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/eb3-create.html) |
| --env-group-suffix {{groupname}} | Nome do grupo para anexar ao nome do ambiente. Somente para uso com [ambientes do Compose](ebcli-compose.md). |
| `--envvars` | [Propriedades do ambiente](environments-cfg-softwaresettings.md) em uma lista separada por vírgulas com o formato {{name}} =. {{value}} Para obter os limites, consulte [Configurar propriedades do ambiente (variáveis de ambiente)](environments-cfg-softwaresettings.md#environments-cfg-softwaresettings-console). |
| `-ip` {{profile\_name}} or `--instance_profile` {{profile\_name}} | O perfil da instância com a função do IAM com as credenciais de segurança temporárias que seu aplicativo precisa para acessar AWS os recursos. |
| `-it` or `--instance-types {{type1}}[,{{type2}} ...]` | Uma lista separada por vírgulas dos tipos de EC2 instância da Amazon que você deseja que seu ambiente use. Se você não especificar essa opção, o Elastic Beanstalk fornecerá tipos de instância padrão. Para obter mais informações, consulte [ EC2 Instâncias da Amazon](using-features.managing.ec2.md) e [Auto Scaling group (Grupo do Auto Scaling)](using-features.managing.as.md). A EB CLI aplica somente essa opção a instâncias spot. A menos que esta opção seja usada com a opção `--enable-spot`, a EB CLI a ignorará. Para especificar um tipo de instância para uma instância sob demanda, use a opção `--intance-type` (sem "s"). |
| `-i` or `--instance_type` | O tipo de EC2 instância da Amazon que você deseja que seu ambiente use. Se você não especificar essa opção, o Elastic Beanstalk fornecerá um tipo de instância padrão. Para obter mais informações, consulte [ EC2 Instâncias da Amazon](using-features.managing.ec2.md). A EB CLI aplica essa opção somente a instâncias sob demanda. Não use essa opção com a opção `--enable-spot`, pois a EB CLI a ignora quando você faz isso. Para especificar tipos de instância para uma instância spot, use a opção `--intance-types` (sem "s"). |
| `-k` {{key\_name}} or `--keyname` {{key\_name}} | O nome do par de EC2 chaves da Amazon a ser usado com o cliente Secure Shell (SSH) para fazer login com segurança nas EC2 instâncias da Amazon que estão executando seu aplicativo Elastic Beanstalk. Se você incluir essa opção com o comando **eb create**, o valor fornecido substituirá qualquer nome de chave especificado com **eb init**. Valores válidos: um nome de chave existente registrado na Amazon EC2 |
| `-im` {{number-of-instances}} or `--min-instances` {{number-of-instances}} | O número mínimo de EC2 instâncias da Amazon que você precisa que seu ambiente tenha. Tipo: número (inteiro) Padrão: `1` Valores válidos: `1` a `10000` |
| `-ix` {{number-of-instances}} or `--max-instances` {{number-of-instances}} | O número máximo de EC2 instâncias da Amazon que você permite que seu ambiente tenha. Tipo: número (inteiro) Padrão: `4` Valores válidos: `1` a `10000` |
| `--modules` {{component-a component-b}} | Uma lista de ambientes de componente para criar. Somente para uso com [ambientes do Compose](ebcli-compose.md). |
| `-sb` ou `--on-demand-base-capacity` | O número mínimo de instâncias sob demanda que o grupo de Auto Scaling provisiona antes de considerar as instâncias spot à medida que o ambiente é dimensionado. Esta opção só pode ser especificada com a opção `--enable-spot`. Para obter mais informações, consulte [Auto Scaling group (Grupo do Auto Scaling)](using-features.managing.as.md). Tipo: número (inteiro) Padrão: `0` Valores válidos: `0` para `--max-instances` (quando ausente: opção `MaxSize` no namespace [`aws:autoscaling:asg`](command-options-general.md#command-options-general-autoscalingasg)) |
| `-sp` ou `--on-demand-above-base-capacity` | A porcentagem de instâncias sob demanda como parte da capacidade adicional que o grupo de Auto Scaling provisiona além do número de instâncias especificado pela opção `--on-demand-base-capacity`. Esta opção só pode ser especificada com a opção `--enable-spot`. Para obter mais detalhes, consulte [Auto Scaling group (Grupo do Auto Scaling)](using-features.managing.as.md). Tipo: número (inteiro) Padrão: `0` para um ambiente de uma única instância; `70` para um ambiente com balanceamento de carga Valores válidos: `0` a `100` |
| `-p` {{platform-version}} or `--platform` {{platform-version}} | A [versão da plataforma](concepts.platforms.md) a ser usada. É possível especificar uma plataforma, uma plataforma e a versão, a ramificação de uma plataforma, o nome de uma pilha de solução ou o ARN de uma pilha de solução. Por exemplo: [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/eb3-create.html) Use [`eb platform list`](eb3-platform.md) para obter uma lista de configurações disponíveis. Se você especificar a opção `--platform`, ela substituirá o valor que foi fornecido `eb init`. |
| `-pr` ou `--process` | Pré-processa e valida o manifesto de ambiente e os arquivos de configuração no pacote de origem. A validação dos arquivos de configuração pode identificar problemas antes de implantar a versão do aplicativo em um ambiente. |
| `-r` {{region}} or `--region` {{region}} | A AWS região em que você deseja implantar o aplicativo. Para obter a lista de valores que você pode especificar para essa opção, consulte [Endpoints e cotas do AWS Elastic Beanstalk](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) no *Referência geral da AWS*. |
| `--sample` | Implante o aplicativo de exemplo no novo ambiente, em vez do código no seu repositório. |
| `--scale` {{number-of-instances}} | Iniciar com o número especificado de instâncias |
| --service-role {{servicerole}} | Atribua ao ambiente uma função de serviço diferente do padrão. Não insira um ARN. Insira apenas o nome da função. O Elastic Beanstalk insere um prefixo no nome da função com os valores corretos para criar internamente o ARN resultante. |
| `-ls` {{load-balancer}} or `--shared-lb` {{load-balancer}} | Configure o ambiente para usar um load balancer compartilhado. Forneça o nome ou o ARN de um balanceador de carga compartilhável em sua conta: um Application Load Balancer criado explicitamente, não um criado por outro ambiente do Elastic Beanstalk. Para obter mais informações, consulte [Application Load Balancer compartilhado](environments-cfg-alb-shared.md). Exemplos de parâmetros: [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/eb3-create.html) Você pode especificar essa opção somente com `--elb-type application`. Se você especificar essa opção e não especificar `--shared-lb`, o Elastic Beanstalk criará um balanceador de carga dedicado para o ambiente. |
| `-lp` {{port}} or `--shared-lb-port` {{port}} | A porta de listener padrão do balanceador de carga compartilhado para este ambiente. O Elastic Beanstalk adiciona uma regra de listener que encaminha todo o tráfego desse listener para o processo de ambiente padrão. Para obter mais informações, consulte [Application Load Balancer compartilhado](environments-cfg-alb-shared.md). Tipo: número (inteiro) Padrão: `80` Valores válidos: qualquer número inteiro que represente uma porta de listener do load balancer compartilhado. |
| `--single` | Crie o ambiente com uma única EC2 instância da Amazon e sem um balanceador de carga. Um ambiente de única instância não está pronto para produção. Se a instância tornar-se instável durante a implantação, ou o Elastic Beanstalk encerrar e reiniciar a instância durante uma atualização de configuração, sua aplicação poderá ficar indisponível durante um determinado período. Use ambientes de única instância para desenvolvimento, teste ou preparação. Use ambientes com balanceamento de carga para produção. |
| `-sm` ou `--spot-max-price` | O preço máximo por hora, em USD, que você está disposto a pagar por uma instância spot. Esta opção só pode ser especificada com a opção `--enable-spot`. Para obter mais detalhes, consulte [Auto Scaling group (Grupo do Auto Scaling)](using-features.managing.as.md). Tipo: número (flutuante) Padrão: Preço sob demanda, para cada tipo de instância. O valor da opção neste caso é `null`. Valores válidos: `0.001` a `20.0` Para recomendações sobre as opções de preço máximo para instâncias spot, consulte o [histórico de preços de instâncias spot](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances-history.html) no *Guia EC2 do usuário da Amazon*. |
| `--tags {{key1}}={{value1}}[,{{key2}}={{value2}} ...]` | Marque os recursos no seu ambiente. As tags são especificadas como uma lista de `key=value` separados por vírgulas. Para obter mais informações, consulte [Marcação de ambientes](using-features.tagging.md). |
| `-t worker` ou `--tier worker` | Crie um ambiente de operador. Omita essa opção para criar um ambiente de servidor web. |
| `--timeout` {{minutes}} | O número definido de minutos antes do limite de tempo do comando. |
| `--version` {{version\_label}} | Especifica a versão do aplicativo que você deseja implantar no ambiente, em vez do código-fonte do aplicativo no diretório do projeto local. Tipo: sequência Valores válidos: um rótulo de versão do aplicativo existente |
| `--vpc` | Configure uma VPC em seu ambiente. Quando você incluir essa opção, a EB CLI solicitará que você insira todas as configurações obrigatórias antes de iniciar o ambiente. |
| `--vpc.dbsubnets {{subnet1,subnet2}}` | Especifica sub-redes para instâncias de banco de dados em uma VPC. Obrigatório quando `--vpc.id` for especificado. |
| `--vpc.ec2subnets {{subnet1,subnet2}}` | Especifica sub-redes para EC2 instâncias da Amazon em uma VPC. Obrigatório quando `--vpc.id` for especificado. |
| `--vpc.elbpublic` | Inicia o balanceador de carga do Elastic Load Balancing em uma sub-rede pública em sua VPC. Não é possível especificar essa opção com `--tier worker` e `--single`. |
| `--vpc.elbsubnets {{subnet1,subnet2}}` | Especifica sub-redes para o balanceador de carga do Elastic Load Balancing em uma VPC. Não é possível especificar essa opção com `--tier worker` e `--single`. |
| `--vpc.id {{ID}}` | Inicia seu ambiente na VPC especificada. |
| `--vpc.publicip` | Lança suas EC2 instâncias da Amazon em uma sub-rede pública em sua VPC. Não é possível especificar essa opção com `--tier worker` . |
| `--vpc.securitygroups {{securitygroup1,securitygroup2}}` | Especifica o grupo IDs de segurança. Obrigatório quando `--vpc.id` for especificado. |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
Se for bem-sucedido, o comando apresentará prompts com perguntas e retornará o status da operação de criação. Se houver problemas durante a inicialização, você poderá usar a operação [**eb events**](eb3-events.md) para obter mais detalhes.
Se você ativou o CodeBuild suporte em seu aplicativo, **eb create** exibirá informações de CodeBuild como seu código é criado. Para obter informações sobre o CodeBuild suporte no Elastic Beanstalk, consulte. [Usando o EB CLI com AWS CodeBuild](eb-cli-codebuild.md)
## Exemplos
O exemplo a seguir cria um ambiente no modo interativo.
```
$ 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:
...
```
O exemplo a seguir também cria um ambiente no modo interativo. Neste exemplo, o diretório do projeto não tem código de aplicativo. O comando implanta um aplicativo de amostra e faz o download deste no diretório local do projeto.
```
$ 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:
...
```
O seguinte comando cria um ambiente sem exibir prompts.
```
$ 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:
...
```
O seguinte comando cria um ambiente em uma VPC personalizada.
```
$ 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:
...
```