必要條件使用 Bundled Installer 安裝和解除安裝使用 pip 安裝和解除安裝使用 pip 安裝和解除安裝將 AWS CLI 版本 1 可執行檔新增至命令列路徑安裝 AWS CLI 和解除安裝錯誤的疑難排解

在 Linux 上安裝、更新和解除安裝 AWS CLI 版本 1

您可以使用pip套件管理員或套件安裝程式，在大多數 Linux 發行版本上安裝 AWS Command Line Interface （AWS CLI）第 1 版及其相依性。

雖然 awscli套件可在其他套件管理員的儲存庫中使用，例如 apt和 yum，但不會產生、管理或支援這些套件 AWS。建議您僅 AWS CLI 從官方 AWS 分發點安裝，如本指南所述。

必要條件

您必須安裝 Python 3.8 版或更新版本。如需安裝說明，請參閱 Python《入門指南》中的下載 Python。

Python 版本支援矩陣

AWS CLI 版本	支援的 Python 版本
1.32.0 至現行版本	Python 3.8+
1.27.0 至 1.31.x	Python 3.7+
1.20.0 至 1.26.x	Python 3.6+
1.19.0 至 1.19.x	Python 2.7+、Python 3.6+
1.17 – 1.18.x	Python 2.7+、Python 3.4+
1.0 – 1.16.x	Python 2.6 及更舊版本、Python 3.3 及更舊版本

使用套件安裝程式在 Linux 上安裝和解除安裝 AWS CLI 版本 1

在 Linux 或 macOS 上，您可以使用 Bundled Installer 來安裝 AWS CLI第 1 版。Bundled Installer 包含所有的依存項目，並可於離線使用。

注意

Bundled Installer 無法安裝到包含空格的路徑。

主題

使用搭配的套件安裝程式安裝 AWS CLI 版本 1 sudo
使用套件安裝程式安裝 AWS CLI 版本 1，而不使用 sudo
解除安裝第 1 AWS CLI 版套件安裝程式

使用搭配的套件安裝程式安裝 AWS CLI 版本 1 `sudo`

下列步驟可讓您在任何 Linux 或 macOS 建置上，從命令列安裝 AWS CLI 版本 1。

下列是您可以剪貼當成一組命令來執行的安裝命令的摘要。

對於最新版本的 AWS CLI，請使用下列命令區塊：


$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

對於的特定版本 AWS CLI，請將連字號和版本號碼附加至檔案名稱。在此範例中，版本的檔案名稱 1.16.312 awscli-bundle-1.16.312.zip 會產生下列命令：


$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

請依照命令列中的下列步驟，使用套件安裝程式安裝 AWS CLI 版本 1。

使用套件安裝程式安裝 AWS CLI 版本 1

使用下列其中一種方法下載第 1 AWS CLI 版套件安裝程式。
- 使用 curl 命令下載。
  
  對於最新版本的 AWS CLI，請使用下列命令區塊：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
  對於的特定版本 AWS CLI，請將連字號和版本號碼附加至檔案名稱。在此範例中，版本的檔案名稱 1.16.312 awscli-bundle-1.16.312.zip 會產生下列命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
- 使用直接連結下載。
  
  如需 AWS CLI的最新版本：https://s3.amazonaws.com/aws-cli/awscli-bundle.zip
  
  對於的特定版本 AWS CLI，請將連字號和版本號碼附加至檔案名稱。在此範例中，版本的檔案名稱 1.16.312 awscli-bundle-1.16.312.zip 會導致下列 URL https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip
