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

AWS CLI 第 1 版已棄用 Python 2.7、3.4 及 3.5。如需詳細資訊,請參閱關於 AWS CLI 版本的 AWS CLI 第 1 版部分。

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

本主題說明如何在 macOS 上安裝、更新和移除 AWS CLI 第 2 版。

重要

AWS CLI 第 1 版及第 2 版會使用相同的 aws 命令名稱。如果您已安裝兩個版本,您的電腦會使用搜尋路徑中找到的第一個版本。如果您先前已安裝 AWS CLI 第 1 版,我們建議您執行下列其中一項操作來使用 AWS CLI 第 2 版:

  • 建議 – 解除安裝 AWS CLI 第 1 版且僅使用 AWS CLI 第 2 版。如需解除安裝說明,請判斷您用於安裝 AWS CLI 第 1 版的方法,並遵循 安裝、更新和解除安裝 AWS CLI 第 1 版 中作業系統正確的解除安裝說明

  • 使用作業系統的能力,為兩個 aws 命令之一建立具有不同名稱的符號連結 (symlink) 或別名。例如,您可以在 Linux 和 macOS 上使用符號連結別名,或在 Windows 上使用 DOSKEY

如需第 1 版和第 2 版之間重大變更的詳細資訊,請參閱重大變更 – 從 AWS CLI 第 1 版遷移至第 2 版

Prerequisites

  • 我們支援在 Apple 支援的 64 位元 macOS 版本上的 AWS CLI 第 2 版。

  • 由於 AWS 不維護第三方儲存庫,因此我們無法保證它們包含最新版本的 AWS CLI。

使用 macOS 使用者界面安裝和更新 AWS CLI 第 2 版

以下步驟說明如何使用標準 macOS 使用者界面和瀏覽器來安裝或更新至 AWS CLI 第 2 版的最新版本。如果您要更新至最新版本,請使用您目前版本所使用的相同安裝方法。

  1. 在瀏覽器中,下載 macOS pkg 檔案:

  2. 按兩下下載的檔案以啟動安裝程式。

  3. 遵循螢幕說明。您可以選擇以下列方式安裝 AWS CLI 第 2 版:

    • 對於電腦上的所有使用者 (需要 sudo)

      • 您可以安裝到任何資料夾,或選擇建議的 /usr/local/aws-cli 的預設資料夾。

      • 安裝程式會自動在 /usr/local/bin/aws 建立符號連結,其連結至您所選擇的安裝資料夾中的主程式。

    • 只對於目前的使用者 (不需要 sudo)

      • 您可以安裝到任何具有寫入權限的資料夾。

      • 由於標準的使用者許可,在安裝程式完成之後,您的 $PATH 必須在命令提示字元中使用下列命令,手動建立指向 awsaws_completer 程式的符號連結檔案。如果您的 $PATH 包含可以寫入的資料夾,則如果將該資料夾指定為目標路徑,則可執行下列命令而無需 sudo。如果您在 $PATH 中沒有可寫入的資料夾,則必須在命令中使用 sudo,以取得寫入指定目標資料夾的許可。符號連結的預設位置為 /usr/local/bin/

        $ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws $ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
    注意

    您可以在安裝程式中的任何位置按 Cmd+L 來檢視安裝的偵錯日誌。這會開啟一個日誌窗格,使您能夠篩選和儲存日誌。日誌檔也會自動儲存到 /var/log/install.log

  4. 若要確認 AWS CLI 第 2 版已安裝,請依照 驗證安裝 中的步驟執行。

使用 macOS 命令列安裝和更新 AWS CLI 第 2 版

您可以從命令列下載、安裝和更新。如果您要更新至最新版本,請使用您在目前版本中使用的相同安裝方法。您可以使用下列其中一種方式來安裝 AWS CLI 第 2 版:

使用 macOS 命令列為所有使用者安裝和更新

如果您具有 sudo 許可,則可以為電腦上的所有使用者安裝 AWS CLI 第 2 版。

我們提供一組易於複製和貼上的步驟。請參閱後續步驟中每一行的描述。

如需 AWS CLI 的最新版本,請使用下列命令區塊:

$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" $ sudo installer -pkg AWSCLIV2.pkg -target /

若為 AWS CLI 的特定版本,請在檔案名稱中附加連字號和版本號碼。在這個範例中,版本 2.0.30 的檔案名稱會變成 AWSCLIV2-2.0.30.pkg,結果如下列命令所示:

$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg" $ sudo installer -pkg AWSCLIV2.pkg -target /

