As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurar a EB CLI
<a name="eb-cli3-configuration"></a>

Após a [instalação da EB CLI](eb-cli3.md#eb-cli3-install), você está pronto para configurar o diretório do projeto e a EB CLI executando **eb init**. O exemplo a seguir mostra as etapas de configuração da EB CLI ao executar **eb init** pela primeira vez em uma pasta de projeto chamada `eb`.

**Para inicializar um projeto da EB CLI**

1. Primeiro, a EB CLI solicita que seja selecionada uma região. Escolha as regiões de sua preferência.

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

1. Se solicitado, forneça sua chave de acesso e chave secreta para que a EB CLI possa gerenciar os recursos para você. As chaves de acesso são criadas no AWS Identity and Access Management console. Se você não tiver chaves, consulte [Como obter credenciais de segurança?](https://docs.aws.amazon.com/general/latest/gr/getting-aws-sec-creds.html) na *Referência geral da Amazon Web Services*.

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

1. Uma aplicação no Elastic Beanstalk é um recurso que contém um conjunto de versões da aplicação (origem), ambientes e configurações salvas associadas a uma única aplicação Web. Cada vez que você implanta o seu código-fonte no Elastic Beanstalk usando a CLI do EB, uma nova versão da aplicação é criada e adicionada à lista.

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

1. O nome do aplicativo padrão é o nome da pasta na qual você executa **eb init**. Insira um nome que descreva o projeto.

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

1. Selecione uma plataforma que corresponda à linguagem ou framework usados para desenvolver seu aplicativo Web. Se você ainda não começou a desenvolver um aplicativo, escolha uma plataforma de seu interesse. Você verá como iniciar um aplicativo de exemplo rapidamente e poderá alterar essa configuração mais tarde.

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

1. Selecione uma ramificação específica da plataforma.

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

1. Escolha **yes (sim)** para atribuir um par de chaves SSH para as instâncias no ambiente do Elastic Beanstalk. Isso permite que você se conecte diretamente a elas e solucione problemas.

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

1. Escolha um par de chaves existente ou crie um novo. 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. O EB CLI registra o novo par de chaves na Amazon EC2 para você e armazena a chave privada localmente em uma pasta nomeada `.ssh` em seu diretório de usuário.

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

Agora, a instalação da EB CLI está configurada e pronta para uso.

**Topics**
+ [Ignorar arquivos que usam .ebignore](#eb-cli3-ebignore)
+ [Usar perfis nomeados](#eb-cli3-profile)
+ [Implantar um artefato, em vez da pasta do projeto](#eb-cli3-artifact)
+ [Definições de configuração e precedência](#eb-cli3-credentials)
+ [Metadados da instância](#eb-cli3-metadata)

## Ignorar arquivos que usam .ebignore
<a name="eb-cli3-ebignore"></a>

Você pode instruir a EB CLI a ignorar determinados arquivos no diretório do projeto por meio da adição do arquivo `.ebignore` ao diretório. Esse arquivo funciona como um `.gitignore`. Quando você implanta o diretório do projeto no Elastic Beanstalk e cria uma versão da aplicação, a CLI do EB não inclui arquivos especificados pelo `.ebignore` no pacote de origem criado.

Se não houver nenhum `.ebignore`, mas houver um `.gitignore`, a EB CLI ignorará os arquivos especificados no `.gitignore`. Se houver um `.ebignore`, a EB CLI não fará a leitura do `.gitignore`.

Quando `.ebignore` estiver presente, a EB CLI não usará 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**  
No Windows, a adição de um `.ebignore` faz com que a EB CLI siga os links simbólicos e inclua o arquivo vinculado durante a criação de um pacote de origem. Esse é um problema conhecido e será corrigido em uma atualização futura.

## Usar perfis nomeados
<a name="eb-cli3-profile"></a>

Se você armazenar suas credenciais como um perfil nomeado em um arquivo `credentials` ou `config`, poderá usar a opção [`--profile`](eb3-cmd-options.md) para especificar explicitamente um perfil. Por exemplo, o seguinte comando cria um novo aplicativo usando o perfil `user2`.

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

Você também pode alterar o perfil padrão, definindo a variável de ambiente `AWS_EB_PROFILE`. Quando essa variável está definida, a EB CLI faz a leitura das credenciais do perfil especificado, em vez de `default` ou **eb-cli**.

**Linux, macOS ou Unix**

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

**Windows**

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

## Implantar um artefato, em vez da pasta do projeto
<a name="eb-cli3-artifact"></a>

Instrua a EB CLI a implantar um arquivo ZIP ou WAR que você gera como parte de um processo de construção separado, adicionando as linhas a seguir ao `.elasticbeanstalk/config.yml` na pasta do projeto.

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

Se você configurar a CLI do EB no [repositório Git](eb3-cli-git.md) e não confirmar o artefato na fonte, use a opção `--staged` para implantar a compilação mais recente.

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

## Definições de configuração e precedência
<a name="eb-cli3-credentials"></a>

O EB CLI usa uma *cadeia de fornecedores* para procurar AWS credenciais em vários locais diferentes, incluindo variáveis de ambiente do sistema ou do usuário e arquivos de configuração locais AWS .

A EB CLI procura credenciais e definições de configuração na seguinte ordem:

1. **Opções da linha de comando**: especifica um perfil nomeado usando `--profile` para substituir as configurações padrão.

1. **Variáveis de ambiente**: `AWS_ACCESS_KEY_ID` e `AWS_SECRET_ACCESS_KEY`.

1. **O arquivo de AWS credenciais** — Localizado `~/.aws/credentials` nos sistemas Linux e OS X ou `C:\Users\{{USERNAME}}\.aws\credentials` nos sistemas Windows. Este arquivo pode conter vários perfis nomeados, além de um perfil padrão.

1. **O [arquivo de configuração da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-config-files)**: localizado em `~/.aws/config` em sistemas Linux e OS X ou `C:\Users\{{USERNAME}}\.aws\config` em sistemas Windows. Esse arquivo pode conter um perfil padrão, [perfis nomeados](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-multiple-profiles) e parâmetros de configuração AWS CLI específicos para cada um.

1. **Arquivo de configuração da CLI do EB legada**: localizado em `~/.elasticbeanstalk/config` em sistemas Linux e OS X ou `C:\Users\{{USERNAME}}\.elasticbeanstalk\config` em sistemas Windows.

1. **Credenciais do perfil da instância** — Essas credenciais podem ser usadas em EC2 instâncias da Amazon com uma função de instância atribuída e são fornecidas por meio do serviço de EC2 metadados da Amazon. O [perfil da instância](concepts-roles-instance.md) deve ter permissão para usar o Elastic Beanstalk.

Se o arquivo de credenciais contém um perfil nomeado com o nome "eb-cli", a EB CLI preferirá esse perfil em vez do perfil padrão. Se não for encontrado nenhum perfil, ou se for encontrado um perfil sem permissão para usar o Elastic Beanstalk, a CLI do EB solicitará a entrada de chaves.

## Metadados da instância
<a name="eb-cli3-metadata"></a>

Para usar o EB CLI de uma EC2 instância da Amazon, crie uma função que tenha acesso aos recursos necessários e atribua essa função à instância quando ela for executada. Inicie a instância e instale a EB CLI usando o `pip`.

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

O `pip` é fornecido pré-instalado no Amazon Linux.

A EB CLI lê as credenciais dos metadados da instância. Para obter mais informações, consulte [Conceder acesso a AWS recursos para aplicativos executados em EC2 instâncias da Amazon](https://docs.aws.amazon.com/IAM/latest/UserGuide/role-usecase-ec2app.html) no *Guia do usuário do IAM*.