eb create

Descrição

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 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.
A criação de ambientes com a CLI do EB exige uma função de serviço. É 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.

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 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` ou `--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` ou `--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` ou `--database.instance` `instance_type`	O tipo de instância do Amazon EC2 para usar no 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 no Guia do usuário do Amazon RDS.
`-db.pass` `password` ou `--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` ou `--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: MySQL: `5` a `1024`. O padrão é `5`. Postgres: `5` a `1024`. O padrão é `5`. Oracle: `10` a `1024`. O padrão é `10`. Microsoft SQL Server Express Edition – `30`. Microsoft SQL Server Web Edition – `30`. Microsoft SQL Server Standard Edition – `200`.
`-db.user` `username` ou `--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` ou `--database.version` `versão`	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. 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 Grupo de Auto Scaling. Opções relacionadas: `--instance-types` `--on-demand-base-capacity` `--on-demand-above-base-capacity` `--spot-max-price`
`--env-group-suffix groupname`	Nome do grupo para anexar ao nome do ambiente. Somente para uso com ambientes do Compose.
`--envvars`	Propriedades do ambiente em uma lista separada por vírgula com o formato `name`=`value`. Para obter os limites, consulte Configurar propriedades do ambiente (variáveis de ambiente).
`-ip` `profile_name` ou `--instance_profile` `profile_name`	O perfil da instância com a função do IAM com as credenciais de segurança temporárias das quais sua aplicação precisa para acessar os recursos da AWS.
`-it` ou `--instance-types type1[,type2 ...]`	Uma lista separada por vírgulas dos tipos de instância do Amazon EC2 que você deseja que o 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 Instâncias do Amazon EC2 e Grupo de Auto Scaling. Importante 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` ou `--instance_type`	O tipo de instância do Amazon EC2 que deseja que o 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 Instâncias do Amazon EC2. Importante 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` ou `--keyname` `key_name`	O nome do par de chaves do Amazon EC2 a ser usado com o cliente Secure Shell (SSH) para fazer login com segurança nas instâncias do Amazon EC2 que executam a aplicação do 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 que está registrado no Amazon EC2
`-im` `number-of-instances` ou `--min-instances` `number-of-instances`	O número mínimo de instâncias do Amazon EC2 exigidas por você para seu ambiente. Tipo: número (inteiro) Padrão: `1` Valores válidos: `1` a `10000`
`-ix` `number-of-instances` ou `--max-instances` `number-of-instances`	O número máximo de instâncias do Amazon EC2 permitidas por você para seu ambiente. 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.
`-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 Grupo de Auto Scaling. Tipo: número (inteiro) Padrão: `0` Valores válidos: `0` para `--max-instances` (quando ausente: opção `MaxSize` no namespace aws:autoscaling:asg)
`-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 Grupo de Auto Scaling. 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` ou `--platform` `platform-version`	A versão da plataforma 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: `php`, `PHP`, `node.js`: a versão mais recente da plataforma especificada `php-7.2`, `"PHP 7.2"`: a versão recomendada da plataforma PHP 7.2 (geralmente a mais recente) `"PHP 7.2 running on 64bit Amazon Linux"`: a versão da plataforma PHP especificada por esse nome de pilha da solução `"64bit Amazon Linux 2017.09 v2.6.3 running PHP 7.1"`: a versão da plataforma PHP especificada por esse nome de pilha da solução `"arn:aws:elasticbeanstalk:us-east-2::platform/PHP 7.1 running on 64bit Amazon Linux/2.6.3"`: a versão da plataforma PHP especificada por esse ARN de pilha da solução Use eb platform list 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` ou `--region` `region`	A região da AWS na qual você deseja implantar a aplicação. Para obter a lista de valores que você pode especificar para essa opção, consulte Endpoints e cotas do AWS Elastic Beanstalk 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. nota 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` ou `--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. Exemplos de parâmetros: `FrontEndLB`: o nome de um balanceador de carga. `arn:aws:elasticloadbalancing:us-east-2:123456789012:loadbalancer/app/FrontEndLB/0dbf78d8ad96abbc`: ARN de um Application Load Balancer. 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` ou `--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. 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 instância do Amazon EC2 e sem um balanceador de carga. Atenção 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 Grupo de Auto Scaling. 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 opções de preço máximo para instâncias Spot, consulte Histórico de preços de instâncias Spot, no Guia do usuário do Amazon EC2.
`--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 ter mais informações, consulte Marcação em ambientes.
`-t worker` ou `--tier worker`	Crie um ambiente de operador. Omita essa opção para criar um ambiente de servidor web.
`--timeout` `minutos`	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 instâncias do Amazon EC2 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`	Inicia suas instâncias do Amazon EC2 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 IDs de grupo de segurança. Obrigatório quando `--vpc.id` for especificado.
Opções comuns

Nome

Descrição

-d

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

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

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

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

