本文档 Amazon CLI 仅适用于版本 1。有关版本 2 的文档 Amazon CLI,请参阅版本 2 用户指南。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
在 Linux 上安装、更新和卸载 Amazon CLI 版本 1
您可以使用pip
软件包管理器或捆绑的安装程序在大多数 Linux 发行版上安装 Amazon Command Line Interface (Amazon CLI) 版本 1 及其依赖项。
尽管该awscli
软件包可在存储库中供其他包管理器(例如apt
和)使用yum
,但这些软件包不受制作、管理或支持 Amazon。我们建议您仅 Amazon CLI 从官方 Amazon
分发点安装,如本指南中所述。
先决条件
您必须已安装 Python 3.8 或更高版本。有关安装说明,请参阅 Python 的初学者指南 中的下载 Python
Python 版本支持矩阵 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Amazon CLI 版本 | 支持的 Python 版本 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1.32.0 – 当前 | Python 3.8+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1.27.0 – 1.31.x | Python 3.7+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1.20.0 – 1.26.x | Python 3.6+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1.19.0 — 1.19.x | Python 2.7+、Python 3.6+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1.17 – 1.18.x | Python 2.7+、Python 3.4+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1.0 – 1.16.x | Python 2.6 及更早版本,Python 3.3 及更早版本 |
使用捆绑的安装程序在 Linux 上安装和卸载 Amazon CLI 版本 1
在 Linux 或 macOS 上,可以使用捆绑安装程序来安装 Amazon CLI的版本 1。捆绑安装程序包含所有依赖项,并可以离线使用。
注意
捆绑安装程序不支持安装到包含空格的路径。
使用捆绑的安装程序安装 Amazon CLI 版本 1 sudo
以下步骤使您能够在任何 Amazon CLI 版本的 Linux 或 macOS 上通过命令行安装版本 1。
以下是可剪切和粘贴以作为一组命令运行的安装命令的摘要,各个命令的具体解释见下文。
要获取最新版本的 Amazon CLI,请使用以下命令块:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
对于的特定版本 Amazon CLI,请在文件名后面附加连字符和版本号。在本示例中,版本 1.16.312
的文件名为 awscli-bundle-1.16.312.zip
,这会生成以下命令:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
按照命令行中的以下步骤使用捆绑的安装程序安装 Amazon CLI 版本 1。
使用捆绑的安装程序安装 Amazon CLI 版本 1
-
使用以下方法之一下载 Amazon CLI 版本 1 捆绑安装程序。
-
使用
curl
命令下载。要获取最新版本的 Amazon CLI,请使用以下命令块:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
对于的特定版本 Amazon CLI,请在文件名后面附加连字符和版本号。在本示例中,版本
1.16.312
的文件名为awscli-bundle-1.16.312.zip
,这会生成以下命令:$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" -
使用直接链接下载。
对于最新版本的 Amazon CLI:https://s3.amazonaws.com/aws-cli/awscli-bundle.zip
对于的特定版本 Amazon CLI,请在文件名后面附加连字符和版本号。在本示例中,版本
1.16.312
的文件名为awscli-bundle-
,这会生成以下 URL:https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip1.16.312
.zip
-
-
从程序包中提取文件。如果没有
unzip
来提取文件,请使用 Linux 发行版的内置程序包管理器进行安装。$
unzip awscli-bundle.zip
-
运行安装程序。安装程序安装 Amazon CLI at
/usr/local/aws
并在/usr/local/bin
目录中创建符aws
号链接。使用-b
选项创建符号链接将免除在用户的$PATH
变量中指定安装目录的需要。这应该允许所有用户 Amazon CLI 通过aws
从任何目录进入来呼叫。$
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
默认情况下,安装脚本在系统默认版本的 Python 下运行。如果您已经安装了 Python 的替代版本并想使用该版本来安装 Amazon CLI,请按照 Python 可执行文件的绝对路径使用该版本运行安装脚本,如下所示。
$
sudo
/usr/local/bin/python3.7
awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws -
验证 Amazon CLI 安装是否正确。
$
aws --version
aws-cli/1.32.65 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
如果出现错误,请参阅解决 Amazon CLI 错误。
使用捆绑的安装程序安装 Amazon CLI 版本 1,而不使用 sudo
如果您没有sudo
权限或 Amazon CLI 只想为当前用户安装,则可以使用先前命令的修改版本。前两个命令是相同的。
要获取最新版本的 Amazon CLI,请使用以下命令块:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws
对于的特定版本 Amazon CLI,请在文件名后面附加连字符和版本号。在本示例中,版本 1.16.312
的文件名为 awscli-bundle-1.16.312.zip
,这会生成以下命令:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws
为当前用户安装 Amazon CLI 版本 1
-
通过以下方式之一下载 Amazon CLI 版本 1 捆绑安装程序。
-
使用
curl
命令下载。要获取最新版本的 Amazon CLI,请使用以下命令块:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
对于的特定版本 Amazon CLI,请在文件名后面附加连字符和版本号。在本示例中,版本
1.16.312
的文件名为awscli-bundle-1.16.312.zip
,这会生成以下命令:$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" -
使用直接链接下载。
对于最新版本的 Amazon CLI:https://s3.amazonaws.com/aws-cli/awscli-bundle.zip
对于的特定版本 Amazon CLI,请在文件名后面附加连字符和版本号。在本示例中,版本
1.16.312
的文件名为awscli-bundle-
,这会生成以下 URL:https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip1.16.312
.zip
-
-
使用
unzip
从程序包中提取文件。如果没有unzip
,请使用 Linux 发行版的内置程序包管理器进行安装。$
unzip awscli-bundle.zip
-
运行安装程序。安装程序安装 Amazon CLI at
/usr/local/aws
并在/usr/local/bin
目录中创建符aws
号链接。此命令使用-b
参数以指定安装程序放置aws
符号链接文件的目录。您必须具有对指定文件夹的写入权限。$
./awscli-bundle/install -b ~/bin/aws
这会将安装 Amazon CLI 到默认位置 (
~/.local/lib/aws
),并在上创建一个符号链接(符号链接)。~/bin/aws
确保您的~/bin
环境变量中包含PATH
,以使该符号链接生效。$
echo $PATH | grep ~/bin
// See if $PATH contains ~/bin (output will be empty if it doesn't)$
export PATH=~/bin:$PATH
// Add ~/bin to $PATH if necessary -
确保该目录中包含 Amazon CLI 版本 1 的
PATH
变量。-
在您的用户文件夹中查找 Shell 的配置文件脚本。如果您不能确定所使用的 Shell,请运行
echo $SHELL
。$
ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
-
Bash –
.bash_profile
、.profile
或.bash_login
-
Zsh –
.zshrc
-
Tcsh –
.tcshrc
、.cshrc
或.login
-
-
在配置文件脚本末尾添加与以下示例类似的导出命令。
export PATH=
~/.local/bin
:$PATH此命令将路径(在本示例中为
~/.local/bin
)插入到现有PATH
变量的前面。 -
将配置文件重新加载到当前会话中,以使更改生效。
$
source ~/
.bash_profile
-
-
验证 Amazon CLI 安装是否正确。
$
aws --version
aws-cli/1.32.65 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
如果出现错误,请参阅解决 Amazon CLI 错误。
卸载 Amazon CLI 版本 1 的捆绑安装程序
-
如果您 Amazon CLI 使用捆绑的安装程序安装,请按照以下说明进行操作。除了可选的符号链接之外,捆绑安装程序不会将任何内容放在安装目录之外,所以卸载十分简单,就是直接删除这两个项目。
$
sudo rm -rf /usr/local/aws
$
sudo rm -rf /usr/local/bin/aws
-
(可选)移除
.aws
文件夹中的共享 Amazon SDK 和 Amazon CLI 设置信息。警告
这些配置和凭据设置在所有 Amazon 软件开发工具包和之间共享。 Amazon CLI如果删除此文件夹,则系统上仍存在的任何 Amazon SDK 都无法访问它们。
.aws
文件夹的默认位置因平台而异,默认情况下,该文件夹位于~/.aws/
。如果您的用户对此目录具有写入权限,则无需使用sudo
。$
sudo rm -r
~/.aws/
使用 pip 安装和卸载 Amazon CLI 版本 1
主题
安装 pip
如果尚未安装 pip
,可以使用 Python 打包权威机构 提供的脚本进行安装。运行 pip --version
可查看您的 Linux 版本是否已包含 Python 和 pip
。如果您安装了 Python 3 或更高版本,我们建议您使用 pip3
命令。
-
使用
curl
命令下载安装脚本。以下命令使用-O
(大写字母“O”)参数指定下载的文件将使用与远程主机上相同的名称存储在当前的目录中。$
curl -O https://bootstrap.pypa.io/get-pip.py
-
使用
python
或python3
命令运行脚本以下载并安装最新版本的pip
和其他必需的支持包。当您包含--user
开关时,脚本将pip
安装到路径~/.local/bin
。$
python3 get-pip.py --user
-
确保包含
pip
的目录是您的PATH
变量的一部分。-
在您的用户文件夹中查找 Shell 的配置文件脚本。如果您不能确定所使用的 Shell,请运行
echo $SHELL
。$
ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
-
Bash –
.bash_profile
、.profile
或.bash_login
-
Zsh –
.zshrc
-
Tcsh –
.tcshrc
、.cshrc
或.login
-
-
在配置文件脚本末尾添加与以下示例类似的导出命令。
export PATH=
~/.local/bin
:$PATH此命令将路径(在本示例中为
~/.local/bin
)插入到现有PATH
变量的前面。 -
将配置文件重新加载到当前会话中,以使更改生效。
$
source ~/
.bash_profile
-
-
要验证
pip
是pip3
否已正确安装,请运行以下命令。$
pip3 --version
pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)
使用 pip 安装并更新 Amazon CLI 版本 1
-
使用
pip
或pip3
命令安装或更新 Amazon CLI。如果您使用的是 Python 3 或更高版本,我们建议您使用pip3
命令。--user
交换机pip
将安装 Amazon CLI 到~/.local/bin
。要获取最新版本的 Amazon CLI,请使用以下命令块:
$
pip3 install awscli --upgrade --user
对于的特定版本 Amazon CLI,在文件名后面附加两个等号
=
和版本号。在本示例中,版本1.16.312
的文件名为==1.16.312
,这会生成以下命令:$
pip3 install awscli==
1.16.312
--upgrade --user注意
为您的终端使用适当的引用规则。要使用
=
字符,您可能需要使用单引号或双引号适当地进行转义。以下示例使用单引号进行转义:$
pip3 install 'awscli==
1.16.312
' --upgrade --user -
验证 Amazon CLI 安装是否正确。
$
aws --version
aws-cli/1.32.65 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
如果出现错误,请参阅解决 Amazon CLI 错误。
将 Amazon CLI 版本 1 可执行文件添加到命令行路径中
在使用 pip
进行安装后,可能需要将 aws
可执行文件添加到操作系统的 PATH
环境变量中。
您可以通过运行以下命令来验证pip
安装的是哪个文件夹。 Amazon CLI
$
which aws
/home/
username
/.local/bin/aws
您可以将此路径 ~/.local/bin/
作为参考,因为在 Linux 中 /home/username
对应于 ~
。
如果您忽略了 --user
开关且未在用户模式下安装,可执行文件可能位于 Python 安装的 bin
文件夹中。如果您不知道 Python 的安装位置,请运行此命令。
$
which python
/usr/local/bin/python
输出可能是符号链接的路径,而不是实际的可执行文件。运行 ls
-al
以查看所指向的路径。
$
ls -al /usr/local/bin/python
/usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6
pip
将程序安装到 Python 应用程序所在的文件夹中。将此文件夹添加到 PATH
变量。
修改您的 PATH
变量
-
在您的用户目录中查找 Shell 的配置文件脚本。如果您不能确定所使用的 Shell,请运行
echo $SHELL
。$
ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
-
Bash –
.bash_profile
、.profile
或.bash_login
-
Zsh –
.zshrc
-
Tcsh –
.tcshrc
、.cshrc
或.login
-
-
向配置文件脚本中添加导出命令。
export PATH=
~/.local/bin
:$PATH在本示例中,此命令将路径
~/.local/bin
添加到当前PATH
变量中。 -
将更新的配置文件加载到当前会话中。
$
source ~/
.bash_profile
Amazon CLI 使用 pip 卸载
-
如果您使用安装 Amazon CLI 版本 1
pip
,则还必须使用进行卸载pip
。$
pip uninstall awscli
如果您使用的是 Python 版本 2 或 3,则可能需要使用
pip2
或pip3
命令。使用aws --version
命令确定与您安装的版本 1 关联的 Python Amazon CLI 版本。$
pip3 uninstall awscli
您可能需要重新启动命令提示符窗口或电脑才能删除所有文件。
-
(可选)移除
.aws
文件夹中的共享 Amazon SDK 和 Amazon CLI 设置信息。警告
这些配置和凭据设置在所有 Amazon 软件开发工具包和之间共享。 Amazon CLI如果删除此文件夹,则系统上仍存在的任何 Amazon SDK 都无法访问它们。
.aws
文件夹的默认位置因平台而异,默认情况下,该文件夹位于~/.aws/
。如果您的用户对此目录具有写入权限,则无需使用sudo
。$
sudo rm -r
~/.aws/
Amazon CLI 安装和卸载错误疑难解答
如果您在安装或卸载后遇到问题 Amazon CLI,解决 Amazon CLI 错误请参阅,了解故障排除步骤。有关相关性最高的故障排除步骤,请参阅找不到命令错误、“aws --version”命令返回的版本与您安装的版本不同和卸载后,aws --version“” 命令会返回一个版本 Amazon CLI。