手動安裝 EB CLI

若要安裝 EB CLI，建議您使用 EB CLI 設定指令碼。如果設定指令碼與您的開發環境不相容，請手動安裝 EB CLI。

EB CLI 在 Linux、macOS 和 Windows 的主要分發方式是 pip。這是 Python 適用的套件管理工具，其提供一個簡單的方法來安裝、升級和移除 Python 套件及其相依性。以 macOS 而言，您亦可使用 Homebrew 取得最新版本的 EB CLI。

相容性備註

EB CLI 以 Python 開發，需要 Python 版本 3.11 或更新版本。

建議您使用 EB CLI 設定指令碼 來安裝 EB CLI 及其相依性。如果您手動安裝 EB CLI，可能難以在您的開發環境中管理相依性衝突。

EB CLI 和 AWS Command Line Interface (AWS CLI) 在 botocore Python 套件上共享相依性。由於 botocore 不同版本的重大變更，這兩個 CLI 工具取決於不同版本的 botocore。

最新版本的兩個 CLI 可相容。如果您需要使用舊版，請參閱下表以取得要使用的相容版本。

EB CLI 版本	相容 AWS CLI 版本
3.14.5 或舊版本	1.16.9 或舊版本
3.14.6 或更新版本	1.16.11 或更新版本

安裝 EB CLI

如果您已經有 pip 和支援的 Python 版本，則可使用下列程序來安裝 EB CLI。

如果您沒有 Python 和 pip，請使用您使用的作業系統的程序。

• 在 Linux 上安裝 Python、pip 和 EB CLI

• 在 macOS 上安裝 EB CLI

• 在 Windows 上安裝 Python、pip 和 EB CLI

欲安裝 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.7/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.7 – %USERPROFILE%\AppData\Roaming\Python\Python37\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.14.8 (Python 3.7)

EB CLI 會定期更新，新增支援最新 Elastic Beanstalk 功能的功能。要更新到最新版本的 EB CLI，再次執行安裝命令。

$ pip install awsebcli --upgrade --user

如果您需要解除安裝 EB CLI，請使用 pip uninstall。

$ pip uninstall awsebcli