必要條件使用 Bundled Installer 安裝和解除安裝使用 pip 安裝和解除安裝

在 Linux 上安裝，更新和卸載 AWS CLI 版本 1

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

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

章節

必要條件
使用隨附的安裝程式在 Linux 上安裝和解除安裝 AWS CLI 版本 1
使用 pip 安裝和卸載 AWS CLI 版本 1

必要條件

您必須安裝 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`

以下步驟使您可以在任何 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

使用下列其中一種方法下載 AWS CLI 版本 1 隨附的安裝程式。
- 使用 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 at，/usr/local/aws並在/usr/local/bin目錄中建立符號連結aws。使用 -b 選項來建立符號連結，可減少在使用者的 $PATH 變數中指定安裝目錄的需要。這應該可讓所有使用者 AWS CLI 透過aws從任何目錄輸入來呼叫。
```
$ 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.32.65 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


$ 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

以下列其中一種方式下載 AWS CLI 版本 1 隨附的安裝程式。
- 使用 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 at，/usr/local/aws並在/usr/local/bin目錄中建立符號連結aws。最後一個命令會使用 -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.32.65 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

如果發生錯誤，請參閱排解 AWS CLI 錯誤。

卸載 AWS CLI 版本 1 捆綁的安裝程序

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

警告
這些組態和認證設定會在所有 AWS SDK 和. AWS CLI如果您移除此資料夾，系統上仍存在的任何 AWS SDK 都無法存取這些資料夾。

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

使用 pip 安裝和卸載 AWS CLI 版本 1

主題

安裝 pip
使用 pip 安裝並更新 AWS CLI 版本 1
將 AWS CLI 版本 1 可執行文件添加到命令行路徑
卸載使 AWS CLI 用 pip
AWS CLI 安裝和解除安裝錯誤疑難

安裝 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.32.65 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

如果發生錯誤，請參閱排解 AWS CLI 錯誤。

將 AWS CLI 版本 1 可執行文件添加到命令行路徑

在使用 pip 進行安裝後，您可能需要將 aws 可執行檔新增到作業系統的 PATH 環境變數中。

您可以通過運行以下命令來驗證pip安裝了哪個文件夾。 AWS CLI


$ 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 用 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 SDK 和. AWS CLI如果您移除此資料夾，系統上仍存在的任何 AWS SDK 都無法存取這些資料夾。

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

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

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

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

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

文件慣用形式

Amazon Linux

macOS

在 Linux 上安裝，更新和卸載 AWS CLI 版本 1

章節

必要條件

使用隨附的安裝程式在 Linux 上安裝和解除安裝 AWS CLI 版本 1

注意

主題

使用隨附的安裝程式安裝 AWS CLI 版本 1 sudo

使用隨附的安裝程式安裝 AWS CLI 版本 1

使用捆綁的安裝程序安裝 AWS CLI 版本 1，而不 sudo

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

卸載 AWS CLI 版本 1 捆綁的安裝程序

警告

使用 pip 安裝和卸載 AWS CLI 版本 1

主題

安裝 pip

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

注意

將 AWS CLI 版本 1 可執行文件添加到命令行路徑

修改 PATH 變數

卸載使 AWS CLI 用 pip

警告

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

使用隨附的安裝程式安裝 AWS CLI 版本 1 `sudo`

使用捆綁的安裝程序安裝 AWS CLI 版本 1，而不 `sudo`

修改 `PATH` 變數