**本文件 AWS CLI 僅適用於 第 1 版。**

我們已宣布即將end-of-support。 AWS CLI 我們建議您遷移至 第 2 AWS CLI 版。如需日期、其他詳細資訊和如何遷移的資訊，請參閱 [公告](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/)。如需 第 2 版的相關文件 AWS CLI，請參閱 第 [2 版使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)。

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

# 在 Amazon Linux 上安裝、更新和解除安裝第 1 AWS CLI 版
<a name="install-linux-al2017"></a>

第 1 AWS CLI 版預先安裝在 Amazon Linux 和 Amazon Linux 2 上。使用下列命令檢查目前已安裝的版本。

```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```

視您建立 Amazon Linux 執行個體的時間而定，第 1 AWS CLI 版會使用下列其中一個套件管理員預先安裝：
+ [pip](#install-amazon-linux-pip)
+ [yum](#install-amazon-linux-yum)

## 先決條件
<a name="install-amazon-linux-prereq"></a>

您必須安裝 Python 3.8 版或更新版本。如需安裝說明，請參閱 Python《入門指南》**中的[下載 Python](https://wiki.python.org/moin/BeginnersGuide/Download)。

**Python 版本支援矩陣**


| AWS CLI 版本 | 支援的 Python 版本 | 
| --- | --- | 
| 1.39.0 – 目前版本 | Python 3.9\$1 | 
| 1.32.0 – 1.38.38 | Python 3.8\$1 | 
| 1.27.0 至 1.31.x | Python 3.7\$1 | 
| 1.20.0 至 1.26.x | Python 3.6\$1 | 
| 1.19.0 至 1.19.x | Python 2.7\$1、Python 3.6\$1 | 
| 1.17 – 1.18.x | Python 2.7\$1、Python 3.4\$1 | 
| 1.0 – 1.16.x | Python 2.6 及更舊版本、Python 3.3 及更舊版本 | 

## 使用 pip 安裝、更新或解除安裝
<a name="install-amazon-linux-pip"></a>

大多數 Amazon Linux 執行個體使用 pip 來預先安裝第 1 AWS CLI 版。

### 使用 pip 在 Amazon Linux 上安裝或更新 AWS CLI 版本 1
<a name="install-amazon-linux-pip-install"></a>

若要為目前使用者安裝最新版本的 第 1 AWS CLI 版，請使用下列指示。

1. 如果您已安裝 Python 第 3 版或更新版本，建議您使用 `pip3`。使用 `pip3 install` 安裝或更新至最新版本的 第 1 AWS CLI 版。如果您在 [Python 虛擬環境 (venv)](https://docs.python.org/3/library/venv.html) 中執行命令，則您不需要使用 `--user` 選項。

   ```
   $ pip3 install --upgrade --user awscli
   ```

1. 請確保包含 `aws` 的資料夾是 `PATH` 變數的一部分。

   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. 在設定檔尾端新增匯出命令，類似於以下範例。

      ```
      export PATH=$HOME/.local/bin:$PATH
      ```

      這個命令會將此範例中的路徑 `$HOME/.local/bin` 新增到目前現有 `$PATH` 變數的前端。

   1. 將描述檔重新載入到目前的工作階段，讓這些變更生效。

      ```
      $ source ~/.bash_profile
      ```

1. 若要確認您正在執行新版本，請使用 `aws --version` 命令。

   ```
   $ aws --version
   aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
   ```

### 使用 pip 解除安裝 AWS CLI 版本 1
<a name="install-amazon-linux-pip-uninstall"></a>

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

```
$ pip3 uninstall awscli
```

## 使用 yum 安裝、更新或解除安裝
<a name="install-amazon-linux-yum"></a>

大多數 Amazon Linux 2 執行個體使用 yum 來預先安裝第 1 AWS CLI 版。

### 使用 yum 在 Amazon Linux 上安裝或更新 AWS CLI 版本 1
<a name="install-amazon-linux-yum-install"></a>

若要安裝 Amazon Linux 上可用的最新版本 第 1 AWS CLI 版，請執行下列命令。

```
$ sudo yum install awscli
```

若要更新至 Amazon Linux AWS CLI 上可用的最新版本 1，請執行下列命令。

```
$ sudo yum update awscli
```

若要確認您正在執行較新版本，請使用 `aws --version` 命令。

```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```

### 使用 yum 解除安裝 AWS CLI 版本 1
<a name="install-amazon-linux-yum-uninstall"></a>

若要解除安裝 AWS CLI，請使用 `yum remove`。

```
$ sudo yum remove awscli
```

## 針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷
<a name="install-amazon-linux-tshoot"></a>

如果您在安裝或解除安裝 之後遇到問題 AWS CLI，請參閱 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md) 以取得故障診斷步驟。如需最相關的故障診斷步驟，請參閱 [命令未找到錯誤](cli-chap-troubleshooting.md#tshoot-install-not-found)、[「`aws --version`」命令傳回的版本與您安裝的版本不同](cli-chap-troubleshooting.md#tshoot-install-wrong-version) 和 [解除安裝 後，「`aws --version`」命令會傳回版本 AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1)。