在 macOS 上安裝 AWS CLI 第 1 版。 - AWS Command Line Interface

在 macOS 上安裝 AWS CLI 第 1 版。

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

先決條件

在 macOS 上安裝 AWS CLI 第 1 版 之前,請確定您已安裝 Python 2 版本 2.7 或更新版本,或 Python 3 版本 3.4 或更新版本。如需安裝說明,請參閱 Python 初學者指南中的下載 Python 頁面。

重要

AWS CLI 版本 1 不再支援 Python 2.6 和 3.3 版本。2020 年 1 月 10 日之後,AWS CLI 第 1 版 發行的所有版本 (從 1.17 開始) 都需要 Python 2.7、Python 3.4 或更新版本。

此變更不會影響下列版本的 AWS CLI:

  • AWS CLI 第 1 版 的 Windows MSI 安裝程式版本

  • AWS CLI 第 2 版

如需詳細資訊,請參閱本指南中的 搭配舊版的 Python 使用 AWS CLI 第 1 版,以及廢除公告部落格文章。

使用隨附的安裝程式安裝、更新和解除安裝 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 版

下列步驟可讓您從任何 Linux 或 macOS 組建上的命令列安裝 AWS CLI 第 1 版。

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

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

使用 Bundled Installer 安裝 AWS CLI 第 1 版

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

  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.18.83 Python/3.7.4 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

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

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

如果您沒有 sudo 許可,或只想為目前的使用者安裝 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 版

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

  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.18.83 Python/3.7.4 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

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

解除安裝 AWS CLI 第 1 版 Bundled Installer

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

$ sudo rm -rf /usr/local/aws $ sudo rm /usr/local/bin/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 命令。

    $ pip3 install awscli --upgrade --user
  2. 確認已正確安裝 AWS CLI。

    $ aws --version aws-cli/1.18.83 Python/3.7.4 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

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

$ pip3 uninstall awscli