Configuración de la interfaz de la línea de comandos de EB (CLI de EB) para administrar Elastic Beanstalk - AWS Elastic Beanstalk
Instalación de la CLI de EBInstalación manualInstalación en virtualenvInstalación de la CLI de EB con Homebrew

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración de la interfaz de la línea de comandos de EB (CLI de EB) para administrar Elastic Beanstalk

La CLI de EB es una interfaz de la línea de comandos que proporciona comandos interactivos para crear, actualizar y monitorear entornos en AWS Elastic Beanstalk. El proyecto de código abierto de la CLI de EB está en Github: aws/aws-elastic-beanstalk-cli.

Después de instalar la CLI de EB y configurar un directorio de proyecto, puede crear entornos con un solo comando:

$ eb create my-beanstalk-environment

Recomendamos instalarlo con el script de configuración; aprenda cómo hacerlo en Instalación de la CLI de EB con el script de configuración (recomendado).

La AWS CLI proporciona acceso directo a las API de Elastic Beanstalk de bajo nivel. Aunque es potente, también es detallado y se prefiere menos que la CLI de EB. Por ejemplo, para crear un entorno con la AWS CLI, se necesita la siguiente serie 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"

Instalación de la CLI de EB con el script de configuración (recomendado)

Recomendamos el script de instalación.

Recomendamos utilizar el scripts de instalación para configurar la CLI de EB y sus dependencias y evitar posibles conflictos con otros paquetes de Python.

Requisitos previos: Git, Python y virtualenv

Cómo descargar y utilizar el script de instalación

  1. Clonar el repositorio.

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

  2. Instale o actualice la CLI de EB.

    macOS/Linux en Bash o Zsh

    python ./aws-elastic-beanstalk-cli-setup/scripts/ebcli_installer.py

    Windows en PowerShell o ventana de comandos

    python .\aws-elastic-beanstalk-cli-setup\scripts\ebcli_installer.py

  3. Compruebe que la CLI de EB esté instalada correctamente.

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

Para obtener todos los pasos de instalación, consulte el repositorio de aws/aws-elastic-beanstalk-cli-setup en GitHub.

Instalación manual de la CLI de EB

Puede instalar la CLI de EB en Linux, macOS y Windows con el administrador de paquetes de pip para Python, que proporciona la instalación, actualización y eliminación de los paquetes de Python y sus dependencias.

Recomendamos el script de instalación.

Recomendamos utilizar la Instalación de la CLI de EB para configurar la CLI de EB y evitar conflictos de dependencias.

Requisito previo: debe tener instalada una versión compatible de Python. Puede descargarla desde la página de descargas de Python en el sitio web de Python.

Cómo instalar la CLI de EB (de forma manual)

  1. Ejecute el siguiente comando.

    $ pip install awsebcli --upgrade --user

    La opción --upgrade indica a pip que actualice los requisitos ya instalados. La opción --user indica a pip que instale el programa en un subdirectorio de su directorio de usuarios para no modificar las bibliotecas que usa su sistema operativo.

    Solución de problemas de incidencias

    Si tiene problemas al intentar instalar la CLI de EB con pip, puede instalar la CLI de EB en un entorno virtual para aislar la herramienta y sus dependencias, o utilizar una versión de Python diferente de la que usa habitualmente.

  2. Añada la ruta al archivo ejecutable a su variable PATH:

    • En Linux y macOS:

      Linux – ~/.local/bin

      macOS – ~/Library/Python/3.12/bin

      Para modificar la variable PATH (Linux, Unix o macOS):

      1. Busque el script de perfil de su shell en su carpeta de usuario. Si no está seguro de cuál es el shell que tiene, ejecute echo $SHELL.

        $ ls -a ~
.  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads

        • Bash: .bash_profile, .profile o .bash_login.

        • Zsh – .zshrc

        • Tcsh: .tcshrc, .cshrc o .login.

      2. Añada un comando de exportación al script de su perfil. El siguiente ejemplo añade la ruta representada por LOCAL_PATH a la variable PATH actual.

        export PATH=LOCAL_PATH:$PATH

      3. Cargue el script del perfil descrito en el primer paso en la sesión actual. El siguiente ejemplo carga el script del perfil representado por PROFILE_SCRIPT. 

        $ source ~/PROFILE_SCRIPT

    • En Windows:

      Python 3.12 – %USERPROFILE%\AppData\Roaming\Python\Python312\Scripts

      Versiones anteriores de Python – %USERPROFILE%\AppData\Roaming\Python\Scripts

      Para modificar la variable PATH (Windows):

      1. Pulse la tecla de Windows y, a continuación, escriba environment variables.

      2. Elija Edit environment variables for your account (Edición de las variables de entorno de esta cuenta).

      3. Elija PATH y, a continuación, Edit (Edición de).

      4. Añada rutas al campo Variable value (Valor de la variable), separadas por punto y coma. Por ejemplo: C:\item1\path;C:\item2\path

      5. Elija OK (Aceptar) dos veces para aplicar la nueva configuración.

      6. Cierre las ventanas del símbolo del sistema en ejecución y, a continuación, vuelva a abrir una ventana del símbolo del sistema.

  3. Compruebe que la CLI de EB se ha instalado correctamente ejecutando eb --version.

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

La CLI de EB se actualiza periódicamente para añadir funciones que admitan las últimas características de Elastic Beanstalk. Para actualizar a la última versión de la CLI de EB, ejecute el comando de instalación de nuevo.

$ pip install awsebcli --upgrade --user

Si necesita desinstalar la CLI de EB, utilice pip uninstall.

$ pip uninstall awsebcli

Instalación de la CLI de EB en un entorno virtual

Puede evitar conflictos de versiones con otros paquetes pip instalando la CLI de EB en un entorno virtual.

Para instalar la CLI de EB en un entorno virtual

  1. Primero, instale virtualenv con pip.

    $ pip install --user virtualenv

  2. Cree un entorno virtual.

    $ virtualenv ~/eb-ve

    Para utilizar un Python ejecutable diferente al predeterminado, utilice la opción -p. 

    $ virtualenv -p /usr/bin/python3.12 ~/eb-ve

  3. Active el entorno virtual.

    Linux, Unix o macOS

    $ source ~/eb-ve/bin/activate

    Windows

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

  4. Instale la CLI de EB.

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

  5. Compruebe que la CLI de EB esté instalada correctamente.

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

Puedes utilizar el comando deactivate para salir del entorno virtual. Siempre que inicie una nueva sesión, vuelva a ejecutar el comando de activación.

Para actualizar a la versión más reciente, ejecute el comando de instalación de nuevo.

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

Instalación de la CLI de EB con Homebrew

La última versión de la CLI de EB suele estar disponible en Homebrew un par de días después de que aparezca en pip.

Recomendamos el script de instalación.

Recomendamos utilizar la Instalación de la CLI de EB para configurar la CLI de EB y evitar conflictos de dependencias.

Para instalar la CLI de EB con Homebrew

  1. Asegúrese de que tiene la última versión de Homebrew.

    $ brew update

  2. Ejecuta brew install awsebcli.

    $ brew install awsebcli

  3. Compruebe que la CLI de EB esté instalada correctamente.

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