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 interface de linha de comando EB (EB CLI) para gerenciar o Elastic Beanstalk
O EB CLI é uma interface de linha de comando que fornece comandos interativos para criar, atualizar e monitorar ambientes em. AWS Elastic Beanstalk O projeto de código aberto EB CLI está no Github: `[aws/aws-elastic-beanstalk-cli](https://github.com/aws/aws-elastic-beanstalk-cli)`
Depois de instalar a CLI do EB e configurar um diretório de projeto, é possível criar ambientes com um único comando:
```
$ eb create my-beanstalk-environment
```
Recomendamos instalar com o script de configuração. Saiba como em [Instalar a EB CLI com script de configuração (recomendado)](#eb-cli3-install).
O AWS CLI fornece acesso direto ao Elastic APIs Beanstalk de baixo nível. Embora poderoso, ele também é verboso e menos preferencial em relação à EB CLI. Por exemplo, criar um ambiente com o AWS CLI requer a seguinte série de comandos:
```
$ aws elasticbeanstalk check-dns-availability \
--cname-prefix my-cname
$ aws elasticbeanstalk create-application-version \
--application-name my-application \
--version-label v1 \
--source-bundle S3Bucket=amzn-s3-demo-bucket,S3Key=php-proxy-sample.zip
$ aws elasticbeanstalk create-environment \
--cname-prefix my-cname \
--application-name my-app \
--version-label v1 \
--environment-name my-env \
--solution-stack-name "64bit Amazon Linux 2023 v4.5.0 running Ruby 3.4"
```
## Instalar a EB CLI com script de configuração (recomendado)
**Recomendamos o script instalador**
Recomendamos o uso do script do instalador para configurar a EB CLI e suas dependências e evitar possíveis conflitos com outros pacotes Python.
Pré-requisitos: Git, Python e [virtualenv](https://virtualenv.pypa.io/en/latest/installation.html)
**Para baixar e usar o script instalador**
1. Clonar o repositório.
```
git clone https://github.com/aws/aws-elastic-beanstalk-cli-setup.git
```
1. Instale ou faça upgrade da EB CLI.
**macOS/Linux** em Bash ou Zsh
```
python ./aws-elastic-beanstalk-cli-setup/scripts/ebcli_installer.py
```
**Windows** em PowerShell ou janela de comando
```
python .\aws-elastic-beanstalk-cli-setup\scripts\ebcli_installer.py
```
1. Verifique se a EB CLI está instalada corretamente.
```
$ eb --version
EB CLI 3.21.0 (Python 3.12)
```
Para obter instruções completas de instalação, consulte o [https://github.com/aws/aws-elastic-beanstalk-cli-setup](https://github.com/aws/aws-elastic-beanstalk-cli-setup)repositório em. GitHub
## Instalar a CLI do EB manualmente
Você pode instalar a EB CLI no Linux, macOS e Windows com o gerenciador de pacotes `pip` para Python, que fornece instalação, atualização e remoção de pacotes Python e suas dependências.
**Recomendamos o script instalador**
Recomendamos o uso de [Instalar a EB CLI](#eb-cli3-install) para configurar a EB CLI e evitar conflitos de dependências.
**Pré-requisito**: é necessário ter uma versão compatível do Python instalada. Você pode baixá-la na página de [downloads do Python](https://www.python.org/downloads/) no site do Python.
**Para instalar a EB CLI (manualmente)**
1. Execute o comando a seguir.
```
$ pip install awsebcli --upgrade --user
```
A opção `--upgrade` informa ao `pip` para atualizar os requisitos que já estão instalados. A opção `--user` informa ao `pip` para instalar o programa em um subdiretório do diretório de usuário para evitar a modificação de bibliotecas usadas pelo seu sistema operacional.
**Solução de problemas**
Caso haja problemas ao tentar instalar a CLI do EB com o `pip`, você poderá [instalar a CLI do EB em um ambiente virtual](#eb-cli3-install-virtualenv) para isolar a ferramenta e suas dependências, ou usar uma versão do Python diferente da que você normalmente usa.
1. Adicione o caminho para o arquivo executável da sua variável `PATH`:
+ No Linux e macOS:
**Linux**: `~/.local/bin`
**macOS**: `~/Library/Python/3.12/bin`
Para modificar a variável `PATH` (Linux, Unix ou macOS):
1. Encontre o script de perfil do shell em sua pasta de usuário. Se você não tiver certeza de qual shell você tem, execute `echo $SHELL`.
```
$ ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
```
+ **Bash**: `.bash_profile`, `.profile` ou `.bash_login`.
+ **Zsh**: `.zshrc`
+ **Tcsh**: `.tcshrc`, `.cshrc` ou `.login`.
1. Adicione um comando de exportação ao script de perfil. O exemplo a seguir adiciona o caminho representado por *LOCAL\$1PATH* à `PATH` variável atual.
```
export PATH=LOCAL_PATH:$PATH
```
1. Carregue o script de perfil descrito na primeira etapa para a sessão atual. O exemplo a seguir carrega o script de perfil representado por*PROFILE\$1SCRIPT*.
```
$ source ~/PROFILE_SCRIPT
```
+ No Windows:
**Python 3.12** — `%USERPROFILE%\AppData\Roaming\Python\Python312\Scripts`
**Versões anteriores do Python**: `%USERPROFILE%\AppData\Roaming\Python\Scripts`
Para modificar a variável `PATH` (Windows):
1. Pressione a tecla Windows e insira **environment variables**.
1. Escolha **Edit environment variables for your account**.
1. Selecione **PATH** e, em seguida, **Edit** (Editar).
1. Adicione caminhos ao campo **Variable value**, separados por ponto e vírgula. Por exemplo: `C:\item1\path;C:\item2\path`
1. Selecione **OK** duas vezes para aplicar as novas configurações.
1. Feche todas as janelas do prompt de comando em execução e abra novamente uma janela do prompt de comando.
1. Verifique se a EB CLI foi instalada corretamente executando **eb --version**.
```
$ eb --version
EB CLI 3.21.0 (Python 3.12)
```
A CLI do EB é atualizada regularmente para adicionar as funcionalidades compatíveis com [os recursos mais recentes do Elastic Beanstalk](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/). Para atualizar para a versão mais recente da EB CLI, execute o comando de instalação novamente.
```
$ pip install awsebcli --upgrade --user
```
Se você precisar desinstalar a EB CLI, use `pip uninstall`.
```
$ pip uninstall awsebcli
```
## Instalar a EB CLI em um ambiente virtual
Você pode evitar conflitos de requisitos de versão com outros pacotes `pip` instalando a EB CLI em um ambiente virtual.
**Para instalar a EB CLI em um ambiente virtual**
1. Primeiro, instale `virtualenv` com `pip`.
```
$ pip install --user virtualenv
```
1. Crie um ambiente virtual.
```
$ virtualenv ~/eb-ve
```
Para usar um executável Python diferente da padrão, use a opção `-p`.
```
$ virtualenv -p /usr/bin/python3.12 ~/eb-ve
```
1. Ative o ambiente virtual.
**Linux, Unix ou macOS**
```
$ source ~/eb-ve/bin/activate
```
**Windows**
```
$ %USERPROFILE%\eb-ve\Scripts\activate
```
1. Instale a EB CLI.
```
(eb-ve)$ pip install awsebcli --upgrade
```
1. Verifique se a EB CLI está instalada corretamente.
```
$ eb --version
EB CLI 3.23.0 (Python 3.12)
```
Use o comando `deactivate` para sair do ambiente virtual. Sempre que iniciar uma nova sessão, execute o comando de ativação novamente.
Para atualizar para a versão mais recente, execute o comando de instalação novamente.
```
(eb-ve)$ pip install awsebcli --upgrade
```
## Instalar a EB CLI com o homebrew
A versão mais recente da CLI do EB geralmente fica disponível no `Homebrew` alguns dias depois de aparecer no `pip`.
**Recomendamos o script instalador**
Recomendamos o uso de [Instalar a EB CLI](#eb-cli3-install) para configurar a EB CLI e evitar conflitos de dependências.
**Para instalar a CLI do EB com o `Homebrew`**
1. Verifique se você tem a versão mais recente do `Homebrew`.
```
$ brew update
```
1. Executar `brew install awsebcli`.
```
$ brew install awsebcli
```
1. Verifique se a EB CLI está instalada corretamente.
```
$ eb --version
EB CLI 3.21.0 (Python 3.12)
```