设置 EB 命令行界面（EB CLI）来管理 Elastic Beanstalk - AWS Elastic Beanstalk
安装 EB CLI手动安装。在 virtualenv 中安装使用 Homebrew 安装 EB CLI

设置 EB 命令行界面（EB CLI）来管理 Elastic Beanstalk

EB CLI 是命令行界面，提供可在 AWS Elastic Beanstalk 中创建、更新和监控环境的交互式命令。EB CLI 开源项目位于 Github 上：aws/aws-elastic-beanstalk-cli

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

$ eb create my-beanstalk-environment

建议使用设置脚本进行安装，详情请参阅使用设置脚本安装 EB CLI（推荐）。

AWS CLI 提供对低级别 Elastic Beanstalk API 的直接访问。尽管功能强大，但它也很冗长，相比之下更推荐使用 EB CLI。例如，使用 AWS 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（推荐）

建议使用安装程序脚本

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

先决条件：Git、Python 和 virtualenv

下载和使用安装程序脚本

  1. 克隆存储库。

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

  2. 安装或升级 EB CLI。

    macOS/Linux：在 Bash 或 Zsh 中

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

    Windows：在 PowerShell 或命令窗口中

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

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

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

有关完整安装说明，请参阅 GitHub 上的 aws/aws-elastic-beanstalk-cli-setup 存储库。

手动安装 EB CLI

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

建议使用安装程序脚本

建议使用 安装 EB CLI 来设置 EB CLI 以防止依赖项冲突。

先决条件：必须安装支持的 Python 版本。您可以从 Python 网站上的 Python 下载页面进行下载。

安装 EB CLI（手动）

  1. 运行以下命令。

    $ pip install awsebcli --upgrade --user

    --upgrade 选项通知 pip 升级已安装的任何必要组件。--user 选项通知 pip 将程序安装到用户目录的子目录中，以避免修改您的操作系统所使用的库。

    排查问题

    如果您尝试随 pip 一起安装 EB CLI 时遇到问题，可以在虚拟环境中安装 EB CLI 来隔离工具及其依赖对象；或者使用与平时使用的 Python 不同的版本。

  2. 将可执行文件的路径添加到您的 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。

      2. 向配置文件脚本中添加导出命令。以下示例向当前 PATH 变量中添加 LOCAL_PATH 所表示的路径。

        export PATH=LOCAL_PATH:$PATH

      3. 将在第一步中描述的配置脚本文件加载到当前会话中。以下示例加载 PROFILE_SCRIPT 所表示的配置文件脚本。

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

      2. 选择 Edit environment variables for your account。

      3. 选择 PATH，然后选择编辑。

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

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

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

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

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

EB CLI 会定期更新以增加支持最新 Elastic Beanstalk 特性的功能。要更新到最新版本的 EB CLI，请再次运行安装命令。

$ pip install awsebcli --upgrade --user

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

$ pip uninstall awsebcli

在虚拟环境中安装 EB CLI

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

在虚拟环境中安装 EB CLI

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

    $ pip install --user virtualenv

  2. 创建虚拟环境。

    $ virtualenv ~/eb-ve

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

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

  3. 激活虚拟环境。

    Linux、Unix 或 macOS

    $ source ~/eb-ve/bin/activate

    （Windows）：

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

  4. 安装 EB CLI。

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

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

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

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

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

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

使用 Homebrew 安装 EB CLI

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

建议使用安装程序脚本

建议使用 安装 EB CLI 来设置 EB CLI 以防止依赖项冲突。

使用 Homebrew 安装 EB CLI

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

    $ brew update

  2. 运行 brew install awsebcli。

    $ brew install awsebcli

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

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