設定 EB 命令列界面 (EB CLI) 以管理 Elastic Beanstalk - AWS Elastic Beanstalk

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

設定 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 APIs。雖然功能強大,但它也很普遍,比 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 或 Command 視窗中的 Windows

    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 套件管理員在 Linux、macOS 和 Windows 上安裝 EB CLI,該pip套件管理員提供 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. 將路徑新增到變數值欄位中,以分號分隔。例如: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 命令來離開虛擬環境。無論您何時開始新的工作階段,請重新執行啟用命令。

更新到最新版本的&CLI,再次執行安裝命令。

(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)