本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 安装 AWS Encryption SDK 命令行界面
本主题介绍如何安装 AWS 加密 CLI。有关详细信息，请参阅上的[aws-encryption-sdk-cli](https://github.com/aws/aws-encryption-sdk-cli/)存储库 GitHub 和 [Read the Docs](https://aws-encryption-sdk-cli.readthedocs.io/en/latest/)。
**Topics**
+ [安装必备组件](#crypto-cli-prerequisites)
+ [安装 CLI](#install-sdk-cli)
## 安装必备组件
加 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](https://www.python.org/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](https://pip.pypa.io/en/latest/installing/)。
**在 Linux 安装中，8.1 `pip` 之前的版本无法构建 AWS 加密 CLI 所需的加密库。**如果您选择不更新 `pip` 版本，可以单独安装构建工具。有关更多信息，请参阅[在 Linux 上构建加密](https://cryptography.io/en/latest/installation.html#building-cryptography-on-linux)。
**AWS Command Line Interface**
只有在 AWS 加密 CLI AWS KMS keys 中使用 in AWS Command Line Interface (AWS CLI) 时， AWS Key Management Service (AWS KMS) 才是必需的。如果您使用的是不同的[主密钥提供程序](concepts.md#master-key-provider)，则 AWS CLI 不是必需的。
要 AWS KMS keys 与 AWS 加密 CLI 配合使用，您需要[安装](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)和[配置](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration) AWS CLI。该配置使您用于进行身份验证的凭据 AWS KMS 可供 AWS 加密 CLI 使用。
## 安装和更新 AWS 加密 CLI
安装最新版本的 AWS 加密 CLI。当你使用`pip`安装 AWS 加密 CLI 时，它会自动安装 CLI 所需的库，包括 Python [加密库](https://cryptography.io/en/latest/)和。[AWS Encryption SDK for Python[适用于 Python (Boto3) 的 AWS SDK](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)](python.md)
**注意**
[4.0.0 之前的 AWS 加密 CLI 版本处于该阶段。end-of-support](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html#version-life-cycle)
您无需更改任何代码或数据即可安全地从 AWS Encryption CLI 版本 2.1.*x* 及更高版本更新为最新版本。但是，版本 2.1.*x* 中引入了[新的安全功能](about-versions.md#version-2)，不向后兼容。从 1.7 版本更新。 *x* 或更早版本，必须先更新到最新的 1。 AWS 加密 CLI 的 *x* 版本。有关更多信息，请参阅 [迁移你的 AWS Encryption SDK](migration.md)。
新的安全功能最初是在 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](https://github.com/aws/aws-encryption-sdk-cli/)存储库中的相关[安全公告](https://github.com/aws/aws-encryption-sdk-cli/security/advisories/GHSA-2xwp-m7mq-7q3r) 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 时还会安装最新版本的（如果尚未安装的话）。 适用于 Python (Boto3) 的 AWS SDK如果安装了 Boto3，安装程序会验证 Boto3 版本并在需要时对其进行更新。
**查找您安装的 Boto3 版本**
```
pip show boto3
```
**更新为最新版本的 Boto3**
```
pip install --upgrade boto3
```
要安装当前正在开发的 Enc AWS ryption CLI 版本，请查看上的[aws-encryption-sdk-cli](https://github.com/aws/aws-encryption-sdk-cli/)存储库 GitHub。
有关使用 `pip` 安装和升级 Python 程序包的更多详细信息，请参阅 [pip 文档](https://pip.pypa.io/en/stable/quickstart/)。