View a markdown version of this page

安装   AWS Encryption SDK 命令行界面 - AWS Encryption SDK

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

安装   AWS Encryption SDK 命令行界面

本主题说明如何安装 AWS 加密 CLI。有关详细信息,请参阅上的 aws-encryption-sdk-cli 存储库和阅读文档。 GitHub https://aws-encryption-sdk-cli.readthedocs.io/en/latest/

安装必备组件

加 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 Command Line Interface 您在 AWS 加密 CLI AWS KMS keys 中使用 in AWS Key Management Service (AWS KMS) 时才需要 ()。AWS CLI如果您使用的是其他主密钥提供商,则 AWS CLI 不是必需的。

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

安装和更新 AWS 加密 CLI

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

注意

4.0.0 之前的 AWS 加密 CLI 版本处于支持终止阶段。

您无需更改任何代码或数据即可安全地从 AWS Encryption CLI 版本 2.1.x 及更高版本更新为最新版本。但是,版本 2.1.x 中引入了新的安全功能,不向后兼容。从 1.7 版更新。x 或更早版本,必须先更新到最新的 1。x 版本的 AWS 加密 CLI。有关更多信息,请参阅 迁移你的 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-c li 存储库中的相关安全公告。 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

要安装当前正在开发的 AWS 加密 CLI 版本,请参阅上的 aws-encryption-sdk- cli 存储库。 GitHub

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