本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 设置 EB 命令行界面（EB CLI）来管理 Elastic Beanstalk
<a name="eb-cli3"></a>

EB CLI 是一个命令行界面，它提供用于在其中创建、更新和监控环境的交互式命令 Amazon Elastic Beanstalk。EB CLI 开源项目位于 Github 上：`[aws/aws-elastic-beanstalk-cli](https://github.com/aws/aws-elastic-beanstalk-cli)`

在安装 EB CLI 并配置项目目录后，您可以使用单个命令创建环境：

```
$ eb create my-beanstalk-environment
```

建议使用设置脚本进行安装，详情请参阅[使用设置脚本安装 EB CLI（推荐）](#eb-cli3-install)。

 Amazon CLI 提供对低级 Elastic Beanstal APIs k 的直接访问。尽管功能强大，但它也很冗长，相比之下更推荐使用 EB CLI。例如，使用创建环境 Amazon CLI 需要以下一系列命令：

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

## 使用设置脚本安装 EB CLI（推荐）
<a name="eb-cli3-install"></a>

**建议使用安装程序脚本**  
建议使用安装程序脚本来设置 EB CLI 及其依赖项，以防止与其他 Python 程序包发生潜在冲突。

先决条件：Git、Python 和 [virtualenv](https://virtualenv.pypa.io/en/latest/installation.html)

**下载和使用安装程序脚本**

1. 克隆存储库。

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

1. 安装或升级 EB CLI。

   **macOS/Linux**：在 Bash 或 Zsh 中

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

    PowerShell 或命令@@ **窗口**中的窗口

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

1. 验证 EB CLI 是否已正确安装。

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

有关完整的安装说明，请参阅上的[https://github.com/aws/aws-elastic-beanstalk-cli-setup](https://github.com/aws/aws-elastic-beanstalk-cli-setup)存储库 GitHub。

## 手动安装 EB CLI
<a name="eb-cli3-install-advanced"></a>

您可以使用适用于 Python 的 `pip` 程序包管理器在 Linux、macOS 和 Windows 上安装 EB CLI，该程序包管理器可以安装、升级和删除 Python 程序包及其依赖项。

**建议使用安装程序脚本**  
建议使用 [安装 EB CLI](#eb-cli3-install) 来设置 EB CLI 以防止依赖项冲突。

**先决条件**：必须安装支持的 Python 版本。您可以从 Python 网站上的 [Python 下载](https://www.python.org/downloads/)页面进行下载。

**安装 EB CLI（手动）**

1. 运行如下命令。

   ```
   $ pip install awsebcli --upgrade --user
   ```

   `--upgrade` 选项通知 `pip` 升级已安装的任何必要组件。`--user` 选项通知 `pip` 将程序安装到用户目录的子目录中，以避免修改您的操作系统所使用的库。
**排查问题**  
如果您尝试随 `pip` 一起安装 EB CLI 时遇到问题，可以[在虚拟环境中安装 EB CLI](#eb-cli3-install-virtualenv) 来隔离工具及其依赖对象；或者使用与平时使用的 Python 不同的版本。

1. 将可执行文件的路径添加到您的 `PATH` 变量中：
   + 在 Linux 和 macOS 上：

     **Linux** – `~/.local/bin`

     **macOS** – `~/Library/Python/3.12/bin`

     要修改您的 `PATH` 变量（Linux、Unix 或 macOS），请执行以下操作：

     1. 在您的用户文件夹中查找 Shell 的配置文件脚本。如果您不能确定所使用的 Shell，请运行 `echo $SHELL`。

        ```
        $ ls -a ~
        .  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads
        ```
        + **Bash** – `.bash_profile`、`.profile` 或 `.bash_login`。
        + **Zsh** – `.zshrc`
        + **Tcsh** – `.tcshrc`、`.cshrc` 或 `.login`。

     1. 向配置文件脚本中添加导出命令。以下示例将由表示的路径*LOCAL\$1PATH*添加到当前`PATH`变量。

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

     1. 将在第一步中描述的配置脚本文件加载到当前会话中。以下示例加载了由表示的配置文件脚本*PROFILE\$1SCRIPT*。

        ```
        $ source ~/PROFILE_SCRIPT
        ```
   + 在 Windows 上：

     **Python 3.12**：`%USERPROFILE%\AppData\Roaming\Python\Python312\Scripts`

     **Python 早期版本** – `%USERPROFILE%\AppData\Roaming\Python\Scripts`

     要修改您的 `PATH` 变量 (Windows)，请执行以下操作：

     1. 按下 Windows 键，然后键入 **environment variables**。

     1. 选择 **Edit environment variables for your account**（编辑您账户的环境变量）。

     1. 选择 **PATH**，然后选择 **Edit**（编辑）。

     1. 向 **Variable value** 字段添加路径，中间用分号隔开。例如：`C:\item1\path;C:\item2\path`

     1. 选择 **OK** 两次以应用新设置。

     1. 关闭任何正在运行的命令提示符窗口，然后重新打开命令提示符窗口。

1. 通过运行 **eb --version** 来验证 EB CLI 是否已正确安装。

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

EB CLI 会定期更新以增加支持[最新 Elastic Beanstalk 特性](https://docs.amazonaws.cn/elasticbeanstalk/latest/relnotes/)的功能。要更新到最新版本的 EB CLI，请再次运行安装命令。

```
$ pip install awsebcli --upgrade --user
```

如果需要卸载 EB CLI，请使用 `pip uninstall`。

```
$ pip uninstall awsebcli
```

## 在虚拟环境中安装 EB CLI
<a name="eb-cli3-install-virtualenv"></a>

您可以通过在虚拟环境中安装 EB CLI 来避免所需版本与其他 `pip` 程序包发生冲突。

**在虚拟环境中安装 EB CLI**

1. 首先，使用 `pip` 安装 `virtualenv`。

   ```
   $ pip install --user virtualenv
   ```

1. 创建虚拟环境。

   ```
   $ virtualenv ~/eb-ve
   ```

   要使用默认可执行文件之外的其他 Python 可执行文件，请使用 `-p` 选项。

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

1. 激活虚拟环境。

   **Linux、Unix 或 macOS**

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

   **Windows**

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

1. 安装 EB CLI。

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

1. 验证 EB CLI 是否已正确安装。

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

您可以使用 `deactivate` 命令退出虚拟环境。只要启动了新的会话，请重新运行激活命令。

要升级到最新版本，请重新运行安装命令。

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

## 使用 Homebrew 安装 EB CLI
<a name="eb-cli3-install-osx-homebrew"></a>

当 `pip` 中显示了最新版本的 EB CLI 时，通常数日之后即在 `Homebrew` 中可用。

**建议使用安装程序脚本**  
建议使用 [安装 EB CLI](#eb-cli3-install) 来设置 EB CLI 以防止依赖项冲突。

**使用 `Homebrew` 安装 EB CLI**

1. 确保您有最新版本的 `Homebrew`。

   ```
   $ brew update
   ```

1. 运行 `brew install awsebcli`。

   ```
   $ brew install awsebcli
   ```

1. 验证 EB CLI 是否已正确安装。

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