從套件中解壓縮檔案。如果您沒有 unzip 來擷取檔案，請使用 Linux 發行版本內建的套件管理工具來安裝它。
```
$ unzip awscli-bundle.zip
```
執行安裝程式。安裝程式會在 AWS CLI 上安裝，/usr/local/aws並在aws/usr/local/bin目錄建立符號連結。使用 -b 選項來建立符號連結，可減少在使用者的 $PATH 變數中指定安裝目錄的需要。這應該可讓所有使用者aws從任何目錄輸入 AWS CLI 來呼叫。
```
$ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
根據預設，安裝指令碼會在系統預設版本的 Python 下執行。如果您已安裝 Python 的替代版本，並想要使用該版本來安裝 AWS CLI，請透過 Python 可執行檔的絕對路徑使用該版本執行安裝指令碼，如下所示。
```
$ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
確認 AWS CLI 安裝正確。
```
$ aws --version
aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
如果發生錯誤，請參閱對的錯誤進行故障診斷 AWS CLI。

使用套件安裝程式安裝 AWS CLI 版本 1，而不使用 `sudo`

如果您沒有sudo許可，或只想 AWS CLI 為目前使用者安裝，您可以使用先前命令的修改版本。前兩個命令是相同的。

對於最新版本的 AWS CLI，請使用下列命令區塊：


$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws

對於的特定版本 AWS CLI，請將連字號和版本號碼附加至檔案名稱。在此範例中，版本的檔案名稱 1.16.312 awscli-bundle-1.16.312.zip 會產生下列命令：


$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws

為目前使用者安裝 AWS CLI 版本 1

使用下列其中一種方式下載第 1 AWS CLI 版套件安裝程式。
- 使用 curl 命令下載。
  
  對於最新版本的 AWS CLI，請使用下列命令區塊：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
  對於的特定版本 AWS CLI，請將連字號和版本號碼附加至檔案名稱。在此範例中，版本的檔案名稱 1.16.312 awscli-bundle-1.16.312.zip 會產生下列命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
- 使用直接連結下載。
  
  如需 AWS CLI的最新版本：https://s3.amazonaws.com/aws-cli/awscli-bundle.zip
  
  對於的特定版本 AWS CLI，請將連字號和版本號碼附加至檔案名稱。在此範例中，版本的檔案名稱 1.16.312 awscli-bundle-1.16.312.zip 會導致下列 URL https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip
從套件中使用 unzip 解壓縮檔案。如果您沒有 unzip，請使用 Linux 發行版本內建的套件管理工具來安裝它。
```
$ unzip awscli-bundle.zip
```
執行安裝程式。安裝程式會在 AWS CLI 上安裝，/usr/local/aws並在aws/usr/local/bin目錄建立符號連結。最後一個命令會使用 -b 參數來指定安裝程式放置 aws 符號連結檔案的資料夾。您必須具有指定資料夾的寫入權限。
```
$ ./awscli-bundle/install -b ~/bin/aws
```
這會將安裝 AWS CLI 到預設位置（~/.local/lib/aws），並在建立符號連結（符號連結）~/bin/aws。請確保 ~/bin 位於您的 PATH 環境變數，以讓符號連結能順利執行。
```
$ echo $PATH | grep ~/bin     // See if $PATH contains ~/bin (output will be empty if it doesn't)
$ export PATH=~/bin:$PATH     // Add ~/bin to $PATH if necessary
```
請確定 AWS CLI 版本 1 是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
2. 在設定檔尾端新增匯出命令，類似於以下範例。
```
export PATH=~/.local/bin:$PATH
```
  這個命令會將此範例中的路徑 ~/.local/bin 新增到目前現有 PATH 變數的前端。
3. 將描述檔重新載入到目前的工作階段，讓這些變更生效。
```
$ source ~/.bash_profile
```
確認 AWS CLI 安裝正確。
```
$ aws --version
aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
如果發生錯誤，請參閱對的錯誤進行故障診斷 AWS CLI。

解除安裝第 1 AWS CLI 版套件安裝程式

如果您 AWS CLI 使用套件安裝程式安裝，請遵循下列指示。Bundled Installer 不會在安裝目錄之外的位置存放資料 (選用符號連結除外)，所以解除安裝十分簡單，就是直接刪除這兩個項目。
```
$ sudo rm -rf /usr/local/aws
$ sudo rm -rf /usr/local/bin/aws
```
（選用） 移除.aws資料夾中的共用 AWS SDK和 AWS CLI 設定資訊。

