AWS CLI 安裝和更新說明故障診斷 AWS CLI 安裝和解除安裝錯誤後續步驟

安裝或更新至 AWS CLI 的最新版本

本主題將描述如何在支援的作業系統上安裝或更新AWS Command Line Interface(AWS CLI)。如需 AWS CLI 最新版本的詳細資訊，請參閱 GitHub 上的 AWS CLI 第 2 版變更日誌。

若要安裝過去版本的 AWS CLI，請參閱安裝過去版本的 AWS CLI 第 2 版。如需解除安裝說明，請參閱解除安裝 AWS CLI 第 2 版。

重要

AWS CLI 第 1 版及第 2 版會使用相同的 aws 命令名稱。如果已安裝 AWS CLI 第 1 版，請參閱從 AWS CLI 第 1 版遷移至第 2 版。

AWS CLI 安裝和更新說明

如需安裝說明，請根據您的作業系統展開相應的區段。

安裝和更新需求

您必須能夠解壓縮或「解壓縮」下載的套件。如果您的作業系統沒有內建 unzip 命令，請使用對等的命令。
AWS CLI 使用 glibc、groff 和 less。依預設，這些會包含在 Linux 的大多數主要發行版中。
我們支援 64 位元版本的最新 CentOS、Fedora、Ubuntu、Amazon Linux 1、Amazon Linux 2 和 Linux ARM 發行版上的 AWS CLI。
由於 AWS 不維護第三方儲存庫，因此我們無法保證它們包含最新版本的 AWS CLI。

安裝或更新 AWS CLI

若要更新目前安裝的 AWS CLI，請在每次更新時下載新版安裝程式以覆寫舊版。請依照這些步驟，從命令列在 Linux 上安裝 AWS CLI。

我們會根據您使用 64 位元 Linux 或 Linux ARM，在一個易於複製和貼上群組中提供步驟。請參閱後續步驟中每一行的描述。

注意

若要更新 AWS CLI 目前的安裝，新增現有的符號連結和安裝程式資訊，以使用 --update 參數建構 install 命令。


$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update

使用下列其中一種方式下載安裝檔案：
Linux x86 (64-bit)
使用 curl 命令 – -o 選項會指定已下載套件寫入的檔案名稱。下列範例命令的選項會使下載的檔案以本機時間 awscliv2.zip 寫入目前的目錄。

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"

從 URL 下載 – 若要使用瀏覽器下載安裝程式，請使用下列 URL：https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip
Linux ARM
使用 curl 命令 – -o 選項會指定已下載套件寫入的檔案名稱。下列範例命令的選項會使下載的檔案以本機時間 awscliv2.zip 寫入目前的目錄。

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"

從 URL 下載 – 若要使用瀏覽器下載安裝程式，請使用下列 URL：https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip

(可選) 驗證所下載 zip 檔案的完整性

如果您在以上步驟中選擇手動下載 AWS CLI 安裝套件 .zip，則可依循下列步驟，使用 GnuPG 工具來驗證簽章。

AWS CLI 安裝程式套件 .zip 檔案是使用 PGP 簽章進行密碼編譯方式簽署。如果檔案有任何損壞或更改，此驗證會失敗，且您不應該繼續進行安裝。

使用您的套件管理工具下載並安裝 gpg 命令。如需有關 GnuPG 的詳細資訊，請參閱 GnuPG 網站。

若要建立公開金鑰檔案，請建立文字檔案，然後貼上下列文字。

以下公開金鑰詳細資訊僅供參考。


Key ID:           A6310ACC4672
Type:             RSA
Size:             4096/4096
Created:          2019-09-18
Expires:          2023-09-17
User ID:          AWS CLI Team <aws-cli@amazon.com>
Key fingerprint:  FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

使用以下命令導入 AWS CLI 公開金鑰，將 public-key-file-name 換為您建立的公開金鑰檔名。


$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team <aws-cli@amazon.com>" imported
gpg: Total number processed: 1
gpg:               imported: 1

