安装 AWS Encryption SDK 命令行界面

本主题介绍如何安装 AWS 加密 CLI。有关详细信息，请参阅上的aws-encryption-sdk-cli存储库 GitHub 和 Read the Docs。

安装必备组件

加 AWS 密 CLI 建立在 AWS Encryption SDK for Python。要安装 AWS 加密 CLI，你需要 Python 和 pip Python 包管理工具。可以在所有支持的平台上使用 Python 和 pip。

在安装 AWS 加密 CLI 之前，请安装以下必备组件，

Python

AWS 加密 CLI 版本 4.2.0 及更高版本需要 Python 3.8 或更高版本。

早期版本的 AWS 加密 CLI 支持 Python 2.7 和 3.4 及更高版本，但我们建议您使用最新版本的 AWS 加密 CLI。

大多数 Linux 和 macOS 安装中都包含 Python，但您需要升级到 Python 3.6 或更高版本。建议您使用最新的 Python 版本。在 Windows 上，您必须安装 Python；默认未安装。要下载并安装 Python，请参阅 Python downloads。

要确定是否安装了 Python，请在命令行中键入以下内容：

python

要检查 Python 版本，请使用 -V（大写 V）参数。

python -V

在 Windows 上，在安装 Python 之后，将 Python.exe 文件的路径添加到路径环境变量的值中。

默认情况下，Python 安装在所有用户目录中，或者安装在 $home 子目录的用户配置文件目录（%userprofile% 或 AppData\Local\Programs\Python）中。要在您的系统上查找 Python.exe 文件的位置，请检查以下注册表项之一。您可以使用 PowerShell 搜索注册表。

PS C:\> dir HKLM:\Software\Python\PythonCore\version\InstallPath
# -or-
PS C:\> dir HKCU:\Software\Python\PythonCore\version\InstallPath

pip

pip 是 Python 程序包管理器。要安装 AWS 加密 CLI 及其依赖项，你需要 pip 8.1 或更高版本。有关安装或升级 pip 的帮助，请参阅 pip 文档中的 Installation。

在 Linux 安装中，8.1 pip 之前的版本无法构建 AWS 加密 CLI 所需的加密库。如果您选择不更新 pip 版本，可以单独安装构建工具。有关更多信息，请参阅在 Linux 上构建加密。

AWS Command Line Interface

只有在 AWS 加密 CLI AWS KMS keys 中使用 in AWS Command Line Interface (AWS CLI) 时， AWS Key Management Service (AWS KMS) 才是必需的。如果您使用的是不同的主密钥提供程序，则 AWS CLI 不是必需的。

要 AWS KMS keys 与 AWS 加密 CLI 配合使用，您需要安装和配置 AWS CLI。该配置使您用于进行身份验证的凭据 AWS KMS 可供 AWS 加密 CLI 使用。

安装和更新 AWS 加密 CLI

安装最新版本的 AWS 加密 CLI。当你使用pip安装 AWS 加密 CLI 时，它会自动安装 CLI 所需的库，包括 Python 加密库和。AWS Encryption SDK for PythonAWS SDK for Python (Boto3)

注意

4.0.0 之前的 AWS 加密 CLI 版本处于该阶段。end-of-support

您无需更改任何代码或数据即可安全地从 AWS Encryption CLI 版本 2.1.x 及更高版本更新为最新版本。但是，版本 2.1.x 中引入了新的安全功能，不向后兼容。从 1.7 版本更新。 x 或更早版本，必须先更新到最新的 1。 AWS 加密 CLI 的 x 版本。有关更多信息，请参阅 迁移 AWS Encryption SDK。

新的安全功能最初是在 AWS 加密 CLI 版本 1.7 中发布的。 x 和 2.0。 x。但是， AWS 加密 CLI 版本为 1.8。 x 取代了 1.7 版。 x 和 AWS 加密 CLI 2.1。 x 取代 2.0。 x。有关详细信息，请参阅aws-encryption-sdk-cli存储库中的相关安全公告 GitHub。

安装最新版本的 AWS 加密 CLI

pip install aws-encryption-sdk-cli

升级到最新版本的 AWS 加密 CLI

pip install --upgrade aws-encryption-sdk-cli

要查找您的 AWS 加密 CLI 的版本号和 AWS Encryption SDK

aws-encryption-cli --version

输出列出了两个库的版本号。

aws-encryption-sdk-cli/2.1.0 aws-encryption-sdk/2.0.0

升级到最新版本的 AWS 加密 CLI

pip install --upgrade aws-encryption-sdk-cli

安装 AWS 加密 CLI 时还会安装最新版本的（如果尚未安装的话）。 AWS SDK for Python (Boto3)如果安装了 Boto3，安装程序会验证 Boto3 版本并在需要时对其进行更新。

查找您安装的 Boto3 版本

pip show boto3

更新为最新版本的 Boto3

pip install --upgrade boto3

要安装当前正在开发的 Enc AWS ryption CLI 版本，请查看上的aws-encryption-sdk-cli存储库 GitHub。

有关使用 pip 安装和升级 Python 程序包的更多详细信息，请参阅 pip 文档。