Instalar a CLI do EB manualmente

Para instalar a CLI do EB, recomendamos o uso dos scripts de configuração da CLI do EB. Se os scripts de configuração não forem compatíveis com o ambiente de desenvolvimento, instale manualmente a CLI do EB.

O método de distribuição principal da CLI do EB no Linux, macOS e Windows é o pip. Esse é um gerenciador de pacote para o Python que fornece uma maneira fácil de instalar, atualizar e remover pacotes Python e suas dependências. Para o macOS, você também pode obter a versão mais recente da CLI do EB com Homebrew.

Observações sobre compatibilidade

A CLI do EB foi desenvolvida em Python e requer o Python versão 3.11 ou posterior.

Recomendamos o uso dos scripts de configuração da CLI do EB para instalar a CLI do EB e suas dependências. Se você instalar manualmente a CLI do EB, pode ser difícil gerenciar conflitos de dependência em seu ambiente de desenvolvimento.

A EB CLI e a AWS Command Line Interface (AWS CLI) compartilham uma dependência no pacote botocore Python. Devido a uma alteração no botocore, diferentes versões dessas duas ferramentas da CLI dependem de versões diferentes de botocore.

As versões mais recentes das duas CLIs são compatíveis. Se você precisar usar uma versão anterior, consulte a tabela a seguir para verificar uma versão compatível a ser usada.

Versão da CLI do EB	Versão compatível da AWS CLI
3.14.5 ou anterior	1.16.9 ou anterior
3.14.6 ou posterior	1.16.11 ou posterior

Instalar a EB CLI

Se você já tem pip e uma versão compatível do Python, use o seguinte procedimento para instalar o EB CLI:

Se você não tem Python nem pip, use o procedimento para o sistema operacional que está utilizando.

• Instalar Python, pip e EB CLI no Linux

• Instalar a EB CLI no macOS

• Instalar Python, pip e EB CLI no Windows

Para instalar o EB CLI

1. Execute o comando a seguir da .

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

   nota

   Caso haja problemas ao tentar instalar a CLI do EB com o pip, você poderá instalar a CLI do EB em um ambiente virtual para isolar a ferramenta e suas dependências, ou usar uma versão do Python diferente da que você normalmente usa.

2. Adicione o caminho para o arquivo executável da sua variável PATH:

   • No Linux e macOS:

     Linux: ~/.local/bin

     macOS: ~/Library/Python/3.7/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.

     2. Adicione um comando de exportação ao script de perfil. O seguinte exemplo adiciona o caminho representado por LOCAL_PATH à variável PATH atual.

        export PATH=LOCAL_PATH:$PATH

     3. Carregue o script de perfil descrito na primeira etapa para a sessão atual. O seguinte exemplo carrega o script de perfil representado por PROFILE_SCRIPT.

        $ source ~/PROFILE_SCRIPT

   • No Windows:

     Python 3.7: %USERPROFILE%\AppData\Roaming\Python\Python37\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.

     2. Escolha Edit environment variables for your account.

     3. Selecione PATH e, em seguida, Edit (Editar).

     4. Adicione caminhos ao campo Variable value, separados por ponto e vírgula. Por exemplo: C:\item1\path;C:\item2\path

     5. Selecione OK duas vezes para aplicar as novas configurações.

     6. Feche todas as janelas do prompt de comando em execução e abra novamente uma janela do prompt de comando.

3. Verifique se a EB CLI foi instalada corretamente executando eb --version.

   $ eb --version
   EB CLI 3.14.8 (Python 3.7)

A CLI do EB é atualizada regularmente para adicionar as funcionalidades compatíveis com os recursos mais recentes do Elastic Beanstalk. 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