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

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

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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

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

必要條件

在 macOS 上安裝第 1 AWS CLI 版之前,請確定您已安裝 Python 3.8 或更新版本。 macOS 如需安裝說明,請參閱 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 及更舊版本

使用套件安裝程式在 macOS 上安裝、更新和解除安裝第 1 AWS CLI 版

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

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

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

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

  2. 解壓縮 (解壓縮) 套件中的檔案。如果您沒有 unzip,請使用 macOs 分佈的內建套件管理員來安裝它。

    $ unzip awscli-bundle.zip
  3. 執行安裝程式。安裝程式會在 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
  4. 確認 已正確 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. 使用下列其中一種方法下載第 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

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

    $ unzip awscli-bundle.zip
  3. 執行安裝程式。安裝程式會在 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
  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.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

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

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

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

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

    警告

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

    資料夾的預設位置在平台之間.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

AWS CLI 使用 pip 安裝和更新

  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.33.33 Python/3.11.6 Darwin/23.3.0 botocore/1.18.6

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

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

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

範例 AWS CLI 安裝位置 - macOS 搭配 Python 3.6 和 pip(使用者模式)
~/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

AWS CLI 使用 pip 解除安裝

  1. 如果您使用 安裝 AWS CLI 版本 1pip,則也必須使用 解除安裝 pip

    $ pip uninstall awscli

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

    $ pip3 uninstall awscli

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

  2. (選用) 移除.aws資料夾中的共用 AWS SDK和 AWS CLI 設定資訊。

    警告

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

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

    $ sudo rm ~/.aws/

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

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