在 macOS 上安裝、更新和解除安裝 AWS CLI 第 1 版 - AWS Command Line Interface

本文件僅適用於 AWS CLI 的第 1 版。如需 AWS CLI 第 2 版的相關文件,請參閲第 2 版使用者指南

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

您可以使用 Bundled Installer 或 pip,在 macOS 上安裝 AWS Command Line Interface (AWS CLI) 第 1 版及其相依性。

先決條件

在 macOS 上安裝 AWS CLI 第 1 版前,請確定已安裝 Python 第 3.6 版或更新版本。如需安裝說明,請參閱 Python《入門指南》中的下載 Python

警告

Python 軟體基金會已於 2020 年 1 月 1 日棄用 Python 2.7。從 AWS CLI 1.20.0 版開始,則至少需要 Python 3.6 版。

若要將舊版 Python 與 AWS CLI 第 1 版搭配使用,您需要安裝舊版的 AWS CLI 第 1 版。若要檢視 AWS CLI 第 1 版 Python 版本支援對照表,請參閱 Python 版本要求

使用 Bundled Installer 在 macOS 上安裝、更新和解除安裝 AWS CLI 第 1 版

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

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

透過 sudo 使用 Bundled Installer 安裝 AWS CLI 第 1 版

下列步驟可讓您從任何 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

使用 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-exe-linux-aarch64-2.0.30.zip,因此使用以下 URL:https://s3.amazonaws.com/aws-cli/awscli-bundle-2.0.30.zip

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

    $ 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.22.23 Python/3.8.8 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

    如果發生錯誤,請參閱 故障診斷 AWS CLI 錯誤

不透過 sudo 使用 Bundled Installer 安裝 AWS CLI 第 1 版

如果您沒有 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 第 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-exe-linux-aarch64-2.0.30.zip,因此使用以下 URL:https://s3.amazonaws.com/aws-cli/awscli-bundle-2.0.30.zip

  2. 從套件中解壓縮檔案。如果您沒有 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.22.23 Python/3.8.8 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

    如果發生錯誤,請參閱 故障診斷 AWS CLI 錯誤

解除安裝 AWS CLI 第 1 版 Bundled Installer

  1. Bundled Installer 會將除了可選符號連結之外的所有內容放在安裝目錄中,因此若要解除安裝,您只需刪除這兩個項目即可。

    $ sudo rm -rf /usr/local/aws $ sudo rm /usr/local/bin/aws
  2. (選用) 移除 .aws 資料夾中的共享 AWS 開發套件和 AWS CLI 設定資訊。

    警告

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

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

    $ sudo rm ~/.aws/

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

您也可以直接使用 pip 安裝 AWS CLI。

安裝 pip

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

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

    $ curl -O https://bootstrap.pypa.io/get-pip.py
  2. 搭配 pythonpython3 命令執行指令碼來下載並安裝最新版本的 pip 及其他必要的支援套件。當您加入 --user 參數,指令碼會將 pip 安裝到路徑 ~/.local/bin

    $ python3 get-pip.py --user

使用 pip 安裝和更新 AWS CLI

  1. 使用 pippip3 命令來安裝 AWS CLI。如果您使用 Python 第 3 版或更新版本,我們建議您使用 pip3 命令。

    若為最新版本的 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.22.23 Python/3.8.8 Darwin/18.7.0 botocore/1.13

    如果找不到此程式,請將它新增到命令列路徑

將 AWS CLI 第 1 版可執行檔新增到您的 macOS 命令列路徑

在使用 pip 進行安裝後,您可能需要將 aws 程式新增到作業系統的 PATH 環境變數中。程式的位置取決於 Python 的安裝位置。

範例 AWS CLI 安裝位置 - 使用 Python 3.6 和 pip (使用者模式) 的 macOS

~/Library/Python/3.7/bin

請以您的 Python 版本替代上述範例中的版本。

如果您不知道 Python 的安裝位置,請執行 which python

$ which python /usr/local/bin/python

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

$ ls -al /usr/local/bin/python ~/Library/Python/3.7/bin/python3.7

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

修改 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 解除安裝 AWS CLI

  1. 若要解除安裝 AWS CLI,請使用 pip uninstall

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

    警告

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

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

    $ sudo rm ~/.aws/