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
<a name="eb-cli3"></a>

La CLI de EB es una interfaz de línea de comandos que proporciona comandos interactivos para crear, actualizar y supervisar entornos en ellos AWS Elastic Beanstalk. El proyecto de código abierto de la CLI de EB está en Github: `[aws/aws-elastic-beanstalk-cli](https://github.com/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)](#eb-cli3-install).

 AWS CLI Proporciona acceso directo a Elastic APIs Beanstalk de bajo nivel. Aunque es potente, también es detallado y se prefiere menos que la CLI de EB. Por ejemplo, la creación de un entorno con el AWS CLI requiere 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)
<a name="eb-cli3-install"></a>

**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](https://virtualenv.pypa.io/en/latest/installation.html)

**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
   ```

1. 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 en la ventana de comandos

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

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

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

Para obtener instrucciones de instalación completas, consulte el [https://github.com/aws/aws-elastic-beanstalk-cli-setup](https://github.com/aws/aws-elastic-beanstalk-cli-setup)repositorio en GitHub.

## Instalación manual de la CLI de EB
<a name="eb-cli3-install-advanced"></a>

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](#eb-cli3-install) 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](https://www.python.org/downloads/) en el sitio web de Python.

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

1. Ejecute el comando siguiente.

   ```
   $ 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](#eb-cli3-install-virtualenv) para aislar la herramienta y sus dependencias, o utilizar una versión de Python diferente de la que usa habitualmente.

1. 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`.

     1. Añada un comando de exportación al script de su perfil. El siguiente ejemplo agrega la ruta representada por *LOCAL\$1PATH* a la `PATH` variable actual.

        ```
        export PATH=LOCAL_PATH:$PATH
        ```

     1. Cargue el script del perfil descrito en el primer paso en la sesión actual. El siguiente ejemplo carga el script de perfil representado por*PROFILE\$1SCRIPT*. 

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

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

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

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

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

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

1. 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](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/). 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
<a name="eb-cli3-install-virtualenv"></a>

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
   ```

1. 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
   ```

1. Active el entorno virtual.

   **Linux, Unix o macOS**

   ```
   $ source ~/eb-ve/bin/activate
   ```

   **Windows**

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

1. Instale la CLI de EB.

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

1. 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
<a name="eb-cli3-install-osx-homebrew"></a>

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](#eb-cli3-install) 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
   ```

1. Ejecute `brew install awsebcli`.

   ```
   $ brew install awsebcli
   ```

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

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