安装或更新到最新版本的 AWS CLI - AWS Command Line Interface

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

安装或更新到最新版本的 AWS CLI

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

要安装过去版本的 AWS CLI,请参阅安装版本 2 的过去 AWS CLI 版本。有关卸载说明,请参阅卸载 AWS CLI 版本 2

重要

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

AWS CLI 安装和更新说明

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

安装和更新要求

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

  • 用 AWS CLI 途glibcgroff、和less。默认情况下,它们都包含在 Linux 的大多数主要发行版中。

  • 我们支持 CentOS、Fedora、Ubuntu、亚马逊 Linux 1、亚马逊 Linux 2、亚马逊 Linux 2023 和 Linux ARM 的最新发行版的 64 位版本。 AWS CLI

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

安装或更新 AWS CLI

警告

如果这是您首次在 Amazon Linux 上进行更新,则要安装最新版本的 AWS CLI,则必须使用以下命令卸载预安装的yum版本:

$ sudo yum remove awscli

删除yum安装后, AWS CLI 请按照以下 Linux 安装说明进行操作。

要更新当前安装的 AWS CLI,请在每次更新时下载一个新的安装程序以覆盖以前的版本。按照命令行中的以下步骤 AWS CLI 在 Linux 上安装。

以下是单个复制和粘贴组中的快速安装步骤,具体取决于您使用的是提供基本安装的 64 位 Linux 还是 Linux ARM。有关指导说明,请参阅随后的步骤。

Linux x86 (64-bit)
注意

(可选)以下命令块无需先验证下载内容的完整性即可下载和安装 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

$ 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
Linux ARM
注意

(可选)以下命令块无需先验证下载内容的完整性即可下载和安装 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. 通过以下方式之一下载安装文件:

    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 文件的完整性

    如果您.zip在上述步骤中选择手动下载 AWS CLI 安装程序包,则可以使用以下步骤使用该GnuPG工具来验证签名。

    AWS 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. 使用以下命令导入 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
    4. 下载您下载的软件包的 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

      如需查看版本列表,请参阅AWS CLI 版本 2 变更日志GitHub

      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

      如需查看版本列表,请参阅AWS CLI 版本 2 变更日志GitHub

    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 密钥(如果有的话)和 PGP 密钥之间没有信任链。 AWS CLI 有关更多信息,请参阅信任 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
    注意

    要更新当前安装的 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
  5. 通过以下命令确认此安装。

    $ aws --version aws-cli/2.15.19 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/2.4.5

    如果无法找到 aws 命令,您可能需要重新启动终端或按照排查 AWS CLI 错误中的说明排除故障。

安装和更新要求

  • 我们支持 mac AWS CLI OS 版本 10.9 及更高版本。如需了解更多信息,请参阅AWS 开发者工具博客上的 macOS AWS CLI v2 支持政策更新

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

安装或更新 AWS CLI

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

GUI installer

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

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

  2. 运行下载的文件,然后按照屏幕上的说明进行操作。您可以选择通过以下 AWS CLI 方式安装:

    • 针对电脑上的所有用户(需要 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

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

    $ which aws /usr/local/bin/aws $ aws --version aws-cli/2.15.19 Python/3.11.6 Darwin/23.3.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 /
引导式安装说明
  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.15.19 Python/3.11.6 Darwin/23.3.0 botocore/2.4.5

    如果无法找到 aws 命令,您可能需要重新启动终端或按照排查 AWS CLI 错误中的说明排除故障。

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

    $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
  3. 使用以下选项运行标准 macOS installer 程序:

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

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

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

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

    $ installer -pkg AWSCLIV2.pkg \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML choices.xml
  4. 由于标准用户权限通常不允许写入 $PATH 中的文件夹,因此在此模式下,安装程序不会尝试将符号链接添加到 awsaws_completer 程序中。 AWS CLI 要使正常运行,您必须在安装程序完成后手动创建符号链接。如果 $PATH 包含您可以写入的文件夹,并且您将该文件夹指定为目标的路径,则可以在不使用 sudo 的情况下运行以下命令。如果 $PATH 中没有可写入的文件夹,您必须使用 sudo,以获取写入指定目标文件夹的权限。符号链接的默认位置为 /usr/local/bin/。将 folder/installed 替换为您的 AWS 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.15.19 Python/3.11.6 Darwin/23.3.0 botocore/2.4.5

    如果无法找到 aws 命令,您可能需要重新启动终端或按照排查 AWS CLI 错误中的说明排除故障。

安装和更新要求

  • 我们支持微软支持 AWS CLI 的 64 位 Windows 版本。

  • 安装软件的管理员权限

安装或更新 AWS CLI

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

  1. 下载并运行适用于 Windows 的 AWS CLI MSI 安装程序(64 位):

    https://awscli.amazonaws.com/ AWSCLIV 2.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.15.19 Python/3.11.6 Windows/10 exe/AMD64 prompt/off

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

AWS CLI 安装和卸载错误疑难解答

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

后续步骤

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