下載您下載之套件的 AWS CLI 簽章檔案。它會有與其對應的 .zip 檔案具有相同的路徑和名稱，但具有副檔名 .sig。在下列範例中，我們將它作為名稱 awscliv2.sig 的檔案儲存在目前的資料夾。
Linux x86 (64-bit)
若為最新版本的 AWS CLI，請使用下列命令區塊：
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig
```
若為特定版本的 AWS CLI，請在檔案名稱中附加連字號和版本號碼。在這個範例中，版本 2.0.30 的檔案名稱為 awscli-exe-linux-x86_64-2.0.30.zip.sig，因此使用以下命令：
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip.sig
```
如需版本清單，請參閱 GitHub 上的 AWS CLI 第 2 版變更日誌。
Linux ARM
若為最新版本的 AWS CLI，請使用下列命令區塊：
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip.sig
```
若為特定版本的 AWS CLI，請在檔案名稱中附加連字號和版本號碼。在這個範例中，版本 2.0.30 的檔案名稱為 awscli-exe-linux-aarch64-2.0.30.zip.sig，因此使用以下命令：
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip.sig
```
如需版本清單，請參閱 GitHub 上的 AWS CLI 第 2 版變更日誌。

驗證簽章，並將下載的 .sig 和 .zip 檔案名稱以參數形式傳遞給 gpg 命令。


$ gpg --verify awscliv2.sig awscliv2.zip

輸出應看起來如下列內容。


gpg: Signature made Mon Nov  4 19:00:01 2019 PST
gpg:                using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team <aws-cli@amazon.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

重要

輸出中的警告是預期的，並不表示有問題。這是因為個人 PGP 金鑰 (如果有) 和 AWS CLI PGP 金鑰之間沒有信任鏈。如需詳細資訊，請參閱「信任網路」。

顯示較多

顯示較少

解壓縮安裝程式。如果您的 Linux 發行版沒有內建 unzip 命令，請使用類似命令解壓縮。下列範例命令會解壓縮套件，並在名為 aws 的目前目錄下建立目錄。
```
$ unzip awscliv2.zip
```
注意
從舊版更新時，unzip 命令會提示覆寫現有檔案。若要略過這些提示 (例如使用指令碼自動化)，對於 unzip 請使用 -u 更新標記。這個標記會視需要自動更新現有檔案和建立新檔案。
```
$ unzip -u awscliv2.zip
```
執行安裝程式。安裝命令會使用新解壓縮的 aws 目錄中名為 install 的檔案。依預設，檔案會全部安裝到 /usr/local/aws-cli，並在 /usr/local/bin 中建立符號連結。命令包括 sudo，以授予寫入權限給這些資料夾。
```
$ sudo ./aws/install
```
如果指定您已具有寫入權限的資料夾，則可以在不使用 sudo 的情況下進行安裝。使用下列 install 命令指示來指定安裝位置：
- 請確定您提供給 -i 和 -b 參數的路徑不包含任何包含空格字元或其他空格字元的磁碟區名稱或目錄名稱。如果有空格，則安裝會失敗。
- --install-dir 或 -i – 此選項指定要將所有檔案複製到的目錄。
  
  預設值為 /usr/local/aws-cli。
- --bin-dir 或 -b – 此選項會指定安裝目錄中的 aws 主程式以符號方式連結至指定路徑的檔案 aws。您必須具有指定目錄的寫入許可。建立路徑中已存在目錄的符號連結，可讓您不需將安裝目錄新增到使用者的 $PATH 變數。
  
  預設值為 /usr/local/bin。
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
注意
若要更新 AWS CLI 目前的安裝，新增現有的符號連結和安裝程式資訊，以使用 --update 參數建構 install 命令。
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
若要找到現有的符號連結和安裝目錄，請執行以下步驟：
1. 使用 which 命令來查找您的符號連結。這提供您與 --bin-dir 參數一起使用的路徑。
  
  $ which aws /usr/local/bin/aws
