设置 EB 命令行界面（EB CLI）来管理 Elastic Beanstalk - Amazon Elastic Beanstalk
安装 EB CLI手动安装。在 virtualenv 中安装使用 Homebrew 安装 EB CLI
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

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

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

$ eb create my-beanstalk-environment

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

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

建议使用安装程序脚本

建议使用安装程序脚本来设置 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)