--database.instance instance_type

O tipo de instância do Amazon EC2 para usar no 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 no Guia do usuário do Amazon RDS.

-db.pass password

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

--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:

MySQL: 5 a 1024. O padrão é 5.
Postgres: 5 a 1024. O padrão é 5.
Oracle: 10 a 1024. O padrão é 10.
Microsoft SQL Server Express Edition – 30.
Microsoft SQL Server Web Edition – 30.
Microsoft SQL Server Standard Edition – 200.

-db.user username

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

--database.version versão

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.

Tipo: sequência

Valores válidos: classic, application, network

Padrão: application

-es

--enable-spot

Habilite solicitações de instância spot para seu ambiente. Para obter mais informações, consulte Grupo de Auto Scaling.

Opções relacionadas:

--instance-types
--on-demand-base-capacity
--on-demand-above-base-capacity
--spot-max-price

--env-group-suffix groupname Nome do grupo para anexar ao nome do ambiente. Somente para uso com ambientes do Compose.

--envvars

Propriedades do ambiente em uma lista separada por vírgula com o formato name=value. Para obter os limites, consulte Configurar propriedades do ambiente (variáveis de ambiente).

-ip profile_name

--instance_profile profile_name

O perfil da instância com a função do IAM com as credenciais de segurança temporárias das quais sua aplicação precisa para acessar os recursos da AWS.

-it

--instance-types type1[,type2 ...]

Uma lista separada por vírgulas dos tipos de instância do Amazon EC2 que você deseja que o 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 Instâncias do Amazon EC2 e Grupo de Auto Scaling.

Importante

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

--instance_type

O tipo de instância do Amazon EC2 que deseja que o 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 Instâncias do Amazon EC2.

Importante

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

--keyname key_name

O nome do par de chaves do Amazon EC2 a ser usado com o cliente Secure Shell (SSH) para fazer login com segurança nas instâncias do Amazon EC2 que executam a aplicação do 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 que está registrado no Amazon EC2

-im number-of-instances

--min-instances number-of-instances

O número mínimo de instâncias do Amazon EC2 exigidas por você para seu ambiente.

Tipo: número (inteiro)

Padrão: 1

Valores válidos: 1 a 10000

-ix number-of-instances

--max-instances number-of-instances

O número máximo de instâncias do Amazon EC2 permitidas por você para seu ambiente.

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.

-sb

--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 Grupo de Auto Scaling.

Tipo: número (inteiro)

Padrão: 0

Valores válidos: 0 para --max-instances (quando ausente: opção MaxSize no namespace aws:autoscaling:asg)

-sp

--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 Grupo de Auto Scaling.

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

--platform platform-version

A versão da plataforma 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:

php, PHP, node.js: a versão mais recente da plataforma especificada
php-7.2, "PHP 7.2": a versão recomendada da plataforma PHP 7.2 (geralmente a mais recente)
"PHP 7.2 running on 64bit Amazon Linux": a versão da plataforma PHP especificada por esse nome de pilha da solução
"64bit Amazon Linux 2017.09 v2.6.3 running PHP 7.1": a versão da plataforma PHP especificada por esse nome de pilha da solução
"arn:aws:elasticbeanstalk:us-east-2::platform/PHP 7.1 running on 64bit Amazon Linux/2.6.3": a versão da plataforma PHP especificada por esse ARN de pilha da solução

Use eb platform list 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

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

--region region

A região da AWS na qual você deseja implantar a aplicação.

Para obter a lista de valores que você pode especificar para essa opção, consulte Endpoints e cotas do AWS Elastic Beanstalk 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.

nota

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

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

Exemplos de parâmetros:

FrontEndLB: o nome de um balanceador de carga.
arn:aws:elasticloadbalancing:us-east-2:123456789012:loadbalancer/app/FrontEndLB/0dbf78d8ad96abbc: ARN de um Application Load Balancer.

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

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

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 instância do Amazon EC2 e sem um balanceador de carga.

Atenção

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

--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 Grupo de Auto Scaling.

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 opções de preço máximo para instâncias Spot, consulte Histórico de preços de instâncias Spot, no Guia do usuário do Amazon EC2.

--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 ter mais informações, consulte Marcação em ambientes.

-t worker

--tier worker

Crie um ambiente de operador. Omita essa opção para criar um ambiente de servidor web.

--timeout minutos

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 instâncias do Amazon EC2 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

Inicia suas instâncias do Amazon EC2 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 IDs de grupo de segurança. Obrigatório quando --vpc.id for especificado.

Opções comuns

Saída

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 para obter mais detalhes.

Se você habilitou o suporte do CodeBuild à aplicação, eb create exibirá as informações do CodeBuild enquanto o código é compilado. Para obter informações sobre o suporte ao CodeBuild no Elastic Beanstalk, consulte Usar o EB CLI com o AWS CodeBuild.

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

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

eb console

eb deploy