"`. Para especificar o nome do arquivo sem um `path`, salve o arquivo na pasta em que você executa o comando. Como alternativa, você pode especificar o nome de arquivo fornecendo o caminho completo. As informações de configuração devem atender às condições a seguir. Pelo menos uma das seções,**OptionSettings** ou **OptionsToRemove**, é necessária. Use **OptionSettings** para adicionar ou alterar opções. Use **OptionsToRemove** para remover opções de um namespace. Para obter exemplo específicos, consulte a seção [Exemplos](#eb3-configexample) mais adiante neste tópico.
**Example**
*Formato YAML*
```
OptionSettings:
namespace1:
option-name-1: option-value-1
option-name-2: option-value-2
...
OptionsToRemove:
namespace1:
option-name-1
option-name-2
...
```
**Example**
*Formato JSON*
```
{
"OptionSettings": {
"namespace1": {
"option-name-1": "option-value-1",
"option-name-2": "option-value-2",
...
}
},
"OptionsToRemove": {
"namespace1": {
"option-name-1",
"option-name-2",
...
}
}
}
``` |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
Se o comando **eb config** ou **eb config *environment-name*** for executado com êxito sem subcomandos ou opções adicionadas, o comando exibirá as configurações de opção atuais no editor de texto que você configurou como a variável de ambiente EDITOR. Se você não configurou uma variável de ambiente EDITOR, a EB CLI exibirá suas configurações de opção no editor padrão para arquivos YAML.
Quando você salvar as alterações no arquivo e fechar o editor, o ambiente será atualizado com as configurações da opção no arquivo. A saída a seguir é exibida para confirmar a atualização de configuração.
```
$ eb config myApp-dev
Printing Status:
2021-05-19 18:09:45 INFO Environment update is starting.
2021-05-19 18:09:55 INFO Updating environment myApp-dev's configuration settings.
2021-05-19 18:11:20 INFO Successfully deployed new configuration to environment.
```
Se o comando for executado com êxito com a opção `--display`, ele exibirá as configurações do ambiente atual (gravações em * stdout*).
Se o comando for executado com êxito com o parâmetro `get`, o comando exibirá a localização da cópia local que você baixou.
Se o comando for executado com êxito com o parâmetro `save`, o comando exibirá a localização do arquivo salvo.
## Exemplos
Esta seção descreve como alterar o editor de texto usado para visualizar e editar o arquivo de configurações de opção.
Para Linux e UNIX, o seguinte exemplo altera o editor para vim:
```
$ export EDITOR=vim
```
Para Linux e UNIX, o exemplo a seguir altera o editor para aquele que estiver instalado em `/usr/bin/kate`.
```
$ export EDITOR=/usr/bin/kate
```
Para Windows, o exemplo a seguir altera o editor para Notepad\$1\$1.
```
> set EDITOR="C:\Program Files\Notepad++\Notepad++.exe
```
Esta seção fornece exemplos do comando **eb config** quando ele é executado com os parâmetros.
O exemplo a seguir exclui a configuração salva chamada `app-tmp`.
```
$ eb config delete app-tmp
```
O exemplo a seguir faz download da configuração salva com o nome app-tmp do bucket do Amazon S3.
```
$ eb config get app-tmp
```
O exemplo a seguir lista os nomes das configurações salvas que são armazenadas no bucket do Amazon S3.
```
$ eb config list
```
O exemplo a seguir faz upload da cópia local da configuração salva app-tmp no bucket do Amazon S3.
```
$ eb config put app-tmp
```
O exemplo a seguir salva as configurações do ambiente em execução no momento. Se você não fornecer um nome a ser usado para a configuração salva, o Elastic Beanstalk fornecerá um nome ao arquivo de configuração de acordo com o nome do ambiente. Por exemplo, um ambiente chamado *tmp-dev* seria chamado `tmp-dev.cfg.yml`. O Elastic Beanstalk salva o arquivo na pasta `/.elasticbeanstalk/saved_configs/`.
```
$ eb config save
```
O exemplo a seguir mostra como usar a opção `--cfg` para salvar as configurações do ambiente tmp-dev em um arquivo chamado `v1-app-tmp.cfg.yml`. O Elastic Beanstalk salva o arquivo na pasta `/.elasticbeanstalk/saved_configs/`. Se você não especificar um nome de ambiente, o Elastic Beanstalk salvará as configurações do ambiente em execução no momento.
```
$ eb config save tmp-dev --cfg v1-app-tmp
```
Esta seção fornece exemplos para o comando **eb config** quando ele é executado sem subcomandos.
O comando a seguir exibe as configurações de opção do ambiente atual em um editor de texto.
```
$ eb config
```
O comando a seguir exibe as configurações de opção para o ambiente *my-env* em um editor de texto.
```
$ eb config my-env
```
O exemplo a seguir exibe as configurações de opções para o ambiente atual. Ele produz no formato YAML porque nenhum formato específico foi especificado com a opção `--format`.
```
$ eb config --display
```
O exemplo a seguir atualiza as configurações de opções para seu ambiente atual com as especificações no arquivo nomeado `example.txt`. O arquivo está no formato YAML ou JSON. A EB CLI detecta automaticamente o formato do arquivo.
+ A opção Minsize é definida como 1 para o namespace `aws:autoscaling:asg`.
+ O tamanho do lote para o namespace `aws:elasticbeanstalk:command` é definido como 30%.
+ Ele remove a configuração da opção *IdleTimeout: Nenhuma* do namespace`AWSEBV2LoadBalancer.aws:elbv2:loadbalancer`.
```
$ eb config --update "file://example.txt"
```
**Example - nome do arquivo:`example.txt` - formato YAML**
```
OptionSettings:
'aws:elasticbeanstalk:command':
BatchSize: '30'
BatchSizeType: Percentage
'aws:autoscaling:asg':
MinSize: '1'
OptionsToRemove:
'AWSEBV2LoadBalancer.aws:elbv2:loadbalancer':
IdleTimeout
```
**Example - nome do arquivo:`example.txt` - formato JSON**
```
{
"OptionSettings": {
"aws:elasticbeanstalk:command": {
"BatchSize": "30",
"BatchSizeType": "Percentage"
},
"aws:autoscaling:asg": {
"MinSize": "1"
}
},
"OptionsToRemove": {
"AWSEBV2LoadBalancer.aws:elbv2:loadbalancer": {
"IdleTimeout"
}
}
}
```
Os exemplos a seguir atualizam as configurações de opções para seu ambiente atual. O comando define a opção Minsize como 1 para o namespace `aws:autoscaling:asg`.
**nota**
Esses exemplos são específicos para o Windows PowerShell. Eles escapam das ocorrências literais do caractere de aspas duplas (`"`), precedendo-o com um caractere barra (`\`). Diferentes sistemas operacionais e ambientes de linha de comando podem ter sequências de escape diferentes. Por esse motivo, recomendamos usar a opção de arquivo mostrada nos exemplos anteriores. Especificar as opções de configuração em um arquivo não requer caracteres de escape e é consistente em diferentes sistemas operacionais.
O exemplo a seguir está no formato JSON. A EB CLI detecta se o formato está em JSON ou YAML.
```
PS C:\Users\myUser\EB_apps\myApp-env>eb config --update '{\"OptionSettings\":{\"aws:autoscaling:asg\":{\"MaxSize\":\"1\"}}}'
```
O exemplo a seguir está no formato YAML. Para inserir a string YAML no formato correto, o comando inclui espaçamento e end-of-line retornos necessários em um arquivo YAML.
+ Termine cada linha com a chave “enter” ou “return”.
+ Inicie a segunda linha com dois espaços e inicie a terceira linha com quatro espaços.
```
PS C:\Users\myUser\EB_apps\myApp-env>eb config --update 'OptionSettings:
>> aws:autoscaling:asg:
>> MinSize: \"1\"'
```
# **eb console**
## Description
Abre um navegador para exibir o painel de configuração do ambiente no console de gerenciamento do Elastic Beanstalk.
Se o diretório raiz contiver um arquivo `platform.yaml` especificando uma plataforma personalizada, esse comando também exibirá a configuração do ambiente do compilador, conforme especificado no `platform.yaml`, no console de gerenciamento do Elastic Beanstalk.
## Sintaxe
**eb console**
**eb console *environment-name***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| [Opções comuns](eb3-cmd-options.md) | |
# **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\$1type* or `--database.instance` *instance\$1type* | 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\$1of\$1gigabytes* or `--database.size` *number\$1of\$1gigabytes* | 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\$1name* or `--instance_profile` *profile\$1name* | 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\$1name* or `--keyname` *key\$1name* | 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\$1label* | 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:
...
```
# **eb deploy**
## Description
Implanta o pacote de origem do aplicativo, que se encontra no diretório do projeto inicializado, no aplicativo em execução.
Se o git for instalado, a EB CLI usará o comando `git archive` para criar um arquivo `.zip` do conteúdo do comando `git commit` mais recente.
No entanto, quando `.ebignore` está presente no diretório do projeto, a CLI do EB não usa semântica e comandos git para criar o pacote de origem. Isso significa que a EB CLI ignora os arquivos especificados em `.ebignore` e inclui todos os outros. Especificamente, ela inclui os arquivos de origem não confirmados.
**nota**
Você pode configurar a EB CLI para implantar um artefato do seu processo de compilação, em vez de criar um arquivo ZIP da pasta do projeto. Para mais detalhes, consulte [Implantar um artefato, em vez da pasta do projeto](eb-cli3-configuration.md#eb-cli3-artifact).
## Sintaxe
**eb deploy**
**eb deploy *environment-name***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `-l` *version\$1label* or `--label` *version\$1label* | Especifique um rótulo a ser usado para a versão criada pela EB CLI. Se o rótulo já tiver sido usado, a EB CLI reimplanta a versão anterior com esse rótulo. Tipo: sequência |
| --env-group-suffix groupname | Nome do grupo para anexar ao nome do ambiente. Somente para uso com [ambientes do Compose](ebcli-compose.md). |
| `-m` "*version\$1description*" or `--message` "*version\$1description*" | A descrição da versão do aplicativo, entre aspas duplas. Tipo: string |
| `--modules` *component-a component-b* | Lista de componentes para atualizar. Somente para uso com [ambientes do Compose](ebcli-compose.md). |
| `-p` 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. |
| `--source codecommit/repository-name/branch-name` | CodeCommit repositório e filial. |
| `--staged` | Implanta arquivos preparados no índice GIT, em vez da confirmação HEAD. |
| `--timeout` *minutes* | O número de minutos antes de esgotar o tempo limite do comando. |
| `--version` *version\$1label* | Uma versão do aplicativo existente para implantar. Tipo: sequência |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
Se for bem-sucedido, o comando retornará o status da operação `deploy`.
Se você ativou o CodeBuild suporte em seu aplicativo, **eb deploy** 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)
## Exemplo
O exemplo a seguir implanta o aplicativo atual.
```
$ eb deploy
2018-07-11 21:05:22 INFO: Environment update is starting.
2018-07-11 21:05:27 INFO: Deploying new version to instance(s).
2018-07-11 21:05:53 INFO: New application version was deployed to running EC2 instances.
2018-07-11 21:05:53 INFO: Environment update completed successfully.
```
# **eb events**
## Description
Retorna os eventos mais recentes do ambiente.
Se o diretório raiz contiver um arquivo `platform.yaml` especificando uma plataforma personalizada, esse comando também retornará os eventos mais recentes para o ambiente do criador.
## Sintaxe
**eb events**
**eb events *environment-name***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `-f` ou `--follow` | Transmite eventos por stream. Para cancelar, pressione CTRL\$1C. |
## Output
Se for bem-sucedido, o comando retornará os eventos recentes.
## Exemplo
O exemplo a seguir retorna os eventos mais recentes.
```
$ eb events
2014-10-29 21:55:39 INFO createEnvironment is starting.
2014-10-29 21:55:40 INFO Using elasticbeanstalk-us-west-2-111122223333 as Amazon S3 storage bucket for environment data.
2014-10-29 21:55:57 INFO Created load balancer named: awseb-e-r-AWSEBLoa-NSKUOK5X6Z9J
2014-10-29 21:56:16 INFO Created security group named: awseb-e-rxgrhjr9bx-stack-AWSEBSecurityGroup-1UUHU5LZ20ZY7
2014-10-29 21:57:18 INFO Waiting for EC2 instances to launch. This may take a few minutes.
2014-10-29 21:57:18 INFO Created Auto Scaling group named: awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD
2014-10-29 21:57:22 INFO Created Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:2cced9e6-859b-421a-be63-8ab34771155a:autoScalingGroupName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD:policyName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingScaleUpPolicy-1I2ZSNVU4APRY
2014-10-29 21:57:22 INFO Created Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:1f08b863-bf65-415a-b584-b7fa3a69a0d5:autoScalingGroupName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD:policyName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingScaleDownPolicy-1E3G7PZKZPSOG
2014-10-29 21:57:25 INFO Created CloudWatch alarm named: awseb-e-rxgrhjr9bx-stack-AWSEBCloudwatchAlarmLow-VF5EJ549FZBL
2014-10-29 21:57:25 INFO Created CloudWatch alarm named: awseb-e-rxgrhjr9bx-stack-AWSEBCloudwatchAlarmHigh-LA9YEW3O6WJO
2014-10-29 21:58:50 INFO Added EC2 instance 'i-c7ee492d' to Auto ScalingGroup 'awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD'.
2014-10-29 21:58:53 INFO Successfully launched environment: tmp-dev
2014-10-29 21:59:14 INFO Environment health has been set to GREEN
2014-10-29 21:59:43 INFO Adding instance 'i-c7ee492d' to your environment.
```
# **eb health**
## Description
Retorna a integridade mais recente do ambiente.
Se o diretório raiz contiver um arquivo `platform.yaml` especificando uma plataforma personalizada, esse comando também retornará a integridade mais recente do ambiente do compilador.
## Sintaxe
**eb health**
**eb health *environment-name***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `-r` ou `--refresh` | Mostra informações de integridade interativamente e atualiza a cada dez segundos à medida que novas informações são relatadas. |
| --mono | Não exibe cor na saída. |
## Output
Se for bem-sucedido, o comando retornará a integridade recente.
## Exemplo
O exemplo a seguir retorna as informações de integridade mais recentes para um ambiente Linux.
```
~/project $ eb health
elasticBeanstalkExa-env Ok 2015-07-08 23:13:20
WebServer Ruby 2.1 (Puma)
total ok warning degraded severe info pending unknown
5 5 0 0 0 0 0 0
instance-id status cause health
Overall Ok
i-d581497d Ok
i-d481497c Ok
i-136e00c0 Ok
i-126e00c1 Ok
i-8b2cf575 Ok
instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests
Overall 671.8 100.0 0.0 0.0 0.0 0.003 0.002 0.001 0.001 0.000
i-d581497d 143.0 1430 0 0 0 0.003 0.002 0.001 0.001 0.000
i-d481497c 128.8 1288 0 0 0 0.003 0.002 0.001 0.001 0.000
i-136e00c0 125.4 1254 0 0 0 0.004 0.002 0.001 0.001 0.000
i-126e00c1 133.4 1334 0 0 0 0.003 0.002 0.001 0.001 0.000
i-8b2cf575 141.2 1412 0 0 0 0.003 0.002 0.001 0.001 0.000
instance-id type az running load 1 load 5 user% nice% system% idle% iowait% cpu
i-d581497d t2.micro 1a 12 mins 0.0 0.04 6.2 0.0 1.0 92.5 0.1
i-d481497c t2.micro 1a 12 mins 0.01 0.09 5.9 0.0 1.6 92.4 0.1
i-136e00c0 t2.micro 1b 12 mins 0.15 0.07 5.5 0.0 0.9 93.2 0.0
i-126e00c1 t2.micro 1b 12 mins 0.17 0.14 5.7 0.0 1.4 92.7 0.1
i-8b2cf575 t2.micro 1c 1 hour 0.19 0.08 6.5 0.0 1.2 92.1 0.1
instance-id status id version ago deployments
i-d581497d Deployed 1 Sample Application 12 mins
i-d481497c Deployed 1 Sample Application 12 mins
i-136e00c0 Deployed 1 Sample Application 12 mins
i-126e00c1 Deployed 1 Sample Application 12 mins
i-8b2cf575 Deployed 1 Sample Application 1 hour
```
# **eb init**
## Description
Define valores padrão para aplicações do Elastic Beanstalk criados com a CLI do EB pedindo que você responda a uma série de perguntas.
**nota**
Os valores definidos com **eb init** se aplicam ao diretório atual e ao repositório no computador atual.
O comando cria uma aplicação do Elastic Beanstalk na sua conta. Para criar um ambiente do Elastic Beanstalk, execute **[eb create](eb3-create.md)** após a execução de **eb init**.
## Sintaxe
**eb init**
**eb init** *application-name*
## Opções
Se você executar **eb init** sem especificar a opção `--platform`, a CLI do EB solicita que você insira um valor para cada configuração.
**nota**
Para usar **eb init** para criar um novo par de chaves, instale `ssh-keygen` em sua máquina local e disponibilize-o na linha de comando.
****
| Nome | Descrição | |
| --- | --- | --- |
| `-i` `--interactive` | Força a EB CLI a pedir que você forneça um valor para cada opção de comando **eb init**. O comando `init` pede que você forneça valores para as opções do comando **eb init** que não têm um valor (padrão). Após a primeira execução do comando **eb init** em um diretório, a EB CLI pode não perguntar sobre nenhuma opção de comando. Portanto, use a opção `--interactive` quando desejar alterar uma configuração previamente definida. | |
| `-k` *keyname* `--keyname` *keyname* | 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 executam seu aplicativo Elastic Beanstalk. | |
| `--modules folder-1 folder-2` | Lista de diretórios filho para inicializar. Somente para uso com [ambientes do Compose](ebcli-compose.md). | |
| `-p` *platform-version* `--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-init.html) Use [`eb platform list`](eb3-platform.md) para obter uma lista de configurações disponíveis. Especifique a opção `--platform` para ignorar a configuração interativa. Quando você especificar essa opção, a EB CLI não solicitará valores para as demais opções. Em vez disso, ele usa valores padrão para cada opção. É possível definir todas as opções para as quais não deseja usar valores padrão. | |
| `--source codecommit/repository-name/branch-name` | CodeCommit repositório e filial. | |
| `--tags key1=value1[,key2=value2 ...]` | Marque seu aplicativo. As tags são especificadas como uma lista de `key=value` separados por vírgulas. Consulte mais detalhes em [Marcar aplicativos](applications-tagging.md). |
| [Opções comuns](eb3-cmd-options.md) | | |
## CodeBuild apoio
Se você executar **eb init** em uma pasta com um arquivo [buildspec.yml](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) o Elastic Beanstalk analisará o arquivo para uma entrada **eb\$1codebuild\$1settings** com opções específicas do Elastic Beanstalk. Para obter informações sobre o CodeBuild suporte no Elastic Beanstalk, consulte. [Usando o EB CLI com AWS CodeBuild](eb-cli-codebuild.md)
## Output
Se for bem-sucedido, o comando orientará você na configuração de uma nova aplicação do Elastic Beanstalk por meio de uma série de prompts.
## Exemplo
A solicitação de exemplo a seguir inicializa a EB CLI e pede que você insira informações sobre o aplicativo. Substitua o *placeholder* texto por seus próprios valores.
```
$ eb init -i
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
Select an application to use
1) HelloWorldApp
2) NewApp
3) [ Create new Application ]
(default is 3): 3
Enter Application Name
(default is "tmp"):
Application tmp has been created.
It appears you are using PHP. Is this correct?
(y/n): y
Select a platform branch.
1) PHP 7.2 running on 64bit Amazon Linux
2) PHP 7.1 running on 64bit Amazon Linux (Deprecated)
3) PHP 7.0 running on 64bit Amazon Linux (Deprecated)
4) PHP 5.6 running on 64bit Amazon Linux (Deprecated)
5) PHP 5.5 running on 64bit Amazon Linux (Deprecated)
6) PHP 5.4 running on 64bit Amazon Linux (Deprecated)
(default is 1): 1
Do you want to set up SSH for your instances?
(y/n): y
Select a keypair.
1) aws-eb
2) [ Create new KeyPair ]
(default is 2): 1
```
# **eb labs**
## Description
Subcomandos de **eb labs** suporte work-in-progress ou funcionalidade experimental. Esses comandos podem ser removidos ou retrabalhados em futuras versões da EB CLI, sem garantia de compatibilidade.
Para obter uma lista dos subcomandos e descrições disponíveis, execute **eb labs --help**.
# **eb list**
## Description
Lista todos os ambientes no aplicativo atual ou todos os ambientes em todos os aplicativos, conforme especificado pela opção `--all`.
Se o diretório raiz contém um arquivo `platform.yaml` especificando uma plataforma personalizada, este comando também lista o ambiente do compilador.
## Sintaxe
**eb list**
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `-a` ou `--all` | Lista todos os ambientes de todos os aplicativos. |
| `-v` ou `--verbose` | Fornece informações mais detalhadas sobre todos os ambientes, incluindo instâncias. |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
Se for bem-sucedido, o comando retornará uma lista de nomes de ambiente na qual seu ambiente atual é marcado com um asterisco (\$1).
## Exemplo 1
O exemplo a seguir relaciona os seus ambientes e indica que tmp-dev é o seu ambiente padrão.
```
$ eb list
* tmp-dev
```
## Exemplo 2
O exemplo a seguir relaciona seus ambientes com detalhes adicionais.
```
$ eb list --verbose
Region: us-west-2
Application: tmp
Environments: 1
* tmp-dev : ['i-c7ee492d']
```
# **eb local**
## Description
Use **eb local run** para executar os contêineres de seu aplicativo localmente no Docker. Verifique o status do contêiner do aplicativo com **eb local status**. Abra o aplicativo em um navegador web com **eb local open**. Recupere a localização de logs do aplicativo com **eb local logs**.
**eb local setenv** e **eb local printenv** permitem que você defina e visualize variáveis de ambiente que são fornecidas aos contêineres do Docker que você executa localmente com **eb local run**.
É necessário executar todos os comandos **eb local** no diretório de projeto de um aplicativo do Docker que foi inicializado como um repositório da EB CLI usando **eb init**.
**nota**
Use **eb local** em um computador local executando Linux ou macOS. O comando não oferece suporte ao Windows.
Antes de usar o comando no macOS, instale o Docker para Mac e verifique se o boot2docker não está instalado (ou se não está no caminho de execução). O comando **eb local** tenta usar o boot2docker se estiver presente, mas não funciona bem com ele no macOS.
## Sintaxe
**eb local run**
**eb local status**
**eb local open**
**eb local logs**
**eb local setenv**
**eb local printenv**
## Opções
**eb local run**
****
| Name (Nome) | Descrição |
| --- | --- |
| `--envvars key1=value1,key2=value2` | Define variáveis do ambiente que a EB CLI passará para os contêineres do Docker local. Em ambientes de vários contêineres, todas as variáveis são passadas para todos os contêineres. |
| `--port hostport` | Mapeia uma porta no host para a porta exposta no contêiner. Se você não especificar essa opção, a EB CLI usa a mesma porta no host e no contêiner. Essa opção funciona somente com aplicativos da plataforma do Docker. Ela não se aplica à plataforma Docker de vários contêineres. |
| [Opções comuns](eb3-cmd-options.md) | |
**eb local status**
**eb local open**
**eb local logs**
**eb local setenv**
**eb local printenv**
****
| Nome | Descrição |
| --- | --- |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
**eb local run**
Mensagens de status do Docker. Permanece ativa enquanto o aplicativo estiver em execução. Pressione **Ctrl\$1C** para interromper o aplicativo.
**eb local status**
O status de cada contêiner usado pelo aplicativo, em execução ou não.
**eb local open**
Abre o aplicativo em um navegador web e sai.
**eb local logs**
A localização dos logs gerados no diretório do projeto por aplicativos em execução localmente em **eb local run**.
**eb local setenv**
Nenhum
**eb local printenv**
O nome e os valores de variáveis de ambiente definidas com **eb local setenv**.
## Exemplos
**eb local run**
```
~/project$ eb local run
Creating elasticbeanstalk_phpapp_1...
Creating elasticbeanstalk_nginxproxy_1...
Attaching to elasticbeanstalk_phpapp_1, elasticbeanstalk_nginxproxy_1
phpapp_1 | [23-Apr-2015 23:24:25] NOTICE: fpm is running, pid 1
phpapp_1 | [23-Apr-2015 23:24:25] NOTICE: ready to handle connections
```
**eb local status**
Visualize o status de seus contêineres locais:
```
~/project$ eb local status
Platform: 64bit Amazon Linux 2014.09 v1.2.1 running Multi-container Docker 1.3.3 (Generic)
Container name: elasticbeanstalk_nginxproxy_1
Container ip: 127.0.0.1
Container running: True
Exposed host port(s): 80
Full local URL(s): 127.0.0.1:80
Container name: elasticbeanstalk_phpapp_1
Container ip: 127.0.0.1
Container running: True
Exposed host port(s): None
Full local URL(s): None
```
**eb local logs**
Veja o caminho do log do projeto atual:
```
~/project$ eb local logs
Elastic Beanstalk will write logs locally to /home/user/project/.elasticbeanstalk/logs/local.
Logs were most recently created 3 minutes ago and written to /home/user/project/.elasticbeanstalk/logs/local/150420_234011665784.
```
**eb local setenv**
Defina as variáveis do ambiente que serão utilizadas com **eb local run**.
```
~/project$ eb local setenv PARAM1=value
```
Imprima as variáveis do ambiente definidas com **eb local setenv**.
```
~/project$ eb local printenv
Environment Variables:
PARAM1=value
```
# **eb logs**
## Description
O **eb logs** comando tem três finalidades distintas: ativar ou desativar o streaming de CloudWatch registros para o Logs, recuperar registros de instâncias ou CloudWatch registros de registros e solicitar uma análise do seu ambiente baseada em IA. Com a opção `--cloudwatch-logs` (`-cw`), o comando habilita ou desabilita o streaming de logs. Com a opção `--analyze` (`-ai`), o comando solicita uma análise baseada em IA dos registros, eventos e integridade da instância do seu ambiente. Sem nenhuma dessas opções, ele recupera os registros.
Ao recuperar logs, especifique a opção `--all`, `--zip` ou `--stream` para recuperar logs completos. Se você não especificar nenhuma dessas opções, o Elastic Beanstalk recuperará logs finais.
O comando processa logs do ambiente especificado ou do ambiente padrão. Os logs relevantes variam por tipo de contêiner. Se o diretório raiz contiver um arquivo `platform.yaml` especificando uma plataforma personalizada, esse comando também processará logs do ambiente do compilador.
Para obter mais informações, consulte [Usando o Elastic CloudWatch Beanstalk com o Amazon Logs](AWSHowTo.cloudwatchlogs.md). Para obter mais informações sobre a análise baseada em IA, consulte. [Análise de ambiente baseada em IA](health-ai-analysis.md)
## Sintaxe
Para ativar ou desativar o streaming de CloudWatch registros para o Logs:
```
eb logs --cloudwatch-logs [enable | disable] [--cloudwatch-log-source instance | environment-health | all] [environment-name]
```
Para recuperar logs de instâncias:
```
eb logs [-all | --zip | --stream] [--cloudwatch-log-source instance] [--instance instance-id] [--log-group log-group] [environment-name]
```
Para recuperar logs de integridade do ambiente:
```
eb logs [-all | --zip | --stream] --cloudwatch-log-source environment-health [environment-name]
```
Para solicitar uma análise baseada em IA:
```
eb logs --analyze [environment-name]
```
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `-cw [enable \| disable]` or `--cloudwatch-logs [enable \| disable]` | Ativa ou desativa o streaming de CloudWatch registros para o Logs. Se nenhum argumento for fornecido, o streaming de logs será habilitado. Se a opção `--cloudwatch-log-source` (`-cls`) não for especificada, o streaming de logs de instância será habilitado ou desabilitado. |
| `-cls instance \| environment-health \| all` or `--cloudwatch-log-source instance \| environment-health \| all` | Especifica a origem dos registros ao trabalhar com o CloudWatch Logs. Com a forma de ativação ou desativação do comando, esses são os registros para os quais ativar ou desativar o streaming de CloudWatch registros. Com a forma de recuperação do comando, esses são os registros a serem recuperados do CloudWatch Logs. Valores válidos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/eb3-logs.html) Significados dos valores: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/eb3-logs.html) |
| `-a` ou `--all` | Recupera logs completos e salva-os no diretório `.elasticbeanstalk/logs`. |
| `-z` ou `--zip` | Recupera logs completos, compacta-os em um arquivo `.zip` e, em seguida, salva o arquivo no diretório `.elasticbeanstalk/logs`. |
| `--stream` | Transmite (saídas contínuas) logs completos. Com essa opção, o comando continua a ser executado até que você o interrompa (pressione **Ctrl\$1C**). |
| `-i instance-id` ou `--instance instance-id` | Recupera apenas os logs de uma instância especificada. |
| `-g log-group` or `--log-group log-group` | Especifica o grupo de CloudWatch registros de registros do qual os registros serão recuperados. A opção é válida somente quando o streaming de registros da instância para CloudWatch Logs está ativado. Se o streaming de log de instância estiver habilitado, e você não especificar a opção `--log-group`, o grupo de logs padrão será um dos seguintes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/eb3-logs.html) Para obter informações sobre o grupo de logs correspondente a cada arquivo de log, visite [Como o Elastic Beanstalk configura os registros CloudWatch](AWSHowTo.cloudwatchlogs.md#AWSHowTo.cloudwatchlogs.loggroups). |
| `-ai` or `--analyze` | Solicita uma análise baseada em IA dos registros, eventos e integridade da instância do seu ambiente. A análise usa o Amazon Bedrock para identificar as causas principais e recomendar soluções para problemas de saúde ambiental. O comando envia a solicitação, aguarda a conclusão da análise e, em seguida, exibe os resultados. Essa opção não é compatível com `--instance``--all`,`--zip`,`--log-group`, ou`--cloudwatch-logs`. Para obter os pré-requisitos e as permissões necessárias, consulte. [Análise de ambiente baseada em IA](health-ai-analysis.md) |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
Por padrão, exibe os logs diretamente no terminal. Usa um programa de paginação para exibir a saída. Pressione **Q** ou **q** para sair.
Com `--stream`, mostra os logs existentes no terminal e continua em execução. Pressione **Ctrl\$1C** para sair.
Com `--all` e `--zip`, salva os logs em arquivos locais e exibe o local do arquivo.
Com`--analyze`, exibe a análise gerada pela IA diretamente no terminal após a conclusão da análise.
## Exemplos
O exemplo a seguir permite o streaming de registros de instâncias para CloudWatch Logs.
```
$ eb logs -cw enable
Enabling instance log streaming to CloudWatch for your environment
After the environment is updated you can view your logs by following the link:
https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logs:prefix=/aws/elasticbeanstalk/environment-name/
Printing Status:
2018-07-11 21:05:20 INFO: Environment update is starting.
2018-07-11 21:05:27 INFO: Updating environment environment-name's configuration settings.
2018-07-11 21:06:45 INFO: Successfully deployed new configuration to environment.
```
O exemplo a seguir recupera os logs de instância em um arquivo `.zip`.
```
$ eb logs --zip
Retrieving logs...
Logs were saved to /home/workspace/environment/.elasticbeanstalk/logs/150622_173444.zip
```
O exemplo a seguir solicita uma análise do ambiente baseada em IA.
```
$ eb logs --analyze
Analyzing environment...
No critical issues detected. Environment appears healthy.
---
Note: This analysis was generated by AI.
```
# **eb migrate**
## Description
Migra sites e aplicações do Internet Information Services (IIS) de um servidor Windows para o Elastic Beanstalk. O comando empacota suas aplicações, preserva suas configurações e as implanta em um novo ambiente do Elastic Beanstalk.
Para obter mais informações sobre como migrar seus sites e aplicações do IIS, consulte [Migrar aplicações do IIS para o Elastic Beanstalk](dotnet-migrating-applications.md).
**nota**
Antes de usar este comando, certifique-se de que seu sistema atenda aos seguintes requisitos necessários:
Serviços de Informação da Internet (IIS) versão 7.0 ou posterior
Web Deploy 3.6 ou posterior instalado
Privilégios administrativos no Windows Server
AWS credenciais configuradas com as permissões apropriadas
Seu servidor de origem tem acesso de saída à Internet aos AWS serviços.
As etapas a seguir resumem o processo de migração:
1. Descubra sites do IIS e suas configurações.
1. Empacote o conteúdo e a configuração da aplicação.
1. Crie um ambiente e uma aplicação do Elastic Beanstalk.
1. Implante a aplicação com configurações preservadas.
O comando cria artefatos de migração em um diretório estruturado, como mostra a lista a seguir:
```
C:\migration_workspace\
└── .\migrations\latest\
├── upload_target.zip
└── upload_target\
├── [SiteName].zip # One ZIP per default application of IIS site
├── [SiteName-ApplicationName].zip # One ZIP per additional application
├── aws-windows-deployment-manifest.json
└── ebmigrateScripts\
├── site_installer.ps1 # Site installation scripts
├── permission_handler.ps1 # Permission management
└── other helper scripts
```
Use **eb migrate cleanup** para gerenciar esses artefatos.
## Sintaxe
**eb migrate *[options]***
**eb migrate explore *[options]***
**eb migrate cleanup *[options]***
Quando executado sem argumentos, **eb migrate** opera no modo não interativo. Para executá-lo no modo interativo, execute **eb migrate --interactive**.
O comando do modo interativo solicita as seguintes informações:
+ Seleção de sites do IIS para migrar
+ Nomes do ambiente e da aplicação
+ Seleção da versão da plataforma
+ Tipo de instância e outras opções de configuração
## Subcomandos
### explore
O subcomando **eb migrate explore** examina seu servidor IIS e lista os sites disponíveis.
Use esse comando para exibir as seguintes informações:
+ Exibir todos os sites do IIS no servidor
+ Com `--verbose`, inspecione a configuração detalhada, incluindo:
+ Ligações e portas do site
+ Grupos de aplicações
+ Diretórios virtuais e seus caminhos físicos
+ Configurações de Autenticação
```
PS C:\migrations_workspace > eb migrate explore
Default Web Site
Site2
site3
router
```
```
PS C:\migrations_workspace > eb migrate explore --verbose
1: Default Web Site:
- Bindings:
- *:8083:
- Application '/':
- Application Pool: DefaultAppPool
- Enabled Protocols: http
- Virtual Directories:
- /:
- Physical Path: C:\inetpub\wwwroot
- Logon Method: ClearText
- Application '/dotnet-6-0':
- Application Pool: DefaultAppPool
- Enabled Protocols: http
- Virtual Directories:
- /:
- Physical Path: C:\inetpub\AspNetCoreWebApps\CoreWebApp-6-0
- Logon Method: ClearText
- Application '/dotnet-8-0':
- Application Pool: DefaultAppPool
- Enabled Protocols: http
- Virtual Directories:
- /:
- Physical Path: C:\inetpub\AspNetCoreWebApps\CoreWebApp-8-0
- Logon Method: ClearText
2: Site2:
- Bindings:
- *:8081:
...
```
### Limpeza
O subcomando **eb migrate cleanup** gerencia os artefatos de migração com as seguintes ações:
+ Preservar a migração bem-sucedida mais recente em `./migrations/latest`
+ Remover diretórios de migração mais antigos
+ Manutenção de arquivos de configuração críticos
```
PS C:\migrations_workspace > eb migrate cleanup
Are you sure you would like to cleanup older artifacts within `./migrations/`? (y/N):
```
Use `--force` para ignorar as solicitações de confirmação durante a limpeza.
```
PS C:\migrations_workspace > eb migrate cleanup --force
```
## Opções
Nenhuma dessas opções é obrigatória. Se você executar **eb migrate** sem opção, a EB CLI será executada no modo não interativo. Com **eb migrate --interactive**, a EB CLI solicita que você insira ou selecione um valor para as configurações necessárias.
****
| Name (Nome) | Descrição |
| --- | --- |
| `-a` *application-name* or `--application-name` *application-name* | Nome para a nova aplicação Elastic Beanstalk. Tipo: string Padrão: EBMigrated App |
| `--archive` *directory-or-zip* | O diretório ou arquivo ZIP contendo o código-fonte gerado anteriormente por **eb migrate --archive-only**. Use essa opção para implantar um pacote de migração criado anteriormente. Exemplo: `--archive .\migrations\latest\upload_target` ou `--archive .\migrations\latest\upload_target.zip` |
| `-ao` or `--archive-only` | Crie somente o diretório de arquivamento de destino sem implantação. O diretório resultante pode ser implantado manualmente usando **eb migrate** com a opção `archive` ou **eb deploy**. |
| `-c` *subdomain-name* or `--cname` *subdomain-name* | O nome do subdomínio para prefixar a entrada de CNAME DNS para seu aplicação migrado. Tipo: string Padrão: o nome do ambiente |
| `-cf` or `--copy-firewall-config` | Copie a configuração do firewall do servidor de origem para o destino de todas as portas HTTP com associações ativas. Cria regras de grupo de segurança correspondentes em AWS. |
| `-es` *snapshot-id* [*snapshot-id* ...] or `--ebs-snapshots` *snapshot-id* [*snapshot-id* ...] | Lista separada por vírgulas do snapshot do Amazon EBS IDs para associar ao ambiente. Exemplo: `--ebs-snapshots snap-1234567890abcdef0, snap-0987654321fedcba1` |
| `--encrypt-ebs-volumes` | Aplique criptografia para todos os volumes do Amazon EBS. Essa é uma configuração de toda a conta que afeta toda a criação futura de volumes do Amazon EBS. |
| `-e` *environment-name* or `--environment-name` *environment-name* | Nome para o novo ambiente do Elastic Beanstalk. Tipo: string Padrão: EBMigrated Env Restrições: deve ter entre 4 e 40 caracteres. Pode pode conter somente letras, números e hifens. Não pode começar ou terminar com um hífen (-). |
| `--force` | Ignore os prompts de confirmação durante as operações. Quando usado com o subcomando **cleanup**, remove artefatos de migração sem confirmação. |
| `-ip` *profile-name* or `--instance-profile` *profile-name* | Perfil de instância para associar às EC2 instâncias Amazon do ambiente. Se não for especificado, cria um perfil de instância padrão com permissões para acessar os recursos do Elastic Beanstalk. Para obter mais informações, consulte [Perfil de instância do Elastic Beanstalk](concepts-roles-instance.md). |
| `-i` *instance-type* or `--instance-type` *instance-type* | O tipo de EC2 instância da Amazon para seu ambiente do Elastic Beanstalk. Tipo: string Padrão: c5.2xlarge Para ver os tipos de instância disponíveis, consulte [os tipos de EC2 instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) da *Amazon no Guia EC2 do usuário da Amazon*. |
| `-in` or `--interactive` | Forçar o modo interativo para o processo de migração. Solicita valores de configuração mesmo quando padrões estão disponíveis. |
| `-k` *key-name* or `--keyname` *key-name* | Amazon EC2 key pair para permitir o acesso RDP às instâncias do ambiente. Útil para investigar problemas no nível da instância que não são visíveis nos logs. Valores válidos: um nome de par de chaves existente registrado na Amazon EC2 |
| `-p` *platform-version* or `--platform` *platform-version* | Runtime da plataforma Elastic Beanstalk para o ambiente. Se não for especificado, detectado automaticamente a partir da versão host do Windows Server. Exemplo: `"64bit Windows Server 2016 v2.16.2 running IIS 10.0"` Para obter uma lista das versões disponíveis da plataforma, use a [lista de plataformas eb](eb3-platform.md#eb3-platform-list). |
| `--remote` | Indica a execução da migração no modo remoto. Essa opção permite a execução a partir de um bastion host, que se conecta ao servidor de destino que contém o aplicação e as configurações a serem migradas para o Elastic Beanstalk. Em execução a partir do servidor bastion, `eb migrate` descobre configurações, organiza a lógica de migração no bastion host e, em seguida, implanta sua aplicação em um novo ambiente do Elastic Beanstalk. Essa opção dispensa a necessidade de instalar a EB CLI e o Python no servidor Windows que você precisa migrar. Em vez disso, você instala o Python e a EB CLI em um bastion host, onde executa o comando **eb migrate** com a opção `--remote`. Use a opção `--target-ip` para especificar o host com as configurações do IIS a serem migradas. Deve ser usado com `--target-ip`, `--username` e `--password`. |
| `--target-ip` *ip-address* | Endereço IP público da máquina Windows remota que contém os servidores IIS a serem migrados. Necessário ao usar `--remote`. Só pode ser especificado ao usar `--remote`. |
| `--username` *username* | Nome de usuário do perfil de usuário para acessar a máquina Windows remota que contém os servidores IIS a serem migrados. Necessário ao usar `--remote`. Só pode ser especificado ao usar `--remote`. |
| `--password` *password* | Senha do perfil do usuário para acessar a máquina Windows remota que contém os servidores IIS a serem migrados. Necessário ao usar `--remote`. Só pode ser especificado ao usar `--remote`. |
| `-sr` *role-name* or `--service-role` *role-name* | Função de serviço do IAM para o Elastic Beanstalk gerenciar serviços relacionados. AWS Se não for especificado, cria um perfil de serviço padrão com as permissões necessárias. Para obter mais informações, consulte [Função de serviço do Elastic Beanstalk](concepts-roles-service.md). Especifique somente o nome do perfil, não o ARN completo. O Elastic Beanstalk cria automaticamente o ARN completo. |
| `-s` *site-names* or `--sites` *site-names* | Lista separada por vírgulas dos sites do IIS para migrar. Se não for especificado, migra todos os sites disponíveis no servidor. Exemplo: `--sites "Default Web Site,Intranet,API"` |
| `--ssl-certificates` *certificate-arn*[,*certificate-arn* ...] | Lista separada por vírgulas do certificado SSL do ACM ARNs para associar ao Application Load Balancer. Obrigatória ao migrar sites com associações HTTPS. Exemplo: `--ssl-certificates arn:aws:acm:region:account:certificate/certificate-id` |
| `-t key1=value1[,key2=value2 ...]` or `--tags key1=value1[,key2=value2 ...]` | Lista de pares de `key=value` separados por vírgulas para marcar novos recursos no seu ambiente: ambiente, aplicação do Elastic Beanstalk, versão da aplicação. Para obter mais informações, consulte [Marcação de ambientes](using-features.tagging.md). |
| `--verbose` | Mostre informações detalhadas durante o processo de migração. Quando usado com o subcomando **explore**, exibe detalhes abrangentes da configuração do site. |
| `-vpc` *config-file-or-string* or `--vpc-config` *config-file-or-string* | Configuração de VPC para o ambiente, especificada como um caminho de arquivo JSON ou uma string JSON. A configuração deve incluir: {
"id": "vpc-1234567890abcdef0",
"publicip": "true|false",
"elbscheme": "public|private",
"ec2subnets": ["subnet-a1b2c3d4", "subnet-e5f6g7h8"],
"securitygroups": "sg-123456,sg-789012",
"elbsubnets": ["subnet-a1b2c3d4", "subnet-e5f6g7h8"]
} [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/eb3-migrate.html) *A migração ignorará todas as configurações de VPC existentes do ambiente de origem quando você especificar o *parâmetro* *`--vpc-config`. Quando você usa esse parâmetro, a migração usará apenas as configurações de VPC especificadas no arquivo de configuração que você está passando. O uso desse parâmetro substitui o comportamento padrão de descobrir a configuração da VPC da instância de origem ou usar a VPC padrão. |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
O comando fornece atualizações de status durante todo o processo de migração:
1. Detecção de configuração de VPC (ao executar em uma EC2 instância)
1. Progresso da geração do pacote de origem para cada site
1. Status de criação do ambiente
1. Progresso da implantação
Se for bem-sucedido, exibe os detalhes do novo ambiente, incluindo:
+ Nome e ID da do ambiente
+ Nome da aplicação
+ Região
+ Versão da plataforma
+ CNAME do ambiente
Para problemas durante a migração, use os comandos [**eb health**](eb3-health.md) e [**eb events**](eb3-events.md) para obter informações detalhadas.
## Exemplos
### Uso básico
Migração básica no modo interativo:
```
PS C:\migrations_workspace > eb migrate
Identifying VPC configuration of this EC2 instance (i-0123456789abcdef0):
id: vpc-1234567890abcdef0
publicip: true
elbscheme: public
ec2subnets: subnet-123,subnet-456,subnet-789
securitygroups: sg-123,sg-456
elbsubnets: subnet-123,subnet-456,subnet-789
Using .\migrations\latest to contain artifacts for this migration run.
Generating source bundle for sites, applications, and virtual directories...
Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip
Creating application version
Creating environment
Environment details for: EBMigratedEnv
Application name: EBMigratedApp
Region: us-west-2
Deployed Version: app-230320_153045
Environment ID: e-abcdef1234
Platform: 64bit Windows Server 2019 v2.7.0 running IIS 10.0
Tier: WebServer-Standard-1.0
CNAME: ebmigratedenv.us-west-2.elasticbeanstalk.com
Updated: 2023-03-20 15:30:45
```
Migração de sites específicos com configuração personalizada:
```
PS C:\migrations_workspace > eb migrate `
--sites "Default Web Site,InternalAPI" `
--application-name "CorporateApp" `
--environment-name "Production" `
--instance-type "c5.xlarge" `
--tags "Environment=Production,Team=WebOps" `
--copy-firewall-config
```
Criar um arquivo de migração sem implantação:
```
PS C:\migrations_workspace > eb migrate --archive-only
Using .\migrations\latest to contain artifacts for this migration run.
Generating source bundle for sites, applications, and virtual directories...
Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip
Generated destination archive directory at .\migrations\latest\upload_target
You can execute `eb init` and `eb create` from this directory to deploy to EB.
```
### Exemplos de configuração avançados
Migração com configuração de VPC personalizada usando um arquivo JSON:
```
PS C:\migrations_workspace > cat vpc-config.json
{
"id": "vpc-1234567890abcdef0",
"publicip": "false",
"elbscheme": "internal",
"ec2subnets": [
"subnet-private1",
"subnet-private2"
],
"securitygroups": [
"sg-app",
"sg-database",
"sg-monitoring"
],
"elbsubnets": [
"subnet-private1",
"subnet-private2"
]
}
PS C:\migrations_workspace eb migrate `
--sites "InternalAPI" `
--vpc-config vpc-config.json `
--instance-type "r5.xlarge" `
--tags "Environment=Internal,Security=High"
```
Migrar sites com certificados SSL e cabeçalhos de host:
```
PS C:\migrations_workspace > eb migrate `
--sites "SecurePortal" `
--ssl-certificates "arn:aws:acm:region:account:certificate/cert1,arn:aws:acm:region:account:certificate/cert2" `
--verbose
INFO: Detected HTTPS bindings:
- www.example.com:443
- api.example.com:443
INFO: Configuring Application Load Balancer with SSL certificates
INFO: Creating host-based routing rules:
- www.example.com -> target group 1
- api.example.com -> target group 2
```
Migração com configuração de snapshot do EBS:fo
```
PS C:\migrations_workspace > eb migrate `
--sites "Default Web Site" `
--ebs-snapshots "snap-1234567890abcdef0" "snap-0987654321fedcba1" `
--encrypt-ebs-volumes
Using .\migrations\latest to contain artifacts for this migration run.
INFO: Enabling EBS encryption for all new volumes in us-west-2
INFO: Configuring environment with specified EBS snapshots
```
### Exemplos de configuração de segurança
Lidar com sites com regras de firewall complexas:
```
PS C:\migrations_workspace > eb migrate `
--sites "Default Web Site,ReportingService" `
--copy-firewall-config `
--verbose
INFO: Detected the following Windows Firewall rules:
- Allow Web Traffic (TCP 80, 443)
- Allow Reporting Traffic (TCP 8081)
INFO: Creating corresponding security group rules
```
Migração com perfis do IAM personalizados:
```
PS C:\migrations_workspace > eb migrate `
--sites "SecureApp" `
--instance-profile "CustomInstanceProfile" `
--service-role "CustomServiceRole"
```
### Exemplos de execução remota
Migrar aplicações do IIS de um Windows Server remoto:
```
PS C:\migrations_workspace > eb migrate `
--remote `
--target-ip "192.0.2.10" `
--username "administrator" `
--password "YourPassword123" `
--application-name "RemoteApp" `
--environment-name "RemoteEnv"
INFO: Establishing SSH connection to remote host 192.0.2.10...
INFO: Connection established
INFO: Discovering IIS sites on remote host...
INFO: Found 2 sites: Default Web Site, API
INFO: Extracting site configurations...
INFO: Generating source bundle for sites, applications, and virtual directories...
Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip
API/ -> .\migrations\latest\upload_target\API.zip
Creating application version
Creating environment
Environment details for: RemoteEnv
Application name: RemoteAppstage mi
Region: us-west-2
Deployed Version: app-230320_153045
Environment ID: e-abcdef1234
Platform: 64bit Windows Server 2019 v2.7.0 running IIS 10.0
Tier: WebServer-Standard-1.0
CNAME: remoteenv.us-west-2.elasticbeanstalk.com
Updated: 2023-03-20 15:30:45
```
Migração remota com seleção de site específico:
```
PS C:\migrations_workspace > eb migrate `
--remote `
--target-ip "192.0.2.10" `
--username "administrator" `
--password "YourPassword123" `
--sites "API" `
--instance-type "c5.large"
```
# **eb open**
## Description
Abre o URL público do site no navegador padrão.
## Sintaxe
**eb open**
**eb open *environment-name***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
O comando **eb open** não gera saída. Em vez disso, ele abre o aplicativo em uma janela do navegador.
# **eb platform**
## Description
Este comando dá suporte a dois espaços de trabalho diferentes:
[Plataforma](#eb3-platform-preconfigured)
Use este espaço de trabalho para gerenciar plataformas personalizadas.
[Ambiente](#eb3-platform-environment)
Use este espaço de trabalho para selecionar uma plataforma padrão ou mostrar informações sobre a plataforma atual.
O Elastic Beanstalk fornece o atalho **ebp** para **eb platform**.
**nota**
O Windows PowerShell usa **ebp** como alias de comando. Se você estiver executando o EB CLI no Windows PowerShell, use a forma longa desse comando —. **eb platform**
## Usar eb platform para plataformas personalizadas
Lista as versões da plataforma atual e permite que você gerencie plataformas personalizadas.
### Sintaxe
**eb platform create [*version*] [*options*]**
**eb platform delete [*version*] [*options*]**
**eb platform events [*version*] [*options*]**
**eb platform init [*platform*] [*options*]**
**eb platform list [*options*]**
**eb platform logs [*version*] [*options*]**
**eb platform status [*version*] [*options*]**
**eb platform use [*platform*] [*options*]**
### Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `create [version] [options]` | Criar uma nova versão da plataforma. [Saiba mais](#eb3-platform-create). |
| `delete version [options]` | Excluir uma versão da plataforma. [Saiba mais](#eb3-platform-delete). |
| `events [version] [options]` | Exibir os eventos de uma versão da plataforma. [Saiba mais](#eb3-platform-events). |
| `init [platform] [options]` | Inicializar um repositório de plataforma. [Saiba mais](#eb3-platform-init). |
| `list [options]` | Listar as versões da plataforma atual. [Saiba mais](#eb3-platform-list). |
| `logs [version] [options]` | Exibir logs do ambiente do compilador para uma versão da plataforma. [Saiba mais](#eb3-platform-logs). |
| `status [version] [options]` | Exibir o status de uma versão da plataforma. [Saiba mais](#eb3-platform-status). |
| `use [platform] [options]` | Selecionar uma plataforma diferente a partir da qual novas versões são criadas. [Saiba mais](#eb3-platform-use). |
| [Opções comuns](eb3-cmd-options.md) | |
### Opções comuns
Todos os comandos **eb platform** incluem as seguintes opções comuns.
****
| Nome | Descrição |
| --- | --- |
| `-h` OU `--help` | Mostra uma mensagem de ajuda e sai. |
| `--debug` | Mostra saída de depuração adicional. |
| `--quiet` | Suprime toda a saída. |
| `-v` OU `--verbose` | Mostra saída adicional. |
| `--profile PROFILE` | Usa o especificado *PROFILE* de suas credenciais. |
| `-r REGION` OU `--region REGION` | Use a região*REGION*. |
| `--no-verify-ssl` | Não verifique os certificados AWS SSL. |
### Eb platform create
Cria uma nova versão da plataforma e retorna o nome de região da Amazon (ARN) da nova versão. Se não houver um ambiente de compilador em execução na região atual, o comando iniciará uma. As opções de incremento *version* e (`-M`,`-m`, e`-p`) são mutuamente exclusivas.
#### Opções
****
| Name (Nome) | Description |
| --- | --- |
| *version* | Se *version* não for especificado, cria uma nova versão com base na plataforma mais recente com a versão do patch (N em N.N.n) incrementada. |
| `-M` OU `--major-increment` | Incrementa o número de versão principal (o N em N.n.n). |
| `-m` OU `--minor-increment` | Incrementa o número de versão secundária (o N em n.N.n). |
| `-p` OU `--patch-increment` | Incrementa o número de versão de patch (o N em n.n.N). |
| `-i INSTANCE_TYPE` OU --tipo de instância *INSTANCE\$1TYPE* | Use *INSTANCE\$1TYPE* como tipo de instância, como**t1.micro**. |
| `-ip INSTANCE_PROFILE` OU `--instance-profile INSTANCE_PROFILE` | Use *INSTANCE\$1PROFILE* como perfil de instância ao criar AMIs uma plataforma personalizada. Se a opção `-ip` não estiver especificada, criará o perfil de instância `aws-elasticbeanstalk-custom-platforme-ec2-role` e o usará para a plataforma personalizada. |
| `--tags key1=value1[,key2=value2 ...]` | As tags são especificadas como uma lista de `key=value` separados por vírgulas. |
| `--timeout` *minutes* | O número definido de minutos antes do limite de tempo do comando. |
| `--vpc.id VPC_ID` | O ID da VPC na qual o Packer compila. |
| `--vpc.subnets VPC_SUBNETS` | As sub-redes VPC nas quais o Packer compila. |
| `--vpc.publicip` | Associa o público IPs às EC2 instâncias lançadas. |
### Eb platform delete
Excluir uma versão da plataforma. A versão não será excluída se um ambiente a estiver usando.
#### Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `version` | A versão para excluir. Este valor é obrigatório. |
| `--cleanup` | Remover todas as versões de plataforma no estado `Failed`. |
| `--all-platforms` | Se `--cleanup` for especificado, remove todas as versões de plataforma no estado `Failed` para todas as plataformas. |
| `--force` | Não requer confirmação ao excluir uma versão. |
### Eb platform events
Exibir os eventos de uma versão da plataforma. Se *version* for especificado, exiba os eventos dessa versão, caso contrário, exiba os eventos da versão atual.
#### Opções
****
| Name (Nome) | Description |
| --- | --- |
| *version* | A versão para a qual os eventos são exibidos. Este valor é obrigatório. |
| `-f` OU `--follow` | Continuar a exibir os eventos à medida que ocorrem. |
### Eb platform init
Inicializar um repositório de plataforma.
#### Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `platform` | O nome da plataforma para inicializar. Este valor é obrigatório, a menos que `-i` (modo interativo) esteja habilitado. |
| `-i` OU `--interactive` | Usar o modo interativo. |
| `-k KEYNAME` OU `--keyname KEYNAME` | O nome da EC2 chave padrão. |
Você pode executar este comando em um diretório previamente inicializado, embora não possa alterar o tipo de espaço de trabalho se executado em um diretório previamente inicializado.
Para reinicializar com opções diferentes, use a opção `-i`.
### Eb platform list
Listar as versões da Plataforma associada a um espaço de trabalho (diretório) ou uma região.
O comando retorna resultados diferentes dependendo do tipo de espaço de trabalho no qual você o executa da seguinte forma:
+ Em um workspace da Plataforma (um diretório inicializado por `eb platform init`), o comando retornará uma lista de todas as versões de Plataforma da Plataforma personalizada definida no workspace. Adicione a opção `--verbose` ou `--all-platforms` para obter uma lista de todas as versões de Plataforma de todas as Plataformas personalizadas que sua conta tiver na região associada ao workspace.
+ Em um workspace da aplicação (um diretório inicializado por `eb init`), o comando retornará uma lista de todas as versões de plataforma, tanto para plataformas gerenciadas pelo Elastic Beanstalk quanto para as plataformas personalizadas da sua conta. A lista usa nomes curtos de versão da Plataforma, e algumas variáveis da versão da Plataforma podem ser combinadas. Adicione a opção `--verbose` para obter uma lista detalhada com nomes completos e todas as variáveis listadas separadamente.
+ Em um diretório não inicializado, o comando só funciona com a opção `--region`. Ele retorna uma lista de todas as versões de plataforma gerenciada pelo Elastic Beanstalk compatíveis na região. A lista usa nomes curtos de versão da Plataforma, e algumas variáveis da versão da Plataforma podem ser combinadas. Adicione a opção `--verbose` para obter uma lista detalhada com nomes completos e todas as variáveis listadas separadamente.
#### Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `-a` OU `--all-platforms` | Válido somente em um workspace inicializado (um diretório inicializado por `eb platform init` ou `eb init`). Lista as versões das Plataformas de todas as Plataformas associadas à sua conta. |
| `-s STATUS` OU `--status STATUS` | Liste somente as plataformas que correspondem a*STATUS*: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/eb3-platform.html) |
### Eb platform logs
Exibir logs do ambiente do compilador para uma versão da plataforma.
#### Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `version` | A versão da plataforma cujos logs são exibidos. Se omitido, exibe logs da versão atual. |
| `--stream` | Transmita os registros de implantação que foram configurados com CloudWatch. |
### Eb platform status
Exibir o status de uma versão da plataforma.
#### Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `version` | A versão da plataforma cujo status é recuperado. Se omitida, exibe o status da versão atual. |
### Eb platform use
Selecionar uma plataforma diferente a partir da qual novas versões são criadas.
#### Opções
****
| Name (Nome) | Description |
| --- | --- |
| `platform` | Especifica *platform* como a versão ativa desse espaço de trabalho. Este valor é obrigatório. |
## Usar eb platform para ambientes
Lista as plataformas compatíveis e permite que você defina a plataforma padrão e a versão da plataforma a serem usadas ao iniciar um ambiente. Use **eb platform list** para ver uma lista de todas as plataformas compatíveis. Use **eb platform select** para alterar a plataforma de seu projeto. Use **eb platform show** para ver a plataforma selecionada de seu projeto.
### Sintaxe
**eb platform list**
**eb platform select**
**eb platform show**
### Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `list` | Listar a versão da plataforma atual. |
| `select` | Selecionar a plataforma padrão. |
| `show` | Mostrar informações sobre a plataforma atual. |
### Exemplo 1
O exemplo a seguir lista os nomes de todas as configurações para todas as plataformas compatíveis com o Elastic Beanstalk.
```
$ eb platform list
docker-1.5.0
glassfish-4.0-java-7-(preconfigured-docker)
glassfish-4.1-java-8-(preconfigured-docker)
go-1.3-(preconfigured-docker)
go-1.4-(preconfigured-docker)
iis-7.5
iis-8
iis-8.5
multi-container-docker-1.3.3-(generic)
node.js
php-5.3
php-5.4
php-5.5
python
python-2.7
python-3.4
python-3.4-(preconfigured-docker)
ruby-1.9.3
ruby-2.0-(passenger-standalone)
ruby-2.0-(puma)
ruby-2.1-(passenger-standalone)
ruby-2.1-(puma)
ruby-2.2-(passenger-standalone)
ruby-2.2-(puma)
tomcat-6
tomcat-7
tomcat-7-java-6
tomcat-7-java-7
tomcat-8-java-8
```
### Exemplo 2
O exemplo a seguir solicita que você escolha a plataforma em uma lista de plataformas e a versão que você deseja implantar para a plataforma especificada.
```
$ eb platform select
Select a platform.
1) PHP
2) Node.js
3) IIS
4) Tomcat
5) Python
6) Ruby
7) Docker
8) Multi-container Docker
9) GlassFish
10) Go
(default is 1): 5
Select a platform version.
1) Python 2.7
2) Python
3) Python 3.4 (Preconfigured - Docker)
```
### Exemplo 3
O exemplo a seguir mostra informações sobre a plataforma padrão atual.
```
$ eb platform show
Current default platform: Python 2.7
New environments will be running: 64bit Amazon Linux 2014.09 v1.2.0 running Python 2.7
Platform info for environment "tmp-dev":
Current: 64bit Amazon Linux 2014.09 v1.2.0 running Python
Latest: 64bit Amazon Linux 2014.09 v1.2.0 running Python
```
# **eb printenv**
## Description
Imprime todas as propriedades de ambiente na janela de comando.
## Sintaxe
**eb printenv**
**eb printenv *environment-name***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
Se for bem-sucedido, o comando retornará o status da operação `printenv`.
## Exemplo
O exemplo a seguir imprime as propriedades de ambiente do ambiente especificado.
```
$ eb printenv
Environment Variables:
PARAM1 = Value1
```
# **eb restore**
## Description
Reconstrói um ambiente encerrado, criando um novo ambiente com os mesmos nome, ID e configuração. O nome do ambiente, o nome de domínio e a versão do aplicativo devem estar disponíveis para uso para que a reconstrução seja bem-sucedida.
## Sintaxe
**eb restore**
**eb restore *environment\$1id***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
A EB CLI exibe uma lista de ambientes encerrados que estão disponíveis para restauração.
## Exemplo
```
$ eb restore
Select a terminated environment to restore
# Name ID Application Version Date Terminated Ago
3 gamma e-s7mimej8e9 app-77e3-161213_211138 2016/12/14 20:32 PST 13 mins
2 beta e-sj28uu2wia app-77e3-161213_211125 2016/12/14 20:32 PST 13 mins
1 alpha e-gia8mphu6q app-77e3-161213_211109 2016/12/14 16:21 PST 4 hours
(Commands: Quit, Restore, ▼ ▲)
Selected environment alpha
Application: scorekeep
Description: Environment created from the EB CLI using "eb create"
CNAME: alpha.h23tbtbm92.us-east-2.elasticbeanstalk.com
Version: app-77e3-161213_211109
Platform: 64bit Amazon Linux 2016.03 v2.1.6 running Java 8
Terminated: 2016/12/14 16:21 PST
Restore this environment? [y/n]: y
2018-07-11 21:04:20 INFO: restoreEnvironment is starting.
2018-07-11 21:04:39 INFO: Created security group named: sg-e2443f72
...
```
# **eb scale**
## Description
Escala o ambiente para sempre executar um número específico de instâncias, definindo o número mínimo e máximo de instâncias como o número especificado.
## Sintaxe
**eb scale *number-of-instances***
**eb scale *number-of-instances* *environment-name***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| --timeout | O número de minutos antes de esgotar o tempo limite do comando. |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
Se for bem-sucedido, o comando atualizará o número mínimo e máximo de instâncias a executar para o número especificado.
## Exemplo
O exemplo a seguir define o número de instâncias como 2.
```
$ eb scale 2
2018-07-11 21:05:22 INFO: Environment update is starting.
2018-07-11 21:05:27 INFO: Updating environment tmp-dev's configuration settings.
2018-07-11 21:08:53 INFO: Added EC2 instance 'i-5fce3d53' to Auto Scaling Group 'awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E'.
2018-07-11 21:08:58 INFO: Successfully deployed new configuration to environment.
2018-07-11 21:08:59 INFO: Environment update completed successfully.
```
# **eb setenv**
## Description
Define as [propriedades do ambiente](environments-cfg-softwaresettings.md) para o ambiente padrão.
## Sintaxe
**eb setenv *key*=*value***
Você pode incluir quantas propriedades quiser, mas o tamanho total de todas as propriedades não pode exceder 4096 bytes. Você pode excluir uma variável deixando o valor em branco. Para obter os limites, consulte [Configurar propriedades do ambiente (variáveis de ambiente)](environments-cfg-softwaresettings.md#environments-cfg-softwaresettings-console).
**nota**
Se o `value` contiver um [caractere especial](http://tldp.org/LDP/abs/html/special-chars.html), você deverá escapar esse caractere colocando o caractere `\` antes dele.
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| --timeout | O número de minutos antes de esgotar o tempo limite do comando. |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
Se for bem-sucedido, o comando exibe que a atualização do ambiente foi bem-sucedida.
## Exemplo
O exemplo a seguir define a variável de ambiente ExampleVar.
```
$ eb setenv ExampleVar=ExampleValue
2018-07-11 21:05:25 INFO: Environment update is starting.
2018-07-11 21:05:29 INFO: Updating environment tmp-dev's configuration settings.
2018-07-11 21:06:50 INFO: Successfully deployed new configuration to environment.
2018-07-11 21:06:51 INFO: Environment update completed successfully.
```
O comando a seguir define várias propriedades de ambiente. Ele adiciona a propriedade de ambiente chamada `foo` e define seu valor para `bar`, altera o valor da propriedade `JDBC_CONNECTION_STRING` e exclui as propriedades `PARAM4` e `PARAM5`.
```
$ eb setenv foo=bar JDBC_CONNECTION_STRING=hello PARAM4= PARAM5=
```
# **eb ssh**
## Description
**nota**
Esse comando não funciona com ambientes que executam instâncias do Windows Server.
Conecte-se a uma EC2 instância Linux da Amazon em seu ambiente usando o Secure Shell (SSH). Se um ambiente tiver várias instâncias em execução, a EB CLI solicitará que você especifique uma delas para se conectar. Para usar esse comando, o SSH deve ser instalado na máquina local e estar disponível na linha de comando. Os arquivos de chave privada devem estar localizados em uma pasta `.ssh` nomeada em seu diretório de usuário, e as EC2 instâncias em seu ambiente devem ter endereços IP públicos.
Se o diretório raiz contiver um arquivo `platform.yaml` especificando uma plataforma personalizada, esse comando também se conectará a instâncias do ambiente personalizado.
**Chaves SSH**
Se você ainda não configurou o SSH, pode usar a EB CLI para criar uma chave ao executar **eb init**. Se você já executou o **eb init**, execute-o novamente com a opção `--interactive` e selecione **Yes (Sim)** e **Create New Keypair (Criar novo par de chaves)** quando for solicitada a configuração do SSH. As chaves criadas durante esse processo serão armazenadas na pasta correta pela EB CLI.
Esse comando abre temporariamente a porta 22 no security group do seu ambiente para o tráfego de entrada de 0.0.0.0/0 (todos os endereços IP), caso não haja regras em vigor para a porta 22. Se você tiver configurado o security group do ambiente para abrir a porta 22 para um intervalo restrito de CIDR, objetivando maior segurança, a EB CLI respeitará essa configuração, ignorando quaisquer alterações feitas no security group. Para substituir esse comportamento e forçar a EB CLI a abrir a porta 22 para todo o tráfego de entrada, use a opção `--force`.
Consulte [EC2 grupos de segurança](using-features.managing.ec2.console.md#using-features.managing.ec2.securitygroups) para informações sobre como configurar o grupo de segurança do ambiente.
## Sintaxe
**eb ssh**
**eb ssh *environment-name***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `-i` ou `--instance` | Especifica o ID da instância à qual você se conecta. Recomendamos o uso dessa opção. |
| `-n` ou `--number` | Especifique a instância para conexão por número. |
| `-o` ou `--keep_open` | Deixe a porta 22 aberta no security group depois que a sessão SSH for encerrada. |
| `--command` | Execute um comando shell na instância especificada, em vez de iniciar uma sessão SSH. |
| `--custom` | Especifique um comando SSH para usar, em vez de 'ssh -i keyfile'. Não inclua o usuário remoto e o nome do host. |
| `--setup` | Altere o par de chaves atribuído às instâncias do ambiente (requer a substituição das instâncias). |
| `--force` | Abra a porta 22 para o tráfego de entrada de 0.0.0.0/0 no security group do ambiente, mesmo que o security group já esteja configurado para SSH. Use essa opção se o security group do ambiente estiver configurado para abrir a porta 22 para um intervalo restrito de CIDR que não inclui o endereço IP do qual você está tentando se conectar. |
| `--timeout` *minutes* | O número definido de minutos antes do limite de tempo do comando. Pode ser usado com o argumento `--setup`. |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
Se for bem-sucedido, o comando abrirá uma conexão SSH com a instância.
## Exemplo
O exemplo a seguir conecta você ao ambiente especificado.
```
$ eb ssh
Select an instance to ssh into
1) i-96133799
2) i-5931e053
(default is 1): 1
INFO: Attempting to open port 22.
INFO: SSH port 22 open.
The authenticity of host '54.191.45.125 (54.191.45.125)' can't be established.
RSA key fingerprint is ee:69:62:df:90:f7:63:af:52:7c:80:60:1b:3b:51:a9.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '54.191.45.125' (RSA) to the list of known hosts.
__| __|_ )
_| ( / Amazon Linux AMI
___|\___|___|
https://aws.amazon.com/amazon-linux-ami/2014.09-release-notes/
No packages needed for security; 1 packages available
Run "sudo yum update" to apply all updates.
[ec2-user@ip-172-31-8-185 ~]$ ls
[ec2-user@ip-172-31-8-185 ~]$ exit
logout
Connection to 54.191.45.125 closed.
INFO: Closed port 22 on ec2 instance security group
```
# **eb status**
## Description
Fornece informações sobre o status do ambiente.
Se o diretório raiz contiver um arquivo `platform.yaml` especificando uma plataforma personalizada, esse comando também fornecerá informações sobre o ambiente do compilador.
## Sintaxe
**eb status**
**eb status *environment-name***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `-v` ou `--verbose` | Fornece mais informações sobre instâncias individuais, como o status delas com o load balancer do Elastic Load Balancing. |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
Se tiver êxito, o comando retornará as informações a seguir sobre o ambiente:
+ Nome do ambiente
+ Application name
+ Versão do aplicativo implantada
+ ID do ambiente
+ Plataforma
+ Nível do ambiente
+ CNAME
+ Hora em que o ambiente foi atualizado pela última vez
+ Status
+ Integridade
Se você usa o modo detalhado, o EB CLI também fornece o número de instâncias da Amazon em execução. EC2
## Exemplo
O exemplo a seguir mostra o status do ambiente tmp-dev.
```
$ eb status
Environment details for: tmp-dev
Application name: tmp
Region: us-west-2
Deployed Version: None
Environment ID: e-2cpfjbra9a
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:37:19.050000+00:00
Status: Launching
Health: Grey
```
# **eb swap**
## Description
Troca o CNAME do ambiente pelo CNAME de outro ambiente (por exemplo, para evitar tempo de inatividade quando você atualizar a versão do aplicativo).
**nota**
Se você tiver mais de dois ambientes, será solicitado a selecionar o nome do ambiente que está atualmente usando o CNAME desejado em uma lista de ambientes. Para suprimir isso, especifique o nome do ambiente a usar incluindo a opção `-n` quando executar o comando.
## Sintaxe
**eb swap**
**eb swap *environment-name***
**nota**
*environment-name*É o ambiente para o qual você deseja um CNAME diferente. Se você não especificar *environment-name* como parâmetro da linha de comando ao executar**eb swap**, o EB CLI atualizará o CNAME do ambiente padrão.
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `-n` or `--destination_name` | Especifica o nome do ambiente com o qual você deseja trocar CNAMEs. Se você executar **eb swap** sem essa opção, a EB CLI solicitará que seja feita a seleção em uma lista de ambientes. |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
Se for bem-sucedido, o comando retornará o status da operação `swap`.
## Exemplos
O exemplo a seguir troca o ambiente tmp-dev pelo live-env.
```
$ eb swap
Select an environment to swap with.
1) staging-dev
2) live-env
(default is 1): 2
2018-07-11 21:05:25 INFO: swapEnvironmentCNAMEs is starting.
2018-07-11 21:05:26 INFO: Swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
2018-07-11 21:05:30 INFO: 'tmp-dev.elasticbeanstalk.com' now points to 'awseb-e-j-AWSEBLoa-M7U21VXNLWHN-487871449.us-west-2.elb.amazonaws.com'.
2018-07-11 21:05:30 INFO: Completed swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
```
O exemplo a seguir troca o ambiente tmp-dev pelo ambiente live-env, mas não solicita que você informe ou selecione um valor para as configurações.
```
$ eb swap tmp-dev --destination_name live-env
2018-07-11 21:18:12 INFO: swapEnvironmentCNAMEs is starting.
2018-07-11 21:18:13 INFO: Swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
2018-07-11 21:18:17 INFO: 'tmp-dev.elasticbeanstalk.com' now points to 'awseb-e-j-AWSEBLoa-M7U21VXNLWHN-487871449.us-west-2.elb.amazonaws.com'.
2018-07-11 21:18:17 INFO: Completed swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
```
# **eb tags**
## Description
Adicione, exclua, atualize e liste tags de um recurso do Elastic Beanstalk.
Para obter detalhes sobre a marcação de recursos no Elastic Beanstalk, consulte [Marcar recursos da aplicação do Elastic Beanstalk](applications-tagging-resources.md).
## Sintaxe
**eb tags [*environment-name*] [--resource *ARN*] -l \$1 --list**
**eb tags [*environment-name*] [--resource *ARN*] -a \$1 --add *key1*=*value1*[,*key2*=*value2* ...]**
**eb tags [*environment-name*] [--resource *ARN*] -u \$1 --update *key1*=*value1*[,*key2*=*value2* ...]**
**eb tags [*environment-name*] [--resource *ARN*] -d \$1 --delete *key1*[,*key2* ...]**
Você pode combinar as opções de subcomando `--add`, `--update` e `--delete` em um único comando. Pelo menos uma delas é necessária. Você não pode combinar nenhuma dessas três opções de subcomando com `--list`.
Sem nenhum argumento adicional, todos esses comandos listam ou modificam tags do ambiente padrão no aplicativo do diretório atual. Com um *environment-name* argumento, os comandos listam ou modificam as tags desse ambiente. Com a opção `--resource`, os comandos listam ou modificam as tags de qualquer recurso do Elastic Beanstalk: uma aplicação, um ambiente, uma versão da aplicação, uma configuração salva ou uma versão da plataforma personalizada. Especifique o recurso pelo seu nome de recurso da Amazon (ARN).
## Opções
Nenhuma dessas opções é obrigatória. Se você executar **eb create** sem opções, será solicitado a inserir ou selecionar um valor para cada configuração.
****
| Nome | Descrição |
| --- | --- |
| `-l` ou `--list` | Listar todas as tags que estão sendo aplicadas no recurso atualmente. |
| `-a key1=value1[,key2=value2 ...]` ou `--add key1=value1[,key2=value2 ...]` | Aplique novas tags no recurso. Especifique as tags como uma lista de `key=value` separados por vírgulas. Não é possível especificar chaves de tags existentes. Valores válidos. Veja [Marcar recursos](applications-tagging-resources.md). |
| `-u key1=value1[,key2=value2 ...]` ou `--update key1=value1[,key2=value2 ...]` | Atualize os valores de tags de recursos existentes. Especifique as tags como uma lista de `key=value` separados por vírgulas. Você precisa especificar chaves de tags existentes. Valores válidos. Veja [Marcar recursos](applications-tagging-resources.md). |
| `-d key1[,key2 ...]` ou `--delete key1[,key2 ...]` | Exclua as tags de recursos existentes. Especifique as tags como uma lista de chaves separados por vírgulas. Você precisa especificar chaves de tags existentes. Valores válidos. Veja [Marcar recursos](applications-tagging-resources.md). |
| `-r` *region* or `--region` *region* | O Região da AWS em que seu recurso existe. Padronizado: a região padrão configurada. 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*. |
| `--resource ARN` | O ARN do recurso para o qual o comando modifica ou lista tags. Se não for especificado, o comando refere-se ao ambiente (padrão ou especificado) no aplicativo do diretório atual. Valores válidos: consulte um dos subtópicos de [Marcar recursos](applications-tagging-resources.md) específico do recurso de interesse. Esses tópicos mostram como o ARN do recurso é construído e explicam como obter uma lista dos recursos existentes para seu aplicativo ou conta. ARNs |
## Output
A opção de subcomando de `--list` exibe uma lista das tags de recursos. A saída mostra as tags que o Elastic Beanstalk aplica por padrão e suas tags personalizadas.
```
$ eb tags --list
Showing tags for environment 'MyApp-env':
Key Value
Name MyApp-env
elasticbeanstalk:environment-id e-63cmxwjaut
elasticbeanstalk:environment-name MyApp-env
mytag tagvalue
tag2 2nd value
```
As opções de subcomando `--add`, `--update` e `--delete`, quando bem-sucedidas, não têm nenhuma saída. Você pode adicionar a opção `--verbose` para ver saída detalhada da atividade do comando.
```
$ eb tags --verbose --update "mytag=tag value"
Updated Tags:
Key Value
mytag tag value
```
## Exemplos
O comando a seguir adiciona uma tag com êxito com a chave `tag1` e o valor `value1` ao ambiente padrão do aplicativo e, ao mesmo tempo, exclui a tag `tag2`.
```
$ eb tags --add tag1=value1 --delete tag2
```
O comando a seguir adiciona uma tag com êxito a uma configuração salva em um aplicativo.
```
$ eb tags --add tag1=value1 \
--resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:configurationtemplate/my-app/my-template"
```
O comando a seguir falha porque ele tenta atualizar uma tag não existente.
```
$ eb tags --update tag3=newval
ERROR: Tags with the following keys can't be updated because they don't exist:
tag3
```
O comando a seguir falha porque ele tenta atualizar e excluir a mesma chave.
```
$ eb tags --update mytag=newval --delete mytag
ERROR: A tag with the key 'mytag' is specified for both '--delete' and '--update'. Each tag can be either deleted or updated in a single operation.
```
# **eb terminate**
## Description
Encerra o ambiente em execução para que você não incorra em cobranças por recursos não AWS utilizados.
O uso da opção `--all` exclui o aplicativo para o qual o diretório atual foi inicializado usando [**eb init**](eb3-init.md). O comando termina todos os ambientes na aplicação. Termina também todos as [versões da aplicação](applications-versions.md) e as [configurações salvas](environment-configuration-savedconfig.md) da aplicação e depois exclui a aplicação.
Se o diretório raiz contém um arquivo `platform.yaml` que especifica uma plataforma personalizada, esse comando encerra o ambiente personalizado em execução.
**nota**
Você sempre pode iniciar um novo ambiente usando a mesma versão mais tarde.
Se você tiver dados de um ambiente que deseja manter, defina a política de exclusão de banco de dados como `Retain` antes de encerrar o ambiente. Isso mantém o banco de dados operacional fora do Elastic Beanstalk. Depois disso, qualquer ambiente do Elastic Beanstalk deve se conectar a ele como um banco de dados externo. Se você quiser fazer backup dos dados sem manter o banco de dados operacional, defina a política de exclusão para fazer um snapshot do banco de dados antes de encerrar o ambiente. Para obter mais informações, consulte [Ciclo de vida do banco de dados](using-features.managing.db.md#environments-cfg-rds-lifecycle) no capítulo *Configuração de ambientes* deste guia.
**Importante**
Se você encerrar um ambiente, também deverá excluir quaisquer mapeamentos CNAME criados, pois outros clientes poderão reutilizar um nome de host disponível. Certifique-se de excluir os registros DNS que apontam para seu ambiente encerrado para evitar uma *entrada de DNS pendente*. Uma entrada de DNS pendente pode expor o tráfego da Internet destinado ao seu domínio a vulnerabilidades de segurança. Também pode apresentar outros riscos.
Para obter mais informações, consulte [Proteção contra um registro de delegação pendente no Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/protection-from-dangling-dns.html) no *Guia do desenvolvedor do Amazon Route 53*. *Você também pode aprender mais sobre entradas de DNS pendentes em [Proteções de domínio aprimoradas para solicitações da CloudFront Amazon](https://aws.amazon.com/blogs/security/enhanced-domain-protections-for-amazon-cloudfront-requests/) no AWS blog de segurança.*
## Sintaxe
**eb terminate**
**eb terminate *environment-name***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `--all` | Encerra todos os ambientes no aplicativo, bem como as [versões](applications-versions.md) e as [configurações salvas](environment-configuration-savedconfig.md) do aplicativo, e em seguida exclui o aplicativo. |
| `--force` | Termina o ambiente sem pedir confirmação. |
| `--ignore-links` | Termina o ambiente, mesmo se houver ambientes dependentes vinculados a ele. Consulte [Ambientes do Compose](ebcli-compose.md). |
| `--timeout` | O número de minutos antes de esgotar o tempo limite do comando. |
## Output
Se for bem-sucedido, o comando retornará o status da operação `terminate`.
## Exemplo
A solicitação de exemplo a seguir encerra o ambiente tmp-dev.
```
$ eb terminate
The environment "tmp-dev" and all associated instances will be terminated.
To confirm, type the environment name: tmp-dev
2018-07-11 21:05:25 INFO: terminateEnvironment is starting.
2018-07-11 21:05:40 INFO: Deleted CloudWatch alarm named: awseb-e-2cpfjbra9a-stack-AWSEBCloudwatchAlarmHigh-16V08YOF2KQ7U
2018-07-11 21:05:41 INFO: Deleted CloudWatch alarm named: awseb-e-2cpfjbra9a-stack-AWSEBCloudwatchAlarmLow-6ZAWH9F20P7C
2018-07-11 21:06:42 INFO: Deleted Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:5d7d3e6b-d59b-47c5-b102-3e11fe3047be:autoScalingGroupName/awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E:policyName/awseb-e-2cpfjbra9a-stack-AWSEBAutoSca
lingScaleUpPolicy-1876U27JEC34J
2018-07-11 21:06:43 INFO: Deleted Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:29c6e7c7-7ac8-46fc-91f5-cfabb65b985b:autoScalingGroupName/awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E:policyName/awseb-e-2cpfjbra9a-stack-AWSEBAutoSca
lingScaleDownPolicy-SL4LHODMOMU
2018-07-11 21:06:48 INFO: Waiting for EC2 instances to terminate. This may take a few minutes.
2018-07-11 21:08:55 INFO: Deleted Auto Scaling group named: awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E
2018-07-11 21:09:10 INFO: Deleted security group named: awseb-e-2cpfjbra9a-stack-AWSEBSecurityGroup-XT4YYGFL7I99
2018-07-11 21:09:40 INFO: Deleted load balancer named: awseb-e-2-AWSEBLoa-AK6RRYFQVV3S
2018-07-11 21:09:42 INFO: Deleting SNS topic for environment tmp-dev.
2018-07-11 21:09:52 INFO: terminateEnvironment completed successfully.
```
# **eb upgrade**
## Description
Atualiza a plataforma de seu ambiente para a versão mais recente da plataforma na qual ele está sendo executado no momento.
Se o diretório raiz contém um arquivo `platform.yaml` especificando uma plataforma personalizada, este comando atualiza o ambiente para a versão mais recente da plataforma personalizada em que está em execução no momento.
## Sintaxe
**eb upgrade**
**eb upgrade *environment-name***
## Opções
****
| Name (Nome) | Descrição |
| --- | --- |
| `--force` | Atualiza sem a necessidade de que você confirme o nome do ambiente antes de iniciar o processo de atualização. |
| `--noroll` | Atualiza todas as instâncias sem usar as atualizações contínuas para manter algumas instâncias em serviço durante a atualização. |
| [Opções comuns](eb3-cmd-options.md) | |
## Output
O comando mostra uma visão geral da alteração e solicita que você confirme a atualização digitando o nome do ambiente. Em caso de êxito, seu ambiente é atualizado e iniciado com a versão mais recente da plataforma.
## Exemplo
O exemplo a seguir atualiza a versão da plataforma atual do ambiente especificado para a versão mais recente disponível da plataforma.
```
$ eb upgrade
Current platform: 64bit Amazon Linux 2014.09 v1.0.9 running Python 2.7
Latest platform: 64bit Amazon Linux 2014.09 v1.2.0 running Python 2.7
WARNING: This operation replaces your instances with minimal or zero downtime. You may cancel the upgrade after it has started by typing "eb abort".
You can also change your platform version by typing "eb clone" and then "eb swap".
To continue, type the environment name:
```
# **eb use**
## Description
Define o ambiente especificado como o padrão.
Ao usar o Git, **eb use** define o ambiente padrão para a ramificação. Execute esse comando uma vez em cada ramificação que você deseje implantar no Elastic Beanstalk.
## Sintaxe
**eb use *environment-name***
## Opções
****
| Name (Nome) | Description |
| --- | --- |
| `--source codecommit/repository-name/branch-name` | CodeCommit repositório e filial. |
| `-r region` `--region region` | Altere a região na qual você cria ambientes. |
| [Opções comuns](eb3-cmd-options.md) | |