安装或更新 Amazon CLI 的最新版本 - Amazon Command Line Interface
Amazon CLI 安装和更新说明Amazon CLI 安装和卸载错误故障排除后续步骤
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

安装或更新 Amazon CLI 的最新版本

本主题介绍如何在受支持的操作系统上安装或更新最新版本的 Amazon Command Line Interface (Amazon CLI)。有关 Amazon CLI 最新版本的信息，请参阅 GitHub 上的 Amazon CLI 版本 2 更改日志。

要安装 Amazon CLI 的过去发行版，请参阅安装 Amazon CLI 版本 2 的过去发行版。有关卸载说明，请参阅卸载 Amazon CLI 版本 2。

重要

Amazon CLI 版本 1 和 2 使用相同的 aws 命令名称。如果您之前安装了 Amazon CLI 版本 1，请参阅从 Amazon CLI 版本 1 迁移至版本 2。

Amazon CLI 安装和更新说明

有关安装说明，请展开适用于操作系统的部分。

安装和更新要求

  • 您必须能够提取或“解压缩”下载的程序包。如果您的操作系统没有内置的 unzip 命令，请使用等效命令。

  • Amazon CLI 使用 glibc、groff 和 less。默认情况下，它们都包含在 Linux 的大多数主要发行版中。

  • 我们在最近发行的 CentOS、Fedora、Ubuntu、Amazon Linux 1、Amazon Linux 2 和 Linux ARM 的 64 位版本上支持 Amazon CLI。

  • 由于 Amazon 不维护第三方存储库，因此我们不能保证它们包含最新版本的 Amazon CLI。

安装或更新 Amazon CLI

注意

如果这是您第一次在 Amazon Linux 上进行更新，要安装 Amazon CLI 的最新版本，必须使用以下命令卸载预安装的 yum 版本：

$ sudo yum remove awscli

删除 Amazon CLI 的 yum 安装之后，请按照下面的 Linux 安装说明进行操作。

要更新当前安装的 Amazon CLI，请在每次更新以覆盖以前版本时下载一个新的安装程序。请在 Linux 上从命令行执行以下步骤来安装 Amazon CLI。

我们根据您是使用 64 位 Linux 还是 Linux ARM，在一个易于复制和粘贴的组中提供步骤。请参阅以下步骤中每一行的描述。

Linux x86 (64-bit)
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
Linux ARM
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
注意

要更新 Amazon CLI 的当前安装，请添加现有的符号链接和安装程序信息，以使用 --update 参数构造 install 命令。

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

  1. 通过以下方式之一下载安装文件：

    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

  2. （可选）验证下载的 zip 文件的完整性

    如果已在上述步骤中选择手动下载 Amazon CLI 安装程序包 .zip，则可以通过以下步骤使用 GnuPG 工具验证签名。

    Amazon CLI 安装程序包 .zip 文件是使用 PGP 签名进行加密签名的。如果文件有任何损坏或更改，则此验证失败，您不应继续安装。

    1. 使用您的程序包管理器下载并安装 gpg 命令。有关 GnuPG 的更多信息，请参阅 GnuPG 网站。

    2. 要创建公有密钥文件，请创建一个文本文件并粘贴到以下文本中。

      -----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