2. 使用 ls 命令來查找符號連結指向的目錄。這提供您與 --install-dir 參數一起使用的路徑。
  
  $ 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/v2/current/bin/aws
請使用以下命令來確認安裝。
```
$ aws --version
aws-cli/2.10.0 Python/3.11.2 Linux/4.14.133-113.105.amzn2.x86_64 botocore/2.4.5
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷 AWS CLI 錯誤中的故障診斷。

安裝和更新需求

我們支援在 Apple 支援的 64 位元 macOS 版本上的 AWS CLI。
由於 AWS 不維護第三方儲存庫，因此我們無法保證它們包含最新版本的 AWS CLI。

安裝或更新 AWS CLI

如果您要更新至最新版本，請使用您在目前版本中使用的相同安裝方法。您可以使用下列其中一種方式在 macOS 上安裝 AWS CLI。

GUI installer

以下步驟說明如何使用標準 macOS 使用者介面和瀏覽器來安裝最新版本的 AWS CLI。

在瀏覽器中下載 macOS pkg 檔案：https://awscli.amazonaws.com/AWSCLIV2.pkg
請依照畫面上的指示，執行您下載的檔案。您可以選擇以下列方式安裝 AWS CLI：
- 對於電腦上的所有使用者 (需要 sudo)
  - 您可以安裝到任何資料夾，或選擇建議的 /usr/local/aws-cli 的預設資料夾。
  - 安裝程式會自動在 /usr/local/bin/aws 建立符號連結，其連結至您所選擇的安裝資料夾中的主程式。
- 只對於目前的使用者 (不需要 sudo)
  - 您可以安裝到任何具有寫入權限的資料夾。
  - 由於標準的使用者許可，在安裝程式完成之後，您的 $PATH 必須在命令提示字元中使用下列命令，手動建立指向 aws 和 aws_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。
若要確認 Shell 可以在您的 aws 中尋找並執行 $PATH 命令，請使用下列命令。
```
$ which aws
/usr/local/bin/aws 
$ aws --version
aws-cli/2.10.0 Python/3.11.2 Darwin/18.7.0 botocore/2.4.5
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷 AWS CLI 錯誤中的故障診斷。

Command line installer - All users

如果您具有 sudo 許可，則可以為電腦上的所有使用者安裝 AWS CLI。我們提供一組易於複製和貼上的步驟。請參閱後續步驟中每一行的描述。


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

使用 curl 命令下載檔案。在此範例中，-o 選項會指定系統寫入下載套件的檔案名稱。在前述的範例中，檔案會寫入目前的資料夾中的 AWSCLIV2.pkg。
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
```
執行標準 macOS installer 程式，將下載的 .pkg 檔案指定為來源。使用 -pkg 參數可指定要安裝的套件名稱，以及磁碟機要安裝套件的 -target / 參數。檔案會安裝到 /usr/local/aws-cli，並且會在 /usr/local/bin 中自動建立符號連結。您必須在命令上包含 sudo，才能將寫入權限授予這些資料夾。
```
$ sudo installer -pkg ./AWSCLIV2.pkg -target /
```
安裝完成後，偵錯記錄檔會寫入 /var/log/install.log。
若要確認 Shell 可以在您的 aws 中尋找並執行 $PATH 命令，請使用下列命令。
```
$ which aws
/usr/local/bin/aws 
$ aws --version
aws-cli/2.10.0 Python/3.11.2 Darwin/18.7.0 botocore/2.4.5
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷 AWS CLI 錯誤中的故障診斷。

Command line - Current user

