本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
安装或更新到最新版本的 Amazon CLI
本主题介绍如何在支持的操作系统上安装或更新最新版本的 Amazon Command Line Interface (Amazon CLI)。有关最新版本的信息 Amazon CLI,请参阅Amazon CLI 版本 2 的变更日 GitHub志
要安装过去版本的 Amazon CLI,请参阅正在安装版本 2 的过去 Amazon CLI 版本。有关卸载说明,请参阅卸载 Amazon CLI 版本 2。
重要
Amazon CLI 版本 1 和 2 使用相同的aws
命令名称。如果您之前安装了 Amazon CLI 版本 1,请参阅从 Amazon CLI 版本 1 迁移到 Amazon CLI 版本 2。
Amazon CLI 安装和更新说明
有关安装说明,请展开适用于操作系统的部分。
安装和更新要求
-
您必须能够提取或“解压缩”下载的程序包。如果您的操作系统没有内置的
unzip
命令,请使用等效命令。 -
用 Amazon CLI 途
glibc
groff
、和less
。默认情况下,它们都包含在 Linux 的大多数主要发行版中。 -
我们支持 CentOS、Fedora、Ubuntu、亚马逊 Linux 1、亚马逊 Linux 2、亚马逊 Linux 2023 和 Linux 的最新发行版的 64 位版本。 Amazon CLI ARM
-
由于除此之外 Amazon 不维护第三方存储库
snap
,因此我们无法保证它们包含最新版本的 Amazon CLI。
安装或更新 Amazon CLI
警告
如果这是您首次在 Amazon Linux 上进行更新,则要安装最新版本的 Amazon CLI,则必须使用以下命令卸载预安装的yum
版本:
$
sudo yum remove awscli
删除yum
安装后, Amazon CLI 请按照以下 Linux 安装说明进行操作。
您可以使用以下 Amazon CLI 方法之一进行安装:
-
命令行安装程序是版本控制的好选择,因为你可以指定要安装的版本。此选项不会自动更新,每次更新时都必须下载新的安装程序才能覆盖以前的版本。
-
官方支持的
snap
软件包是一个不错的选择,可以让最新版本的 as sn Amazon CLI ap 软件包自动刷新。没有内置支持选择的次要版本,因此 Amazon CLI ,如果您的团队需要固定版本,则这不是最佳的安装方法。
- Command line installer - Linux x86 (64-bit)
-
要更新当前安装的 Amazon CLI,请在每次更新时下载一个新的安装程序以覆盖以前的版本。按照命令行中的以下步骤 Amazon CLI 在 Linux 上安装。
以下是提供基本安装的单个复制和粘贴组中的快速安装步骤。有关指导说明,请参阅随后的步骤。
注意
(可选)以下命令块 Amazon CLI 无需先验证下载内容的完整性即可下载和安装。要验证下载内容的完整性,请使用以下分步说明。
要安装 Amazon CLI,请运行以下命令。
$
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install
要更新 Amazon 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指导安装步骤
-
通过以下方式之一下载安装文件:
-
使用
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
-
-
(可选)验证下载的 zip 文件的完整性
如果您
.zip
在上述步骤中选择手动下载 Amazon CLI 安装程序包,则可以使用以下步骤使用该GnuPG
工具来验证签名。Amazon CLI 安装程序包
.zip
文件使用签PGP名进行加密签名。如果文件有任何损坏或更改,则此验证失败,您不应继续安装。-
使用您的程序包管理器下载并安装
gpg
命令。有关GnuPG
的更多信息,请参阅 GnuPG 网站。 -
要创建公有密钥文件,请创建一个文本文件并粘贴到以下文本中。
-----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 ZqFYbwUJCv/cOgAKCRCmMQrMRnJHXKYuEAC+wtZ611qQtOl0t5spM9SWZuszbcyA 0xBAJq2pncnp6wdCOkuAPu4/R3UCIoD2C49MkLj9Y0Yvue8CCF6OIJ8L+fKBv2DI yWZGmHL0p9wa/X8NCKQrKxK1gq5PuCzi3f3SqwfbZuZGeK/ubnmtttWXpUtuU/Iz VR0u/0sAy3j4uTGKh2cX7XnZbSqgJhUk9H324mIJiSwzvw1Ker6xtH/LwdBeJCck bVBdh3LZis4zuD4IZeBO1vRvjot3Oq4xadUv5RSPATg7T1kivrtLCnwvqc6L4LnF 0OkNysk94L3LQSHyQW2kQS1cVwr+yGUSiSp+VvMbAobAapmMJWP6e/dKyAUGIX6+ 2waLdbBs2U7MXznx/2ayCLPH7qCY9cenbdj5JhG9ibVvFWqqhSo22B/URQE/CMrG +3xXwtHEBoMyWEATr1tWwn2yyQGbkUGANneSDFiTFeoQvKNyyCFTFO1F2XKCcuDs 19nj34PE2TJilTG2QRlMr4D0NgwLLAMg2Los1CK6nXWnImYHKuaKS9LVaCoC8vu7 IRBik1NX6SjrQnftk0M9dY+s0ZbAN1gbdjZ8H3qlbl/4TxMdr87m8LP4FZIIo261 Eycv34pVkCePZiP+dgamEiQJ7IL4ZArio9mv6HbDGV6mLY45+l6/0EzCwkI5IyIf BfWC9s/USgxchg== =ptgS -----END PGP PUBLIC KEY BLOCK-----
以下是公有密钥的详细信息以供参考。
Key ID: A6310ACC4672475C Type: RSA Size: 4096/4096 Created: 2019-09-18 Expires: 2025-07-24 User ID: AWS CLI Team <aws-cli@amazon.com> Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
-
使用以下命令导入 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 -
下载您下载的软件包的 Amazon CLI 签名文件。它具有与其对应的
.zip
文件相同的路径和名称,但扩展名为.sig
。在以下示例中,我们将其作为名为awscliv2.sig
的文件保存到当前目录中。要获取最新版本的 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
有关版本列表,请参阅Amazon CLI 版本 2 变更日志
。GitHub -
验证签名,并将下载的
.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
。
-
-
解压缩安装程序。如果您的 Linux 发行版没有的内置
unzip
命令,请使用等效的命令对其解压缩。以下示例命令解压缩程序包并在当前目录下创建一个名为aws
的目录。$
unzip awscliv2.zip
注意
从以前的版本进行更新时,
unzip
命令会提示覆盖现有文件。要跳过这些提示,例如使用脚本自动化,请为unzip
使用-u
更新。此标志会自动更新现有文件并根据需要创建新文件。$
unzip -u awscliv2.zip
-
运行安装程序。安装命令在新解压缩的
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要查找现有的符号链接和安装目录,请执行以下步骤:
-
使用
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
-
-
通过以下命令确认此安装。
$
aws --version
aws-cli/2.17.20 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/2.4.5
如果无法找到
aws
命令,您可能需要重新启动终端或按照对错误进行故障排除 Amazon CLI中的说明排除故障。
-
- Command line - Linux ARM
-
要更新当前安装的 Amazon CLI,请在每次更新时下载一个新的安装程序以覆盖以前的版本。按照命令行中的以下步骤 Amazon CLI 在 Linux 上安装。
以下是提供基本安装的单个复制和粘贴组中的快速安装步骤。有关指导说明,请参阅随后的步骤。
注意
(可选)以下命令块 Amazon CLI 无需先验证下载内容的完整性即可下载和安装。要验证下载内容的完整性,请使用以下分步说明。
要安装 Amazon CLI,请运行以下命令。
$
curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install
要更新 Amazon 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指导安装步骤
-
通过以下方式之一下载安装文件:
-
使用
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 文件的完整性
如果您
.zip
在上述步骤中选择手动下载 Amazon CLI 安装程序包,则可以使用以下步骤使用该GnuPG
工具来验证签名。Amazon CLI 安装程序包
.zip
文件使用签PGP名进行加密签名。如果文件有任何损坏或更改,则此验证失败,您不应继续安装。-
使用您的程序包管理器下载并安装
gpg
命令。有关GnuPG
的更多信息,请参阅 GnuPG 网站。 -
要创建公有密钥文件,请创建一个文本文件并粘贴到以下文本中。
-----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 ZqFYbwUJCv/cOgAKCRCmMQrMRnJHXKYuEAC+wtZ611qQtOl0t5spM9SWZuszbcyA 0xBAJq2pncnp6wdCOkuAPu4/R3UCIoD2C49MkLj9Y0Yvue8CCF6OIJ8L+fKBv2DI yWZGmHL0p9wa/X8NCKQrKxK1gq5PuCzi3f3SqwfbZuZGeK/ubnmtttWXpUtuU/Iz VR0u/0sAy3j4uTGKh2cX7XnZbSqgJhUk9H324mIJiSwzvw1Ker6xtH/LwdBeJCck bVBdh3LZis4zuD4IZeBO1vRvjot3Oq4xadUv5RSPATg7T1kivrtLCnwvqc6L4LnF 0OkNysk94L3LQSHyQW2kQS1cVwr+yGUSiSp+VvMbAobAapmMJWP6e/dKyAUGIX6+ 2waLdbBs2U7MXznx/2ayCLPH7qCY9cenbdj5JhG9ibVvFWqqhSo22B/URQE/CMrG +3xXwtHEBoMyWEATr1tWwn2yyQGbkUGANneSDFiTFeoQvKNyyCFTFO1F2XKCcuDs 19nj34PE2TJilTG2QRlMr4D0NgwLLAMg2Los1CK6nXWnImYHKuaKS9LVaCoC8vu7 IRBik1NX6SjrQnftk0M9dY+s0ZbAN1gbdjZ8H3qlbl/4TxMdr87m8LP4FZIIo261 Eycv34pVkCePZiP+dgamEiQJ7IL4ZArio9mv6HbDGV6mLY45+l6/0EzCwkI5IyIf BfWC9s/USgxchg== =ptgS -----END PGP PUBLIC KEY BLOCK-----
以下是公有密钥的详细信息以供参考。
Key ID: A6310ACC4672475C Type: RSA Size: 4096/4096 Created: 2019-09-18 Expires: 2025-07-24 User ID: AWS CLI Team <aws-cli@amazon.com> Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
-
使用以下命令导入 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 -
下载您下载的软件包的 Amazon CLI 签名文件。它具有与其对应的
.zip
文件相同的路径和名称,但扩展名为.sig
。在以下示例中,我们将其作为名为awscliv2.sig
的文件保存到当前目录中。要获取最新版本的 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
有关版本列表,请参阅Amazon CLI 版本 2 变更日志
。GitHub -
验证签名,并将下载的
.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
。
-
-
解压缩安装程序。如果您的 Linux 发行版没有的内置
unzip
命令,请使用等效的命令对其解压缩。以下示例命令解压缩程序包并在当前目录下创建一个名为aws
的目录。$
unzip awscliv2.zip
注意
从以前的版本进行更新时,
unzip
命令会提示覆盖现有文件。要跳过这些提示,例如使用脚本自动化,请为unzip
使用-u
更新。此标志会自动更新现有文件并根据需要创建新文件。$
unzip -u awscliv2.zip
-
运行安装程序。安装命令在新解压缩的
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要查找现有的符号链接和安装目录,请执行以下步骤:
-
使用
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
-
-
通过以下命令确认此安装。
$
aws --version
aws-cli/2.17.20 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/2.4.5
如果无法找到
aws
命令,您可能需要重新启动终端或按照对错误进行故障排除 Amazon CLI中的说明排除故障。
-
- Snap package
-
我们提供了 Amazon CLI on 的官方 Amazon 支持版本
snap
。如果您希望始终在系统上 Amazon CLI 安装最新版本的,snap 软件包会自动更新,因此可以为您提供此功能。没有内置支持选择的次要版本,因此 Amazon CLI ,如果您的团队需要固定版本,则这不是最佳的安装方法。如果您要安装的特定次要版本 Amazon CLI,我们建议您使用命令行安装程序。-
如果您的 Linux 平台尚未
snap
安装,请在您的平台snap
上安装。 -
为运行以下
snap install
命令 Amazon CLI。$
snap install aws-cli --classic
根据您的权限,您可能需要在命令中
sudo
添加内容。$
sudo snap install aws-cli --classic
注意
要查看的快照存储库 Amazon CLI,包括其他
snap
说明,请参阅 Canonical Snap craft 网站上的aws-cli
页面。 -
确认 Amazon CLI 安装正确。
$
aws --version
aws-cli/2.17.20 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/2.4.5
如果出现错误,请参阅对错误进行故障排除 Amazon CLI。
-
安装和更新要求
-
我们支持 mac Amazon CLI OS 版本 10.15 及更高版本。如需了解更多信息,请参阅Amazon 开发者工具博客上的 macOS Amazon CLI v2 支持政策更新
。 -
由于 Amazon 不维护第三方存储库,因此我们无法保证它们包含最新版本的 Amazon CLI。
安装或更新 Amazon CLI
如果要更新到最新版本,请使用与当前版本相同的安装方法。您可以通过以下方式 Amazon CLI 在 macOS 上安装。
- GUI installer
-
以下步骤说明如何使用标准 macOS 用户界面和浏览器安装最新版本的。 Amazon CLI
-
在浏览器中,下载 macOS
pkg
文件:https://awscli.amazonaws.com/AWSCLIV2.pkg -
运行下载的文件,然后按照屏幕上的说明进行操作。您可以选择通过以下 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
。 -
-
要验证 Shell 是否可以在
$PATH
中找到并运行aws
命令,请使用以下命令。$
which aws
/usr/local/bin/aws
$
aws --version
aws-cli/2.17.20 Python/3.11.6 Darwin/23.3.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 /
引导式安装说明
-
使用
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 是否可以在
$PATH
中找到并运行aws
命令,请使用以下命令。$
which aws
/usr/local/bin/aws
$
aws --version
aws-cli/2.17.20 Python/3.11.6 Darwin/23.3.0 botocore/2.4.5
如果无法找到
aws
命令,您可能需要重新启动终端或按照对错误进行故障排除 Amazon CLI中的说明排除故障。
-
- Command line - Current user
-
-
要指定安装到哪个文件夹,必须使用任意XML文件名创建一个文件。 Amazon CLI 此文件是一个XML格式化文件,如下例所示。保留所有值如图所示,除非必须替换路径
/Users/myusername
在第 9 行中,显示要 Amazon CLI 安装的文件夹的路径。必须存在该文件夹,否则命令会失败。以下XML示例名为choices.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> -
使用
curl
命令下载pkg
安装程序。-o
选项指定下载的程序包应写入的文件名。在此示例中,文件写入当前文件夹中的AWSCLIV2.pkg
。$
curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
-
使用以下选项运行标准 macOS
installer
程序:-
使用
-pkg
参数指定要安装的程序包的名称。 -
通过将
-target
参数设置为CurrentUserHomeDirectory
,指定仅安装到当前用户。 -
在
-applyChoiceChangesXML
参数中指定您创建的文件的路径(相对于当前XML文件夹)和名称。
以下示例将安装 Amazon CLI 在文件夹中
/Users/myusername/aws-cli
。$
installer -pkg AWSCLIV2.pkg \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML
choices.xml
-
-
由于标准用户权限通常不允许写入
$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
。 -
要验证 Shell 是否可以在
$PATH
中找到并运行aws
命令,请使用以下命令。$
which aws
/usr/local/bin/aws
$
aws --version
aws-cli/2.17.20 Python/3.11.6 Darwin/23.3.0 botocore/2.4.5
如果无法找到
aws
命令,您可能需要重新启动终端或按照对错误进行故障排除 Amazon CLI中的说明排除故障。
-
安装和更新要求
-
我们支持微软支持 Amazon CLI 的 64 位 Windows 版本。
-
安装软件的管理员权限
安装或更新 Amazon CLI
要 Amazon CLI 在 Windows 上更新当前安装的,请在每次更新时下载一个新的安装程序以覆盖以前的版本。 Amazon CLI 会定期更新。要查看最新版本的发布时间,请查看Amazon CLI 版本 2 的变更日GitHub志
-
下载并运行适用于 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
-
要确认安装,请打开 Start(开始)菜单,搜索
cmd
以打开命令提示符窗口,然后在命令提示符处使用aws --version
命令。C:\>
aws --version
aws-cli/2.17.20 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
如果 Windows 无法找到该程序,您可能需要关闭并重新打开命令提示符窗口以刷新该路径,按照对错误进行故障排除 Amazon CLI中的说明排除故障。
Amazon CLI 安装和卸载错误疑难解答
如果您在安装或卸载后遇到问题 Amazon CLI,对错误进行故障排除 Amazon CLI请参阅,了解故障排除步骤。有关相关性最高的故障排除步骤,请参阅找不到命令错误、“aws --version”命令返回的版本与您安装的版本不同和卸载后,aws --version“” 命令会返回一个版本 Amazon CLI。
后续步骤
成功安装后 Amazon CLI,您可以安全地删除已下载的安装程序文件。完成中的步骤使用 Amazon CLI 版本 2 的先决条件并安装后 Amazon CLI,应执行设置 Amazon CLI。