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

使用 Bundled Installer 安裝 AWS CLI 第 1 版

1. 使用下列其中一種方法下載 AWS CLI 第 1 版的 Bundled Installer。

   • 使用 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

2. 從套件中解壓縮檔案。如果您沒有 unzip 來擷取檔案，請使用 Linux 發行版本內建的套件管理工具來安裝它。

   $ unzip awscli-bundle.zip

3. 執行安裝程式。安裝程式會將 AWS CLI 安裝到 /usr/local/aws，並在 /usr/local/bin 目錄中建立符號連結 aws。使用 -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

4. 確認已正確安裝 AWS CLI。

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

   如果發生錯誤，請參閱 故障診斷 的錯誤 AWS CLI。

若要為目前使用者安裝 AWS CLI 第 1 版

1. 使用下列其中一種方式下載 AWS CLI 第 1 版的 Bundled Installer。

   • 使用 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

2. 從套件中使用 unzip 解壓縮檔案。如果您沒有 unzip，請使用 Linux 發行版本內建的套件管理工具來安裝它。

   $ unzip awscli-bundle.zip

3. 執行安裝程式。安裝程式會將 AWS CLI 安裝到 /usr/local/aws，並在 /usr/local/bin 目錄中建立符號連結 aws。最後一個命令會使用 -b 參數來指定安裝程式放置 aws 符號連結檔案的資料夾。您必須具有指定資料夾的寫入權限。

   $ ./awscli-bundle/install -b ~/bin/aws

   這會將 AWS CLI 安裝到預設位置 (~/.local/lib/aws) 並在 ~/bin/aws 中建立符號連結 (symlink)。請確保 ~/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

4. 確保目錄中 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

5. 確認已正確安裝 AWS CLI。

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

   如果發生錯誤，請參閱 故障診斷 的錯誤 AWS CLI。

1. 如果您已使用 Bundled Installer 安裝 AWS CLI，請按下列說明操作。Bundled Installer 不會在安裝目錄之外的位置存放資料 (選用符號連結除外)，所以解除安裝十分簡單，就是直接刪除這兩個項目。

   $ sudo rm -rf /usr/local/aws
   $ sudo rm -rf /usr/local/bin/aws

2. (選用) 移除 .aws 資料夾中的共享 AWS 開發套件和 AWS CLI 設定資訊。

   警告

   這些組態和憑據設定在所有 AWS 開發套件和 AWS CLI 之間共用。如果您移除此資料夾，則您的系統中仍然存在的任何 AWS 開發套件將無法存取它們。

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

   $ sudo rm -r ~/.aws/

1. 使用 curl 命令下載安裝指令碼。以下命令使用 -O (大寫字母「O」) 參數，指定下載的檔案要存放在目前的資料夾中，並使用遠端主機上的相同名稱。

   $ curl -O https://bootstrap.pypa.io/get-pip.py

2. 搭配 python 或 python3 命令執行指令碼來下載並安裝最新版本的 pip 及其他必要的支援套件。當您加入 --user 參數，指令碼會將 pip 安裝到路徑 ~/.local/bin。

   $ python3 get-pip.py --user

3. 請確保包含 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

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

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

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

2. 確認已正確安裝 AWS CLI。

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

   如果發生錯誤，請參閱 故障診斷 的錯誤 AWS CLI。

1. 如果您使用 pip 安裝了 AWS CLI 第 1 版，您也必須使用 pip 解除安裝。

   $ pip uninstall awscli

   如果您使用的是 Python 2 或 3 版，則可能需要使用 pip2 或 pip3 命令。使用 aws --version 命令來判斷與您所安裝 AWS CLI 第 1 版相關聯的 Python 版本。

   $ pip3 uninstall awscli

   您可能需要重新啟動命令提示字元視窗或電腦，才能移除所有檔案。

2. (選用) 移除 .aws 資料夾中的共享 AWS 開發套件和 AWS CLI 設定資訊。

   警告

   這些組態和憑據設定在所有 AWS 開發套件和 AWS CLI 之間共用。如果您移除此資料夾，則您的系統中仍然存在的任何 AWS 開發套件將無法存取它們。

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

   $ sudo rm -r ~/.aws/

1. 在平台上安裝 Snapcraft。如需安裝 Snapcraft 的詳細資訊，請參閱 Snap 文件中的安裝常駐程式。

2. 重新啟動系統，以正確更新 PATH 變數。如果您有安裝問題，請遵循 Snap 文件中修正常見問題的步驟。

3. 若要確認 snap 已正確安裝，請執行下列命令。

   $ snap version

1. 對第 1 版 AWS CLI 執行下列 snap install 命令。

   $ snap install aws-cli --channel=v1/stable --classic

   根據您的許可，您可能需要將 sudo 新增至命令。

   $ sudo snap install aws-cli --channel=v1/stable --classic

2. 確認已正確安裝 AWS CLI。

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

   如果發生錯誤，請參閱 故障診斷 的錯誤 AWS CLI。

1. 如果您使用 snap 安裝了 AWS CLI 第 1 版，您也必須使用 snap 解除安裝。

   $ snap remove aws-cli

   您可能需要重新啟動命令提示字元視窗或電腦，才能移除所有檔案。

2. (選用) 移除 .aws 資料夾中的共享 AWS 開發套件和 AWS CLI 設定資訊。

   警告

   這些組態和憑據設定在所有 AWS 開發套件和 AWS CLI 之間共用。如果您移除此資料夾，則您的系統中仍然存在的任何 AWS 開發套件將無法存取它們。

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

   $ sudo rm -r ~/.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

2. 將匯出命令新增至您的描述檔指令碼。

   export PATH=~/.local/bin:$PATH

   這個命令將路徑 (此範例中的 ~/.local/bin) 新增到目前的 PATH 變數。

3. 將更新過的設定檔載入到您目前工作階段。

   $ source ~/.bash_profile