本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 安裝或更新至最新版本的 AWS CLI 本主題說明如何在支援的作業系統上安裝或更新最新版本的 AWS Command Line Interface (AWS CLI)。如需最新版本 的資訊 AWS CLI，請參閱 GitHub 上的[AWS CLI 第 2 版變更日誌](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)。 若要安裝過去版本的 AWS CLI，請參閱 [安裝 AWS CLI 第 2 版的過去版本](getting-started-version.md)。如需解除安裝說明，請參閱 [解除安裝第 2 AWS CLI 版](uninstall.md)。 **重要** AWS CLI 第 1 版和第 2 版使用相同的`aws`命令名稱。如果您先前已安裝 AWS CLI 版本 1，請參閱 [第 2 AWS CLI 版的遷移指南](cliv2-migration.md)。 **Topics** + [ ## AWS CLI 安裝和更新指示 ](#getting-started-install-instructions) + [ ## 針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷 ](#install-tshoot) + [ ## 後續步驟 ](#install-next-steps) ## AWS CLI 安裝和更新指示 如需安裝說明，請根據您的作業系統展開相應的區段。 ### Linux #### 安裝和更新需求 + 您必須能夠解壓縮或「解壓縮」下載的套件。如果您的作業系統沒有內建 `unzip` 命令，請使用對等的命令。 + AWS CLI 使用 `glibc`、 `groff`和 `less`。依預設，這些會包含在 Linux 的大多數主要發行版中。 + 我們支援 AWS CLI 64 位元版本的最新 CentOS、Fedora、Ubuntu、Amazon Linux 1、Amazon Linux 2、Amazon Linux 2023 和 Linux ARM 發行版本。 + 由於 AWS 不會維護 以外的第三方儲存庫`snap`，因此我們無法保證它們包含最新版本的 AWS CLI。 #### 安裝或更新 AWS CLI **警告** 如果這是您第一次在 Amazon Linux 上更新 ，若要安裝最新版本的 AWS CLI，您必須使用以下命令解除安裝預先安裝的`yum`版本： ``` $ sudo yum remove awscli ``` AWS CLI 移除 `yum` 安裝 之後，請依照下列 Linux 安裝指示進行。 您可以使用下列 AWS CLI 其中一種方法來安裝 ： + **命令列安裝程式**是版本控制的好選擇，因為您可以指定要安裝的版本。此選項不會自動更新，而且您每次更新時都必須下載新的安裝程式，以覆寫先前的版本。 + **正式支援的`snap`套件**是讓 一律擁有最新版本的良好選項， AWS CLI 因為快照套件會自動重新整理。不支援選取 的次要版本 AWS CLI ，因此，如果您的團隊需要鎖定版本，則不是最佳安裝方法。 ------ #### [ Command line installer - Linux x86 (64-bit) ] 若要更新目前安裝的 AWS CLI，請在每次更新時下載新的安裝程式以覆寫先前的版本。請依照命令列中的下列步驟，在 Linux AWS CLI 上安裝 。 以下是單一複製和貼上群組的快速安裝步驟，提供基本安裝。如需引導式指示，請參閱下列步驟。 **注意** **（選用）** 下列命令區塊會下載並安裝 ， AWS CLI 而無需先驗證下載的完整性。若要驗證下載的完整性，請使用以下逐步說明。 **若要安裝** AWS CLI，請執行以下命令。 ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install ``` **若要更新** AWS CLI目前的安裝，新增現有的符號連結和安裝程式資訊,以使用 `--bin-dir`、`--install-dir` 和 `--update` 參數建構 `install` 命令。下列命令區塊使用 */usr/local/bin* 的範例系統連結，以及 */usr/local/aws-cli* 的範例安裝程式位置，為目前使用者本機安裝 AWS CLI 。 ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update ``` **引導式安裝步驟** 1. 使用下列其中一種方式下載安裝檔案： + **使用 `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](https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip) 1. **(可選) 驗證所下載 zip 檔案的完整性** 如果您選擇`.zip`在上述步驟中手動下載 AWS CLI 安裝程式套件，則可以使用 `GnuPG`工具，使用下列步驟來驗證簽章。 AWS CLI 安裝程式套件`.zip`檔案使用 PGP 簽章進行密碼編譯簽署。如果檔案有任何損壞或更改，此驗證會失敗，且您不應該繼續進行安裝。 1. 使用您的套件管理工具下載並安裝 `gpg` 命令。如需有關 `GnuPG` 的詳細資訊，請參閱 [GnuPG 網站](https://www.gnupg.org/)。 1. 若要建立公開金鑰檔案，請建立文字檔案，然後貼上下列文字。 ``` -----BEGIN PGP PUBLIC KEY BLOCK----- mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG 94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6 0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+ DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+ j+c7Kg92pDx2uQ== =OBAt -----END PGP PUBLIC KEY BLOCK----- ``` 以下公開金鑰詳細資訊僅供參考。 ``` Key ID: A6310ACC4672475C Type: RSA Size: 4096/4096 Created: 2019-09-18 Expires: 2026-07-07 User ID: AWS CLI Team Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C ``` 1. 使用下列命令匯入 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 " imported gpg: Total number processed: 1 gpg: imported: 1 ``` 1. 下載您下載之套件的 AWS CLI 簽章檔案。它會有與其對應的 `.zip` 檔案具有相同的路徑和名稱，但具有副檔名 `.sig`。在下列範例中，我們將它作為名稱 `awscliv2.sig` 的檔案儲存在目前的資料夾。 **對於最新版本的 AWS CLI，**請使用下列命令區塊： ``` $ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig ``` 1. 驗證簽章，並將下載的 `.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 " [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 金鑰之間沒有信任鏈。如需詳細資訊，請參閱「[信任網路](https://en.wikipedia.org/wiki/Web_of_trust)」。 1. 解壓縮安裝程式。如果您的 Linux 發行版沒有內建 `unzip` 命令，請使用類似命令解壓縮。下列範例命令會解壓縮套件，並在名為 `aws` 的目前目錄下建立目錄。 ``` $ unzip awscliv2.zip ``` **注意** 從舊版更新時，`unzip` 命令會提示覆寫現有檔案。若要略過這些提示 (例如使用指令碼自動化)，對於 `unzip` 請使用 `-u` 更新標記。這個標記會視需要自動更新現有檔案和建立新檔案。 ``` $ unzip -u awscliv2.zip ``` 1. 執行安裝程式。安裝命令會使用新解壓縮的 `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 ``` 若要找到現有的符號連結和安裝目錄，請執行以下步驟： 使用 `which` 命令來查找您的符號連結。這提供您與 `--bin-dir` 參數一起使用的路徑。 ``` $ which aws /usr/local/bin/aws ``` 使用 `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 ``` 1. 請使用以下命令來確認安裝。 ``` $ aws --version aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 ``` 如果找不到 `aws` 命令，您可能需要重新啟動終端機或遵循 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md) 中的故障診斷。 ------ #### [ Command line - Linux ARM ] 若要更新目前安裝的 AWS CLI，請在每次更新時下載新的安裝程式以覆寫先前的版本。請依照命令列中的下列步驟，在 Linux AWS CLI 上安裝 。 以下是單一複製和貼上群組的快速安裝步驟，提供基本安裝。如需引導式指示，請參閱下列步驟。 **注意** **（選用）** 下列命令區塊會下載並安裝 ， AWS CLI 而無需先驗證下載的完整性。若要驗證下載的完整性，請使用以下逐步說明。 **若要安裝** AWS CLI，請執行下列命令。 ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install ``` **若要更新** AWS CLI目前的安裝，新增現有的符號連結和安裝程式資訊,以使用 `--bin-dir`、`--install-dir` 和 `--update` 參數建構 `install` 命令。下列命令區塊使用 */usr/local/bin* 的範例符號連結，以及 */usr/local/aws-cli* 的範例安裝程式位置。 ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update ``` **引導式安裝步驟** 1. 使用下列其中一種方式下載安裝檔案： + **使用 `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](https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip) 1. **(可選) 驗證所下載 zip 檔案的完整性** 如果您選擇`.zip`在上述步驟中手動下載 AWS CLI 安裝程式套件，則可以使用 `GnuPG`工具，使用下列步驟來驗證簽章。 AWS CLI 安裝程式套件`.zip`檔案使用 PGP 簽章進行密碼編譯簽署。如果檔案有任何損壞或更改，此驗證會失敗，且您不應該繼續進行安裝。 1. 使用您的套件管理工具下載並安裝 `gpg` 命令。如需有關 `GnuPG` 的詳細資訊，請參閱 [GnuPG 網站](https://www.gnupg.org/)。 1. 若要建立公開金鑰檔案，請建立文字檔案，然後貼上下列文字。 ``` -----BEGIN PGP PUBLIC KEY BLOCK----- mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG 94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6 0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+ DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+ j+c7Kg92pDx2uQ== =OBAt -----END PGP PUBLIC KEY BLOCK----- ``` 以下公開金鑰詳細資訊僅供參考。 ``` Key ID: A6310ACC4672475C Type: RSA Size: 4096/4096 Created: 2019-09-18 Expires: 2026-07-07 User ID: AWS CLI Team Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C ``` 1. 使用下列命令匯入 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 " imported gpg: Total number processed: 1 gpg: imported: 1 ``` 1. 下載您下載之套件的 AWS CLI 簽章檔案。它會有與其對應的 `.zip` 檔案具有相同的路徑和名稱，但具有副檔名 `.sig`。在下列範例中，我們將它作為名稱 `awscliv2.sig` 的檔案儲存在目前的資料夾。 **對於最新版本的 AWS CLI，**請使用下列命令區塊： ``` $ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip.sig ``` 1. 驗證簽章，並將下載的 `.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 " [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 金鑰之間沒有信任鏈。如需詳細資訊，請參閱「[信任網路](https://en.wikipedia.org/wiki/Web_of_trust)」。 1. 解壓縮安裝程式。如果您的 Linux 發行版沒有內建 `unzip` 命令，請使用類似命令解壓縮。下列範例命令會解壓縮套件，並在名為 `aws` 的目前目錄下建立目錄。 ``` $ unzip awscliv2.zip ``` **注意** 從舊版更新時，`unzip` 命令會提示覆寫現有檔案。若要略過這些提示 (例如使用指令碼自動化)，對於 `unzip` 請使用 `-u` 更新標記。這個標記會視需要自動更新現有檔案和建立新檔案。 ``` $ unzip -u awscliv2.zip ``` 1. 執行安裝程式。安裝命令會使用新解壓縮的 `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 ``` 若要找到現有的符號連結和安裝目錄，請執行以下步驟： 使用 `which` 命令來查找您的符號連結。這提供您與 `--bin-dir` 參數一起使用的路徑。 ``` $ which aws /usr/local/bin/aws ``` 使用 `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 ``` 1. 請使用以下命令來確認安裝。 ``` $ aws --version aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 ``` 如果找不到 `aws` 命令，您可能需要重新啟動終端機或遵循 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md) 中的故障診斷。 ------ #### [ Snap package ] 我們在 AWS CLI 上提供官方 AWS 支援的 版本`snap`。如果您想要在您的系統上一律 AWS CLI 安裝最新版本的 ，則 Snap 套件會在自動更新時為您提供此功能。不支援選取 的次要版本 AWS CLI ，因此如果您的團隊需要鎖定版本，則它不是最佳安裝方法。如果您想要安裝特定次要版本的 AWS CLI，建議您使用命令列安裝程式。 1. 如果您的 Linux 平台尚未安裝 `snap`，請在您的平台上安裝 `snap`。 1. 如需安裝 `snap` 的資訊，請參閱 *Snap 文件*中的[安裝常駐程式](https://snapcraft.io/docs/installing-snapd)。 1. 您可能需要重新啟動系統，才能正確更新 `PATH` 變數。如果您有安裝問題，請遵循 *Snap 文件*中[修正常見問題](https://snapcraft.io/docs/fix-common-issues)的步驟。 1. 若要確認 `snap` 已正確安裝，請執行下列命令。 ``` $ snap version ``` 1. 針對 AWS CLI執行下列 `snap install` 命令。 ``` $ snap install aws-cli --classic ``` 根據您的許可，您可能需要將 `sudo` 新增至命令。 ``` $ sudo snap install aws-cli --classic ``` **注意** 若要檢視 的 Snap 儲存庫 AWS CLI，包括其他`snap`指示，請參閱 *Canonical Snapcraft 網站上的 *[https://snapcraft.io/aws-cli](https://snapcraft.io/aws-cli)頁面。 1. 確認 已正確 AWS CLI 安裝。 ``` $ aws --version aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 ``` 如果發生錯誤，請參閱 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md)。 ------ ### macOS #### 安裝和更新需求 + 我們在 macOS 第 11 版及更新版本 AWS CLI 上支援 。如需詳細資訊，請參閱*AWS 開發人員工具部落格*上的 [AWS CLI v2 的 macOS 支援政策更新](https://aws.amazon.com/blogs/developer/macos-support-policy-updates-for-the-aws-cli-v2/)。 + 由於 AWS 不會維護第三方儲存庫，因此我們無法保證它們包含最新版本的 AWS CLI。 **macOS 版本支援矩陣** | AWS CLI 版本 | 支援的 macOS 版本 | | --- | --- | | 2.21.0 – 目前版本 | 11\$1 | | 2.17.0 –2.20.0 | 10.15\$1 | | 2.0.0 – 2.16.12 | 10.14 及以下版本 | #### 安裝或更新 AWS CLI 如果您要更新至最新版本，請使用您在目前版本中使用的相同安裝方法。您可以透過下列方式在 macOS AWS CLI 上安裝 。 ------ #### [ GUI installer ] 下列步驟說明如何 AWS CLI 使用標準 macOS 使用者介面和瀏覽器安裝最新版本的 。 1. 在瀏覽器中下載 macOS `pkg` 檔案：[https://awscli.amazonaws.com/AWSCLIV2.pkg](https://awscli.amazonaws.com/AWSCLIV2.pkg) 1. 請依照畫面上的指示，執行您下載的檔案。您可以選擇 AWS CLI 以下列方式安裝 ： + **對於電腦上的所有使用者 (需要 `sudo`)** + 您可以安裝到任何資料夾，或選擇建議的 `/usr/local/aws-cli` 的預設資料夾。 + 安裝程式會自動在 `/usr/local/bin/aws` 建立符號連結，其連結至您所選擇的安裝資料夾中的主程式。 + **只對於目前的使用者 (不需要 `sudo`)** + 您可以安裝到任何具有寫入權限的資料夾。 + 由於標準的使用者許可，在安裝程式完成之後，您的 `$PATH` 必須在命令提示字元中使用下列命令，手動建立指向 `aws` 和 `aws_completer` 程式的符號連結檔案。符號連結的預設位置為 `/usr/local/bin/`。 ``` $ ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws $ ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer ``` 如果您沒有資料夾的寫入許可，您可能需要在命令中使用 `sudo`。下列範例在 `/usr/local/bin/` 中搭配使用 `sudo` 和符號連結的預設位置： ``` $ 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\$1L** 來檢視安裝的偵錯日誌。這會開啟一個日誌窗格，使您能夠篩選和儲存日誌。日誌檔也會自動儲存到 `/var/log/install.log`。 1. 若要確認 Shell 可以在您的 `aws` 中尋找並執行 `$PATH` 命令，請使用下列命令。 ``` $ which aws /usr/local/bin/aws $ aws --version aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0 ``` 如果找不到 `aws` 命令，您可能需要重新啟動終端機或遵循 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md) 中的故障診斷。 ------ #### [ Command line installer - All users ] 如果您具有 `sudo` 許可，則可以為電腦上的所有使用者安裝 AWS CLI 。我們提供一組易於複製和貼上的步驟。請參閱後續步驟中每一行的描述。 ``` $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" $ sudo installer -pkg AWSCLIV2.pkg -target / ``` **引導式安裝說明** 1. 使用 `curl` 命令下載檔案。在此範例中，`-o` 選項會指定系統寫入下載套件的檔案名稱。在前述的範例中，檔案會寫入目前的資料夾中的 `AWSCLIV2.pkg`。 ``` $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" ``` 1. 執行標準 macOS `installer` 程式，將下載的 `.pkg` 檔案指定為來源。使用 `-pkg` 參數可指定要安裝的套件名稱，以及磁碟機要安裝套件的 `-target /` 參數。檔案會安裝到 `/usr/local/aws-cli`，並且會在 `/usr/local/bin` 中自動建立符號連結。您必須在命令上包含 `sudo`，才能將寫入權限授予這些資料夾。 ``` $ sudo installer -pkg ./AWSCLIV2.pkg -target / ``` 安裝完成後，偵錯記錄檔會寫入 `/var/log/install.log`。 1. 若要確認 Shell 可以在您的 `aws` 中尋找並執行 `$PATH` 命令，請使用下列命令。 ``` $ which aws /usr/local/bin/aws $ aws --version aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0 ``` 如果找不到 `aws` 命令，您可能需要重新啟動終端機或遵循 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md) 中的故障診斷。 ------ #### [ Command line - Current user ] 1. 若要指定要安裝 AWS CLI 的資料夾，您必須建立具有任何檔案名稱的 XML 檔案。這個檔案是 XML 格式化的檔案，看起來如下列範例。如圖所示保留所有值，但您必須將第 9 行中的路徑 */Users/myusername* 替換為要安裝 AWS CLI 的資料夾路徑。*資料夾必須已存在，否則命令會失敗。*下列 XML 範例名為 *choices.xml*，指定安裝程式在資料夾 AWS CLI 中安裝 `/Users/myusername`，並在其中建立名為 的資料夾`aws-cli`。 ``` choiceAttribute customLocation attributeSetting /Users/myusername choiceIdentifier default ``` 1. 使用 `curl` 命令下載 `pkg` 安裝程式。在此範例中，`-o` 選項會指定系統寫入下載套件的檔案名稱。在前述的範例中，檔案會寫入目前的資料夾中的 `AWSCLIV2.pkg`。 ``` $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" ``` 1. 現在您可以使用下列選項來執行標準 macOS `installer` 程式： + 使用參數 `-pkg` 指定要安裝的套件的名稱。 + 若要指定*僅限目前使用者*的安裝，您必須設定參數 `-target` 為 `CurrentUserHomeDirectory`。 + 指定您在 `-applyChoiceChangesXML` 參數中建立的 XML 檔案的路徑 (相對於目前的資料夾) 和名稱。 下列範例會在 資料夾 AWS CLI 中安裝 `/Users/myusername/aws-cli`。 ``` $ installer -pkg AWSCLIV2.pkg \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML choices.xml ``` 1. 由於標準使用者許可通常不允許寫入 `$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`。 1. 若要確認 Shell 可以在您的 `aws` 中尋找並執行 `$PATH` 命令，請使用下列命令。 ``` $ which aws /usr/local/bin/aws $ aws --version aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0 ``` 如果找不到 `aws` 命令，您可能需要重新啟動終端機或遵循 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md) 中的故障診斷。 ------ ### Windows #### 安裝和更新需求 + 我們在 Microsoft 支援的 64 位元 Windows 版本 AWS CLI 上支援 。 + 安裝軟體的管理員權限 #### 安裝或更新 AWS CLI 若要更新目前在 Windows AWS CLI 上安裝的 ，請在每次更新時下載新的安裝程式以覆寫先前的版本。 AWS CLI 會定期更新。若要檢視最新版本發佈的時間，請參閱 *GitHub* 上的 [AWS CLI 第 2 版變更日誌](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)。 1. 下載並執行適用於 Windows 的 AWS CLI MSI 安裝程式 (64 位元）： [https://awscli.amazonaws.com/AWSCLIV2.msi](https://awscli.amazonaws.com/AWSCLIV2.msi) 您也可以執行 `msiexec` 命令來執行 MSI 安裝程式。 ``` C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi ``` 如需可與 `msiexec` 一起使用的各種參數，請參閱 *Microsoft Docs* 網站上的 [msiexec](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec)。例如，您可以使用 `/qn` 標記進行無訊息安裝。 ``` C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi /qn ``` 1. 若要確認安裝，請開啟**開始**功能表、搜尋 `cmd` 以開啟命令提示字元視窗，然後在命令提示字元中使用 `aws --version` 命令。 ``` C:\> aws --version aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off ``` 如果 Windows 找不到程式，您可能需要關閉命令提示字元再重新開啟，以重新整理路徑，或遵循 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md) 中的故障診斷。 ## 針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷 如果您在安裝或解除安裝 之後遇到問題 AWS CLI，請參閱 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md) 以取得故障診斷步驟。如需最相關的故障診斷步驟，請參閱 [命令未找到錯誤](cli-chap-troubleshooting.md#tshoot-install-not-found)、[「`aws --version`」命令傳回的版本與您安裝的版本不同](cli-chap-troubleshooting.md#tshoot-install-wrong-version) 和 [解除安裝 後，「`aws --version`」命令會傳回版本 AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1)。 ## 後續步驟 成功安裝 後 AWS CLI，您可以安全地刪除下載的安裝程式檔案。完成 中的步驟[使用第 2 AWS CLI 版的先決條件](getting-started-prereqs.md)並安裝 後 AWS CLI，您應該執行 [設定 AWS CLI](getting-started-quickstart.md)。