ZMKcEgUJCSEf3QAKCRCmMQrMRnJHXCilD/4vior9J5tB+icri5WbDudS3ak/ve4q
XS6ZLm5S8l+CBxy5aLQUlyFhuaaEHDC11fG78OduxatzeHENASYVo3mmKNwrCBza
NJaeaWKLGQT0MKwBSP5aa3dva8P/4oUP9GsQn0uWoXwNDWfrMbNI8gn+jC/3MigW
vD3fu6zCOWWLITNv2SJoQlwILmb/uGfha68o4iTBOvcftVRuao6DyqF+CrHX/0j0
klEDQFMY9M4tsYT7X8NWfI8Vmc89nzpvL9fwda44WwpKIw1FBZP8S0sgDx2xDsxv
L8kM2GtOiH0cHqFO+V7xtTKZyloliDbJKhu80Kc+YC/TmozD8oeGU2rEFXfLegwS
zT9N+jB38+dqaP9pRDsi45iGqyA8yavVBabpL0IQ9jU6eIV+kmcjIjcun/Uo8SjJ
0xQAsm41rxPaKV6vJUn10wVNuhSkKk8mzNOlSZwu7Hua6rdcCaGeB8uJ44AP3QzW
BNnrjtoN6AlN0D2wFmfE/YL/rHPxU1XwPntubYB/t3rXFL7ENQOOQH0KVXgRCley
sHMglg46c+nQLRzVTshjDjmtzvh9rcV9RKRoPetEggzCoD89veDA9jPR2Kw6RYkS
XzYm2fEv16/HRNYt7hJzneFqRIjHW5qAgSs/bcaRWpAU/QQzzJPVKCQNr4y0weyg
B8HCtGjfod0p1A==
=gdMc
-----END PGP PUBLIC KEY BLOCK-----

      以下是公有密钥的详细信息以供参考。

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

    3. 使用以下命令导入 Amazon 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

    4. 下载您下载的程序包的 Amazon CLI 签名文件。它具有与其对应的 .zip 文件相同的路径和名称，但扩展名为 .sig。在以下示例中，我们将其作为名为 awscliv2.sig 的文件保存到当前目录中。

      Linux x86 (64-bit)

      对于最新版本的 Amazon CLI，请使用以下命令块：

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

      对于特定版本的 Amazon 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 上的 Amazon CLI 版本 2 更改日志。

      Linux ARM

      对于最新版本的 Amazon CLI，请使用以下命令块：

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

      对于特定版本的 Amazon 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 上的 Amazon CLI 版本 2 更改日志。

    5. 验证签名，并将下载的 .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 密钥（如果您有）和 Amazon CLI PGP 密钥之间没有信任链。有关更多信息，请参阅信任 Web。

    显示更多显示更少

  3. 解压缩安装程序。如果您的 Linux 发行版没有的内置 unzip 命令，请使用等效的命令对其解压缩。以下示例命令解压缩程序包并在当前目录下创建一个名为 aws 的目录。

    $ unzip awscliv2.zip
    注意

    从以前的版本进行更新时，unzip 命令会提示覆盖现有文件。要跳过这些提示，例如使用脚本自动化，请为 unzip 使用 -u 更新。此标志会自动更新现有文件并根据需要创建新文件。

    $ unzip -u awscliv2.zip

  4. 运行安装程序。安装命令在新解压缩的 install 目录中使用一个名为 aws 的文件。默认情况下，文件全部安装到 /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
    注意

    要更新 Amazon 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

  5. 通过以下命令确认此安装。

    $ 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 命令，您可能需要重新启动终端或按照排查 Amazon CLI 错误中的说明排除故障。

安装和更新要求

  • 我们在 Apple 支持的 64 位 macOS 版本上支持 Amazon CLI。

  • 由于 Amazon 不维护第三方存储库，因此我们不能保证它们包含最新版本的 Amazon CLI。

安装或更新 Amazon CLI

如果要更新到最新版本，请使用与当前版本相同的安装方法。您可以通过下列方式之一在 macOS 上安装 Amazon CLI。

GUI installer

以下步骤演示如何使用标准 macOS 用户界面和浏览器安装 Amazon CLI 的最新版本。

  1. 在浏览器中，下载 macOS pkg 文件：https://awscli.amazonaws.com/AWSCLIV2.pkg

  2. 运行下载的文件，然后按照屏幕上的说明进行操作。您可以选择通过以下方式安装 Amazon 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。

  3. 要验证 Shell 是否可以在 $PATH 中找到并运行 aws 命令，请使用以下命令。

    $ 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 命令，您可能需要重新启动终端或按照排查 Amazon CLI 错误中的说明排除故障。

Command line installer - All users