若要指定將 AWS CLI 安裝到哪個資料夾，您必須建立一個 XML 檔案 (任何檔案名稱均可)。這個檔案是 XML 格式化的檔案，看起來如下列範例。如圖所示保留所有值，但您必須將第 9 行中的路徑 /Users/myusername 替換為要安裝 AWS CLI 的資料夾路徑。資料夾必須已存在，否則命令會失敗。以下 XML 範例 (名為 choices.xml)，指定安裝程式在 /Users/myusername 資料夾中安裝 AWS CLI，其中建立了一個名為 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>
```
使用 curl 命令下載 pkg 安裝程式。在此範例中，-o 選項會指定系統寫入下載套件的檔案名稱。在前述的範例中，檔案會寫入目前的資料夾中的 AWSCLIV2.pkg。
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
```
現在您可以使用下列選項來執行標準 macOS installer 程式：
- 使用參數 -pkg 指定要安裝的套件的名稱。
- 若要指定僅限目前使用者的安裝，您必須設定參數 -target 為 CurrentUserHomeDirectory。
- 指定您在 -applyChoiceChangesXML 參數中建立的 XML 檔案的路徑 (相對於目前的資料夾) 和名稱。
下列範例會在資料夾 /Users/myusername/aws-cli 中安裝 AWS CLI。
```
$ installer -pkg AWSCLIV2.pkg \
            -target CurrentUserHomeDirectory \
            -applyChoiceChangesXML choices.xml
```
由於標準使用者許可通常不允許寫入 $PATH 中的資料夾，因此此模式下的安裝程式不會嘗試新增連至 aws 和 aws_completer 的符號連結。若要正確執行 AWS CLI，您必須在安裝程式完成後手動建立符號連結。如果您的 $PATH 包含可以寫入的資料夾，則如果將該資料夾指定為目標路徑，則可執行下列命令而無需 sudo。如果您的 $PATH 中沒有可寫入的資料夾，則必須使 sudo 以取得寫入指定目標資料夾的許可。符號連結的預設位置為 /usr/local/bin/。以您的 AWS CLI 安裝路徑替換 folder/installed。
```
$ 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。
若要確認 Shell 可以在您的 aws 中尋找並執行 $PATH 命令，請使用下列命令。
```
$ which aws
/usr/local/bin/aws 
$ aws --version
aws-cli/2.10.0 Python/3.11.2 Darwin/18.7.0 botocore/2.4.5
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷 AWS CLI 錯誤中的故障診斷。

安裝和更新需求

我們支援 64 位元 Windows 的 Microsoft 支援版本上的 AWS CLI。
安裝軟體的管理員權限

安裝或更新 AWS CLI

若要更新目前安裝在 Windows 上的 AWS CLI，請在每次更新時下載新安裝程式來覆寫舊版。AWS CLI 會定期更新。若要檢視最新版本發佈的時間，請參閱 GitHub 上的 AWS CLI 第 2 版變更日誌。

下載並執行適用於 Windows (64 位元) 的 AWS CLI MSI 安裝程式：

https://awscli.amazonaws.com/AWSCLIV2.msi

您也可以執行 msiexec 命令來執行 MSI 安裝程式。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi
```
如需可與 msiexec 一起使用的各種參數，請參閱 Microsoft Docs 網站上的 msiexec。例如，您可以使用 /qn 標記進行無訊息安裝。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi /qn
```
若要確認安裝，請開啟開始功能表、搜尋 cmd 以開啟命令提示字元視窗，然後在命令提示字元中使用 aws --version 命令。
```
C:\> aws --version
aws-cli/2.10.0 Python/3.11.2 Windows/10 exe/AMD64 prompt/off
```
如果 Windows 找不到程式，您可能需要關閉命令提示字元再重新開啟，以重新整理路徑，或遵循故障診斷 AWS CLI 錯誤中的故障診斷。

故障診斷 AWS CLI 安裝和解除安裝錯誤

如果在安裝或解除安裝 AWS CLI 時發生錯誤，請參閱故障診斷 AWS CLI 錯誤以瞭解故障診斷步驟。如需最相關的故障診斷步驟，請參閱命令未找到錯誤、「aws --version」命令傳回的版本與您安裝的版本不同和「aws --version」命令在解除安裝 AWS CLI 後傳回一個版本。

後續步驟

完成使用 AWS CLI 第 2 版的事前準備中的步驟並安裝 AWS CLI 後，則應執行設定 AWS CLI。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

先決條件

過去版本