警告
這些組態和憑證設定會跨所有 AWS SDKs 和共用 AWS CLI。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs 無法存取這些資料夾。

資料夾的預設位置在平台之間.aws不同，預設情況下，資料夾位於 ~/.aws/。如果您的使用者擁有此目錄的寫入許可，則不需要使用 sudo。
```
$ sudo rm -r ~/.aws/
```

使用 pip 安裝和解除安裝 AWS CLI 版本 1

主題

安裝 pip
使用 pip 安裝和更新 AWS CLI 版本 1
AWS CLI 使用 pip 解除安裝

安裝 pip

如果尚未安裝 pip，您可以使用 Python Packaging Authority 提供的指令碼來安裝。執行 pip --version 來查看您的 Linux 版本是否已包含 Python 和 pip。如果您已安裝 Python 第 3 版以上的版本，我們建議您使用 pip3 命令。

使用 curl 命令下載安裝指令碼。以下命令使用 -O (大寫字母「O」) 參數，指定下載的檔案要存放在目前的資料夾中，並使用遠端主機上的相同名稱。
```
$ curl -O https://bootstrap.pypa.io/get-pip.py
```
搭配 python 或 python3 命令執行指令碼來下載並安裝最新版本的 pip 及其他必要的支援套件。當您加入 --user 參數，指令碼會將 pip 安裝到路徑 ~/.local/bin。
```
$ python3 get-pip.py --user
```
請確保包含 pip 的目錄是 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
2. 在設定檔尾端新增匯出命令，類似於以下範例。
```
export PATH=~/.local/bin:$PATH
```
  這個命令會將此範例中的路徑 ~/.local/bin 新增到目前現有 PATH 變數的前端。
3. 將描述檔重新載入到目前的工作階段，讓這些變更生效。
```
$ source ~/.bash_profile
```

若要確認 pip 或 pip3 已正確安裝，請執行下列命令。


$ pip3 --version
pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)

使用 pip 安裝和更新 AWS CLI 版本 1

使用 pip 或 pip3 命令來安裝或更新 AWS CLI。如果您使用 Python 第 3 版，建議您使用 pip3 命令。--user 交換器會將 pip 安裝 AWS CLI 至 ~/.local/bin。

對於最新版本的 AWS CLI，請使用下列命令區塊：
```
$ pip3 install awscli --upgrade --user
```
對於的特定版本 AWS CLI，將兩個等於符號=和版本編號附加至檔案名稱。在此範例中，版本的檔案名稱 1.16.312 會是 ==1.16.312 產生下列命令：
```
$ pip3 install awscli==1.16.312 --upgrade --user
```
注意
使用終端機適當的引用規則。為了使用 = 字元，您可能需要使用單引號或雙引號才能正確逸出。以下範例使用單引號進行轉義：
```
$ pip3 install 'awscli==1.16.312' --upgrade --user
```
確認 AWS CLI 安裝正確。
```
$ aws --version
aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
如果發生錯誤，請參閱對的錯誤進行故障診斷 AWS CLI。

AWS CLI 使用 pip 解除安裝

如果您使用安裝 AWS CLI 版本 1pip，則也必須使用解除安裝 pip。
```
$ pip uninstall awscli
```
如果您使用的是 Python 2 或 3 版，則可能需要使用 pip2 或 pip3 命令。使用 aws --version命令來判斷與您已安裝版本 1 相關聯的 Python AWS CLI 版本。
```
$ pip3 uninstall awscli
```
您可能需要重新啟動命令提示字元視窗或電腦，才能移除所有檔案。
（選用） 移除.aws資料夾中的共用 AWS SDK和 AWS CLI 設定資訊。

警告
這些組態和憑證設定會跨所有 AWS SDKs 和共用 AWS CLI。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs 無法存取這些資料夾。

資料夾的預設位置在平台之間.aws不同，預設情況下，資料夾位於 ~/.aws/。如果您的使用者擁有此目錄的寫入許可，則不需要使用 sudo。
```
$ sudo rm -r ~/.aws/
```

使用 Snapcraft 安裝和解除安裝 AWS CLI 版本 1

主題

安裝快照
使用 snap 安裝和更新 AWS CLI 版本 1
AWS CLI 使用快照解除安裝

安裝快照

如果您尚未snap安裝，您可以使用 Canonical Snapcraft 提供的指示進行安裝。執行 snap version 以查看 Linux 版本是否已包含 snap。

在平台上安裝 Snapcraft。如需安裝 Snapcraft 的相關資訊，請參閱 Snap 文件 中的安裝常駐程式。
重新啟動您的系統，以便正確更新PATH變數。如果您有安裝問題，請遵循 Snap 文件 中的修正常見問題中的步驟。
若要驗證 snap 是否正確安裝，請執行下列命令。
```
$ snap version
```

使用 snap 安裝和更新 AWS CLI 版本 1

對第 1 AWS CLI 版執行下列snap install命令。
```
$ snap install aws-cli --channel=v1/stable --classic
```
根據您的許可，您可能需要將 sudo 新增至命令。
```
$ sudo snap install aws-cli --channel=v1/stable --classic
```
確認 AWS CLI 安裝正確。
```
$ aws --version
aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
如果發生錯誤，請參閱對的錯誤進行故障診斷 AWS CLI。