如果您拥有 sudo 权限，则可以针对电脑上的所有用户安装 Amazon 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"

  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. 要验证 Shell 是否可以在 $PATH 中找到并运行 aws 命令，请使用以下命令。

    $ 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 命令，您可能需要重新启动终端或按照排查 Amazon CLI 错误中的说明排除故障。

Command line - Current user

  1. 要指定将 Amazon CLI 安装到哪个文件夹，必须使用任意文件名创建 XML 文件。此文件是 XML 格式的文件，类似于以下示例。保持所显示的所有值不变，但必须将第 9 行中的 /Users/myusername 路径替换为您要在其中安装 Amazon CLI 的文件夹的路径。必须存在该文件夹，否则命令会失败。以下名为 choices.xml 的 XML 示例指定安装程序将 Amazon 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. 使用 curl 命令下载 pkg 安装程序。-o 选项指定下载的程序包应写入的文件名。在此示例中，文件写入当前文件夹中的 AWSCLIV2.pkg。

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

  3. 使用以下选项运行标准 macOS installer 程序：

    • 使用 -pkg 参数指定要安装的程序包的名称。

    • 通过将 -target 参数设置为 CurrentUserHomeDirectory，指定仅安装到当前用户。

    • 在 -applyChoiceChangesXML 参数中指定您创建的 XML 文件的路径（相对于当前文件夹）和名称。

    以下示例在文件夹 Amazon CLI 中安装 /Users/myusername/aws-cli。

    $ installer -pkg AWSCLIV2.pkg \
            -target CurrentUserHomeDirectory \
            -applyChoiceChangesXML choices.xml

  4. 由于标准用户权限通常不允许写入 $PATH 中的文件夹，因此在此模式下，安装程序不会尝试将符号链接添加到 aws 和 aws_completer 程序中。要使 Amazon CLI 正确运行，必须在安装程序完成后手动创建符号链接。如果 $PATH 包含您可以写入的文件夹，并且您将该文件夹指定为目标的路径，则可以在不使用 sudo 的情况下运行以下命令。如果 $PATH 中没有可写入的文件夹，您必须使用 sudo，以获取写入指定目标文件夹的权限。符号链接的默认位置为 /usr/local/bin/。将 folder/installed 替换为您的 Amazon CLI 安装的路径。

    $ 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。

  5. 要验证 Shell 是否可以在 $PATH 中找到并运行 aws 命令，请使用以下命令。

    $ 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 命令，您可能需要重新启动终端或按照排查 Amazon CLI 错误中的说明排除故障。

安装和更新要求

  • 我们在 Microsoft 支持的 64 位 Windows 版本上支持 Amazon CLI。

  • 安装软件的管理员权限

安装或更新 Amazon CLI

要在 Windows 上更新当前安装的 Amazon CLI，请在每次更新以覆盖以前版本时下载一个新的安装程序。Amazon CLI 会定期更新。要查看最新版本的发布时间，请参阅 GitHub 上的 Amazon CLI 版本 2 更改日志。

  1. 下载并运行适用于 Windows（64 位）的 Amazon 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

  2. 要确认安装，请打开 Start（开始）菜单，搜索 cmd 以打开命令提示符窗口，然后在命令提示符处使用 aws --version 命令。

    C:\> aws --version
aws-cli/2.10.0 Python/3.11.2 Windows/10 exe/AMD64 prompt/off

    如果 Windows 无法找到该程序，您可能需要关闭并重新打开命令提示符窗口以刷新该路径，按照排查 Amazon CLI 错误中的说明排除故障。

Amazon CLI 安装和卸载错误故障排除

如果您在安装或卸载 Amazon CLI 后遇到问题，请参阅排查 Amazon CLI 错误以了解故障排除步骤。有关相关性最高的故障排除步骤，请参阅找不到命令错误、“aws --version”命令返回的版本与您安装的版本不同和卸载 Amazon CLI 后，“aws --version”命令返回一个版本。

后续步骤

成功安装 Amazon CLI 后，可以安全地删除您下载的安装程序文件。完成使用 Amazon CLI 版本 2 的先决条件中的步骤并安装 Amazon CLI 之后，您应执行设置 Amazon CLI。