如需版本清單,請參閱 GitHub 上的 AWS CLI 第 2 版變更記錄

  1. 使用 curl 命令下載檔案。在此範例中,-o 選項會指定系統寫入下載套件的檔案名稱。在前述的範例中,檔案會寫入目前的資料夾中的 AWSCLIV2.pkg

    如需 AWS CLI 的最新版本,請使用下列命令區塊:

    $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"

    若為 AWS CLI 的特定版本,請在檔案名稱中附加連字號和版本號碼。在這個範例中,版本 2.0.30 的檔案名稱會變成 AWSCLIV2-2.0.30.pkg,結果如下列命令所示:

    $ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"

    如需版本清單,請參閱 GitHub 上的 AWS CLI 第 2 版變更記錄

  2. 執行標準 macOS installer 程式,將下載的 .pkg 檔案指定為來源。使用 -pkg 參數可指定要安裝的套件名稱,以及磁碟機要安裝套件的 -target / 參數。檔案會安裝到 /usr/local/aws-cli,並且會在 /usr/local/bin 中自動建立符號連結。您必須在命令上包含 sudo,才能將寫入權限授予這些資料夾。

    $ sudo installer -pkg ./AWSCLIV2.pkg -target /

    安裝完成後,偵錯記錄檔會寫入 /var/log/install.log

  3. 若要確認 AWS CLI 第 2 版已安裝,請依照 驗證安裝 中的步驟執行。

若要使用 macOS 命令列僅針對目前的使用者進行安裝和更新

  1. 若要指定將 AWS CLI 安裝到哪個資料夾,您必須建立 XML 檔案。這個檔案是 XML 格式化的檔案,看起來如下列範例。如圖所示保留所有值,但您必須將第 9 行中的路徑 /Users/myusername 替換為要安裝 AWS CLI 第 2 版的資料夾路徑。資料夾必須已存在,否則命令會失敗。 此 XML 範例指定安裝程式在資料夾 AWS CLI 中安裝 /Users/myusername,其會建立名為 aws-cli 的資料夾。

    <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> <key>choiceAttribute</key> <string>customLocation</string> <key>attributeSetting</key> <string>/Users/myusername</string> <key>choiceIdentifier</key> <string>default</string> </dict> </array> </plist>
  2. 使用 pkg 命令下載 curl 安裝程式。在此範例中,-o 選項會指定系統寫入下載套件的檔案名稱。在前述的範例中,檔案會寫入目前的資料夾中的 AWSCLIV2.pkg

  3. 如需 AWS CLI 的最新版本,請使用下列命令區塊:

    $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"

    若為 AWS CLI 的特定版本,請在檔案名稱中附加連字號和版本號碼。在這個範例中,版本 2.0.30 的檔案名稱會變成 AWSCLIV2-2.0.30.pkg,結果如下列命令所示:

    $ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"

    如需版本清單,請參閱 GitHub 上的 AWS CLI 第 2 版變更記錄

  4. 現在您可以使用下列選項來執行標準 macOS installer 程式:

    • 使用參數 -pkg 指定要安裝的套件的名稱。

    • 若要指定僅限目前使用者的安裝,您必須設定參數 -targetCurrentUserHomeDirectory

    • 指定您在 -applyChoiceChangesXML 參數中建立的 XML 檔案的路徑 (相對於目前的資料夾) 和名稱。

    下列範例會在資料夾 AWS CLI 中安裝 /Users/myusername/aws-cli

    $ installer -pkg AWSCLIV2.pkg \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML choices.xml
  5. 由於標準使用者許可通常不允許寫入 $PATH 中的資料夾,因此此模式下的安裝程式不會嘗試新增連至 awsaws_completer 的符號連結。若要正確執行 AWS CLI,您必須在安裝程式完成後手動建立符號連結。如果您的 $PATH 包含可以寫入的資料夾,則如果將該資料夾指定為目標路徑,則可執行下列命令而無需 sudo。如果您的 $PATH 中沒有可寫入的資料夾,則必須使 sudo 以取得寫入指定目標資料夾的許可。符號連結的預設位置為 /usr/local/bin/

    $ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws $ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer

    安裝完成後,偵錯記錄檔會寫入 /var/log/install.log

  6. 若要確認 AWS CLI 第 2 版已安裝,請依照 驗證安裝 中的步驟執行。

驗證安裝

若要確認殼層可以在您的 aws 中尋找並執行 $PATH 命令,請使用下列命令。如果找不到 aws 命令,您可能需要重新啟動終端機。

$ which aws /usr/local/bin/aws $ aws --version aws-cli/2.1.29 Python/3.7.4 Darwin/18.7.0 botocore/2.0.0

解除安裝 AWS CLI 第 2 版

若要解除安裝 AWS CLI 第 2 版,請執行下列命令,替代您用來安裝的路徑。

  1. 尋找包含主程式和完成標籤之符號連結的資料夾。

    $ which aws /usr/local/bin/aws
  2. 使用該資訊,執行下列命令,以尋找符號連結指向的安裝資料夾。

    $ ls -l /usr/local/bin/aws lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/aws
  3. 現在,刪除第一個資料夾中的兩個符號連結。如果您的使用者帳戶具有這些資料夾的寫入權限,則不需要使用 sudo

    $ sudo rm /usr/local/bin/aws $ sudo rm /usr/local/bin/aws_completer
  4. 刪除主要安裝資料夾。使用 sudo 來取得 /usr/local 資料夾的寫入權限。

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