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

# 設定 EB 命令列界面 (EB CLI) 以管理 Elastic Beanstalk
<a name="eb-cli3"></a>

EB CLI 是一種命令列界面，提供互動式命令，可在其中建立、更新和監控環境 AWS Elastic Beanstalk。EB CLI 開放原始碼專案位於 Github： `[aws/aws-elastic-beanstalk-cli](https://github.com/aws/aws-elastic-beanstalk-cli)`

安裝 EB CLI 並設定專案目錄後，即可使用單一命令建立環境：

```
$ eb create my-beanstalk-environment
```

建議您使用設定指令碼安裝 ，了解如何在 中安裝 [使用設定指令碼安裝 EB CLI （建議）](#eb-cli3-install)。

 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 （建議）
<a name="eb-cli3-install"></a>

**我們建議您使用安裝程式指令碼**  
建議使用安裝程式指令碼來設定 EB CLI 及其相依性，並防止與其他 Python 套件發生潛在衝突。

先決條件：Git、Python 和 [virtualenv](https://virtualenv.pypa.io/en/latest/installation.html)

**下載並使用安裝程式指令碼**

1. 複製儲存庫。

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

1. 安裝或升級 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
   ```

1. 確認已正確安裝 EB CLI。

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

如需完整的安裝說明，請參閱 GitHub 上的儲存[https://github.com/aws/aws-elastic-beanstalk-cli-setup](https://github.com/aws/aws-elastic-beanstalk-cli-setup)庫。

## 手動安裝 EB CLI
<a name="eb-cli3-install-advanced"></a>

您可以使用 Python 套件管理員在 Linux、macOS 和 Windows 上安裝 EB CLI，該`pip`套件管理員提供 Python 套件及其相依性的安裝、升級和移除。

**我們建議您使用安裝程式指令碼**  
建議使用 [安裝 EB CLI](#eb-cli3-install)來設定 EB CLI，並防止相依性衝突。

**先決條件** - 您必須安裝支援的 Python 版本。您可以從 [Python 網站上的 Python 下載頁面進行下載](https://www.python.org/downloads/)。

**安裝 EB CLI （手動）**

1. 執行下列命令。

   ```
   $ pip install awsebcli --upgrade --user
   ```

   此 `--upgrade` 選項通知 `pip` 升級已安裝的任何要求。此 `--user` 選項通知 `pip` 將程式安裝到使用者目錄的子目錄中，以避免修改作業系統使用的程式庫。
**疑難排解 問題**  
如果透過 `pip` 嘗試安裝 EB CLI 時遇到問題，可以[在虛擬環境中安裝 EB CLI](#eb-cli3-install-virtualenv)，藉此隔離該工具及其依存項目，或者使用平常不使用的 Python 版本。

1. 新增可執行檔路徑到您的 `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`。

     1. 將匯出命令新增至您的描述檔指令碼。下列範例會將由 *LOCAL\$1PATH* 代表的路徑新增至目前的 `PATH` 變數。

        ```
        export PATH=LOCAL_PATH:$PATH
        ```

     1. 將第一個步驟所述的描述檔指令碼載入您目前的工作階段。下列範例會載入由 *PROFILE\$1SCRIPT* 代表的描述檔指令碼。

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

     1. 選擇 **Edit environment variables for your account (編輯您帳戶的環境變數)**。

     1. 選擇 **PATH**，然後選擇 **Edit (編輯)**。

     1. 將路徑新增到**變數值**欄位中，以分號分隔。例如：`C:\item1\path;C:\item2\path`

     1. 選擇 **OK** (確定) 兩次以套用新的設定。

     1. 關閉任何正在執行的命令提示字元視窗，然後重新開啟命令提示字元視窗。

1. 執行 **eb --version** 來驗證 EB CLI 是否正確安裝。

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

EB CLI 會定期更新，新增支援[最新 Elastic Beanstalk 功能](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/)的功能。要更新到最新版本的 EB CLI，再次執行安裝命令。

```
$ pip install awsebcli --upgrade --user
```

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

```
$ pip uninstall awsebcli
```

## 在虛擬環境中安裝 EB CLI
<a name="eb-cli3-install-virtualenv"></a>

您可以透過在虛擬環境中安裝 EB CLI，避免所需版本與其他 `pip` 套件發生衝突。

**欲在虛擬環境中安裝 EB CLI**

1. 首先，`virtualenv`使用 安裝 `pip`。

   ```
   $ pip install --user virtualenv
   ```

1. 建立虛擬環境。

   ```
   $ virtualenv ~/eb-ve
   ```

   若要使用預設以外的 Python 可執行檔，請使用 `-p` 選項。

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

1. 啟用虛擬環境。

   **Linux、Unix 或 macOS**

   ```
   $ source ~/eb-ve/bin/activate
   ```

   **Windows**

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

1. 安裝 EB CLI。

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

1. 確認已正確安裝 EB CLI。

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

您可以使用 `deactivate` 命令來離開虛擬環境。無論您何時開始新的工作階段，請重新執行啟用命令。

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

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

## 使用 Homebrew 安裝 EB CLI
<a name="eb-cli3-install-osx-homebrew"></a>

當 `Homebrew` 出現新版本的 EB CLI，通常數日之後即可在 `pip` 使用。

**我們建議您使用安裝程式指令碼**  
建議使用 [安裝 EB CLI](#eb-cli3-install)來設定 EB CLI，並防止相依性衝突。

**使用 `Homebrew` 安裝 EB CLI**

1. 確認您具備最新版本的 `Homebrew`。

   ```
   $ brew update
   ```

1. 執行 `brew install awsebcli`。

   ```
   $ brew install awsebcli
   ```

1. 確認已正確安裝 EB CLI。

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