设置 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 Beanstal APIs k 的直接访问。尽管功能强大，但它也很冗长，不如 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。

    bash 或 Zsh 中的 macOS/Linux

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

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

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

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

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

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

手动安装 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. 向配置文件脚本中添加导出命令。以下示例将表示的LOCAL_PATH路径添加到当前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，然后选择 Edit（编辑）。

      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. 首先，virtualenv使用安装pip。

    $ 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

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

我们推荐使用安装程序脚本

我们建议使用安装 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)