Configuração da interface de linha de comando do EB (EB CLI) para gerenciar o Elastic Beanstalk - AWS Elastic Beanstalk
Instale o EB CLIInstalação manualInstale no virtualenvInstalar a EB CLI com o homebrew

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

Configuração da interface de linha de comando do 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

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 comoInstale o EB CLI com script de configuração (recomendado).

O AWS CLI fornece acesso direto ao Elastic APIs Beanstalk de baixo nível. Embora poderoso, ele também é detalhado e menos preferido em relação ao 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"

Instale o EB CLI com script de configuração (recomendado)

Recomendamos o script do instalador

Recomendamos usar o script do instalador para configurar a CLI do EB e suas dependências e evitar possíveis conflitos com outros pacotes Python.

Pré-requisitos: Git, Python e virtualenv

Para baixar e usar o script do instalador

  1. Clonar o repositório.

    git clone https://github.com/aws/aws-elastic-beanstalk-cli-setup.git

  2. Instale ou atualize o 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

  3. 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 aws/aws-elastic-beanstalk-cli-setuprepositório em. GitHub

Instalar a CLI do EB manualmente

Você pode instalar a CLI do EB no Linux, macOS e Windows com o pip gerenciador de pacotes para Python, que fornece instalação, atualização e remoção de pacotes Python e suas dependências.

Recomendamos o script do instalador

Recomendamos usar o Instale o EB CLI para configurar a CLI do EB e evitar conflitos de dependência.

Pré-requisito - Você deve ter uma versão compatível do Python instalada. Você pode baixá-lo na página de downloads do Python no site do Python.

Para instalar o EB CLI (manualmente)

  1. Execute o seguinte comando:

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

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

        export PATH=LOCAL_PATH:$PATH

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

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

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

    $ pip install --user virtualenv

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

  3. Ative o ambiente virtual.

    Linux, Unix ou macOS

    $ source ~/eb-ve/bin/activate

    Windows

    $ %USERPROFILE%\eb-ve\Scripts\activate

  4. Instale a EB CLI.

    (eb-ve)$ pip install awsebcli --upgrade

  5. 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 do instalador

Recomendamos usar o Instale o EB CLI para configurar a CLI do EB e evitar conflitos de dependência.

Para instalar a CLI do EB com o Homebrew

  1. Verifique se você tem a versão mais recente do Homebrew.

    $ brew update

  2. Executar brew install awsebcli.

    $ brew install awsebcli

  3. Verifique se a EB CLI está instalada corretamente.

    $ eb --version
EB CLI 3.21.0 (Python 3.12)