AWS CLI 使用快照解除安裝

如果您使用安裝 AWS CLI 版本 1snap，則也必須使用解除安裝 snap。
```
$ snap remove aws-cli
```
您可能需要重新啟動命令提示字元視窗或電腦，才能移除所有檔案。
（選用） 移除.aws資料夾中的共用 AWS SDK和 AWS CLI 設定資訊。

警告
這些組態和憑證設定會跨所有 AWS SDKs 和共用 AWS CLI。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs 無法存取這些資料夾。

資料夾的預設位置在平台之間.aws不同，預設情況下，資料夾位於 ~/.aws/。如果您有此目錄的寫入許可，則不需要使用 sudo。
```
$ sudo rm -r ~/.aws/
```

將 AWS CLI 版本 1 可執行檔新增至命令列路徑

使用 pip或安裝之後snap，您可能需要將aws可執行檔新增至作業系統PATH的環境變數。

您可以執行下列命令來驗證 AWS CLI 中pip安裝的資料夾。


$ which aws
/home/username/.local/bin/aws

您可以將此參考為 ~/.local/bin/，因為在 Linux 中 /home/username 對應至 ~。

如果您忽略 --user 參數並因此沒有以使用者模式進行安裝，可執行檔可能位於 Python 安裝的 bin 資料夾中。如果您不知道 Python 的安裝位置，請執行此命令。


$ which python
/usr/local/bin/python

輸出可能是符號連結的路徑，而非實際可執行檔。執行 ls -al 來查看其指向的路徑。


$ ls -al /usr/local/bin/python
/usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6

pip 將程式安裝到包含 Python 應用程式的相同資料夾中。將此資料夾新增至 PATH 變數。

修改 `PATH` 變數

在您的使用者目錄中尋找 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
將匯出命令新增至您的描述檔指令碼。
```
export PATH=~/.local/bin:$PATH
```
這個命令將路徑 (此範例中的 ~/.local/bin) 新增到目前的 PATH 變數。
將更新過的設定檔載入到您目前工作階段。
```
$ source ~/.bash_profile
```

安裝 AWS CLI 和解除安裝錯誤的疑難排解

如果您在安裝或解除安裝之後遇到問題 AWS CLI，請參閱對的錯誤進行故障診斷 AWS CLI 以取得疑難排解步驟。如需最相關的故障診斷步驟，請參閱命令未找到錯誤、「aws --version」命令傳回的版本與您安裝的版本不同和 "aws --version" 命令會在解除安裝後傳回版本 AWS CLI。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

Amazon Linux

macOS