安装或更新最新版本的 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 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
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4WIQT7
Xbd/1cEYuAURraimMQrMRnJHXAUCXYKvtQIbAwUJB4TOAAULCQgHAgYVCgkICwIE
FgIDAQIeAQIXgAAKCRCmMQrMRnJHXJIXEAChLUIkg80uPUkGjE3jejvQSA1aWuAM
yzy6fdpdlRUz6M6nmsUhOExjVIvibEJpzK5mhuSZ4lb0vJ2ZUPgCv4zs2nBd7BGJ
MxKiWgBReGvTdqZ0SzyYH4PYCJSE732x/Fw9hfnh1dMTXNcrQXzwOmmFNNegG0Ox
au+VnpcR5Kz3smiTrIwZbRudo1ijhCYPQ7t5CMp9kjC6bObvy1hSIg2xNbMAN/Do
ikebAl36uA6Y/Uczjj3GxZW4ZWeFirMidKbtqvUz2y0UFszobjiBSqZZHCreC34B
hw9bFNpuWC/0SrXgohdsc6vK50pDGdV5kM2qo9tMQ/izsAwTh/d/GzZv8H4lV9eO
tEis+EpR497PaxKKh9tJf0N6Q1YLRHof5xePZtOIlS3gfvsH5hXA3HJ9yIxb8T0H
QYmVr3aIUes20i6meI3fuV36VFupwfrTKaL7VXnsrK2fq5cRvyJLNzXucg0WAjPF
RrAGLzY7nP1xeg1a0aeP+pdsqjqlPJom8OCWc1+6DWbg0jsC74WoesAqgBItODMB
rsal1y/q+bPzpsnWjzHV8+1/EtZmSc8ZUGSJOPkfC7hObnfkl18h+1QtKTjZme4d
H17gsBJr+opwJw/Zio2LMjQBOqlm3K1A4zFTh7wBC7He6KPQea1p2XAMgtvATtNe
YLZATHZKTJyiqA==
=vYOk
-----END PGP PUBLIC KEY BLOCK-----

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

      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

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

    $ 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 版本 2 的先决条件中的步骤并安装 Amazon CLI 之后，您应执行快速设置。